OpenClaw 安装飞书插件

1.为 OpenClaw 安装飞书插件

在终端中执行以下命令来安装飞书插件。安装完成后，通常需要重启 OpenClaw 网关以使插件生效

# 安装飞书插件openclaw plugins install @m1heng-clawd/feishu# 重启网关，加载新插件openclaw gateway restart

2. 配置飞书应用

为了让 OpenClaw 能通过飞书机器人与你通信，你需要在飞书开放平台创建一个应用并获取关键凭证。

1. 1. 创建应用与获取凭证
1. 访问飞书开放平台，登录后点击”创建企业自建应用”。
2. 填写应用名称和描述，然后进入应用管理页面。
3. 在应用管理的”凭证与基础信息”页面，你可以找到应用唯一的 App ID 和 App Secret，复制并保存好它们，后续配置会用到
2. 2. 配置飞书通道参数

使用上一步获取的凭证，通过以下命令在 OpenClaw 中配置飞书通道：

openclaw config set channels.feishu.appId "你的App ID"openclaw config set channels.feishu.appSecret "你的App Secret"openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocket  # 或长连接模式[1,6](@ref)

配置完成后，再次重启网关：openclaw gateway restart

1. 3. 或者通过QuickStart （快速开始）模式

openclaw onboard

Select channel (QuickStart)

选对 Feishu/Lark (飞书)

输入 Enter Feishu App ID

和 Enter Feishu App Secret

Which Feishu domain?

│ ● Feishu (feishu.cn) – China

Group chat policy

│ ● Allowlist – only respond in specific groups

│ ○ Open – respond in all groups (requires mention)

│ ○ Disabled – don’t respond in groups

其他跳过，最后选择：

Gateway service already installed

│ ● Restart

│ ○ Reinstall

│ ○ Skip

重启 gateway。

配置飞书应用权限与事件

为了让机器人能接收和发送消息，需要在飞书开放平台完成以下关键配置。

测试与验证

完成所有配置后，在飞书中找到你的应用机器人并发送一条消息。如果一切正常，很快就会收到 OpenClaw 的回复。

💡 常见问题与技巧

• 收不到消息：首先检查飞书应用的”事件订阅”是否已正确配置且选择的是”长连接”模式，并确保已添加im.message.receive_v1事件。其次，确认 OpenClaw 网关在运行且飞书通道已启用。
• 安全建议：妥善保管你的 App Secret 和 AI 模型的 API Key，不要泄露。
• 插件安装问题：如果网络环境导致插件安装失败，可以尝试使用网络加速工具，或从 GitHub 手动下载插件包并放置到 OpenClaw 的扩展目录（通常为 ~/.openclaw/extensions/）。