OpenClaw 飞书接入教程
前置条件
- 已安装 OpenClaw（原 Clawdbot）参考https://github.com/openclaw/openclaw
- 有飞书企业账号
一、配置飞书后台
1.1 创建企业自建应用
- 进入 飞书开放平台 - 应用管理
- 点击「创建企业自建应用」
- 填写应用名称和描述（随意填写）
1.2 添加机器人能力
- 在左侧「添加应用能力」中添加「机器人」
- 添加后点击顶部的「创建版本」发布一下（版本可多次发布）
1.3 配置事件接收
- 进入「事件与回调」
- 点击「添加事件」，选择「消息与群组」→「接收消息」
- 设置「回调配置」，订阅方式选择「使用长连接」
- 注意：如果前面没有发布机器人版本，这里会报错
1.4 开通权限
进入「权限管理」，开通以下权限：
| 权限名称 |
|---|
| 获取与发送消息 |
| 接收消息 |
| 查看、评论和发消息 |
| 获取群组信息 |
| 获取群组所有成员信息 |
| 获取用户 ID |
| 获取用户手机号 |
| 获取用户邮箱 |
| 获取用户所在的群列表 |
| 获取群组所有成员详细资料 |
| 以应用的身份发消息 |
| 读取用户发给机器人的消息 |
| 读取用户在群组中 @机器人 的消息 |
| 获取群组中所有消息的 ID |
可以在权限搜索框直接搜索权限名称快速找到
1.5 发布应用
- 点击顶部的「创建版本」
- 输入版本号和更新说明
- 点击「保存」
1.6 获取凭证
在「凭证与基础信息」页面获取：
- App ID
- App Secret
二、安装飞书插件
打开终端，运行：
bashopenclaw plugins install @m1heng-clawd/feishu
三、配置飞书参数
3.1 命令行配置
bashopenclaw config set channels.feishu.appId "cli_xxxxx" openclaw config set channels.feishu.appSecret "your_app_secret" openclaw config set channels.feishu.enabled true
将
cli_xxxxx和your_app_secret替换为从飞书后台获取的实际值
3.2 Web UI 配置（可选）
- 打开 OpenClaw 的 Web 界面
- 进入设置 → Channels → 飞书
- 填入 App ID 和 App Secret
- 配置其他飞书相关参数
四、重启服务
bashopenclaw gateway restart
五、使用
- 在飞书（手机或电脑）中搜索你创建的机器人名字
- 发送「你好」测试
- 如果收到回复，恭喜！你的专属 AI 助理已上线
使用技巧
- 可以把机器人拉进群里
- 在群里 @ 它可以帮你写文档、出方案
常见问题
Q: 给机器人发消息没有回复？ A: 检查是否添加了「接收消息」事件，以及是否发布了应用版本。
Q: 回调配置报错？ A: 确保先点击「创建版本」发布机器人。
Q: 权限不足？ A: 检查权限列表，确保所有必需权限都已开通并重新发布版本。