前置条件
- 已安装并运行 SetupClaw 应用
- 拥有管理员权限的飞书工作区
- OpenClaw 已配置至少一个 AI 模型
1
第 1 步：创建飞书应用
前往飞书开放平台（open.feishu.cn），创建一个自建应用。
- a访问 open.feishu.cn，使用飞书账号登录
- b点击「创建自建应用」
- c填写应用名称（例如「AI 助手」）和应用描述
- d记录 App ID 和 App Secret，稍后需要在 SetupClaw 中使用
2
第 2 步：开启机器人能力
为飞书应用启用机器人功能。
- a在应用设置中，进入「添加应用能力」→「机器人」
- b启用机器人能力
- c设置用户在飞书中看到的机器人名称和描述
3
第 3 步：配置权限
为机器人授予发送和接收消息所需的权限。
- a进入「权限管理」
- b添加以下权限：im:message（发送消息）、im:message.receive_v1（接收消息）、im:chat（获取会话信息）
- c如果组织要求审批，请提交权限申请
4
第 4 步：配置事件订阅
设置 Webhook 地址，让飞书将消息事件发送到 OpenClaw。
- a进入「事件订阅」
- b开启事件订阅
- c请求地址将在 SetupClaw 配置过程中提供，届时填入此处
- d订阅「接收消息」事件（im.message.receive_v1）
5
第 5 步：在 SetupClaw 中填写凭据
打开 SetupClaw 应用，进入渠道设置页面。
- a打开 SetupClaw 应用
- b进入 渠道 → 添加渠道 → 选择飞书
- c输入第 1 步中获取的 App ID 和 App Secret
- d点击「连接」— SetupClaw 将自动安装飞书插件
- e网关将使用新的渠道配置重新加载
6
第 6 步：发布应用
让飞书机器人在工作区中对用户可用。
- a回到飞书开放平台，进入「版本管理与发布」
- b创建新版本并提交审核
- c审核通过后，机器人将出现在飞书工作区中
- d用户可以直接搜索并向机器人发送消息
7
第 7 步：配对账号
在飞书中给机器人发送一条消息，以启动配对流程。
- a打开飞书，找到新创建的机器人
- b向机器人发送任意消息
- c机器人会回复一个配对码
- d在 SetupClaw 应用中输入此配对码完成授权
- e飞书机器人已连接，可以开始使用了！
进阶：多机器人配置
SetupClaw 支持多个飞书机器人，每个机器人拥有独立的 AI 智能体和工作区。如需添加新机器人，请进入 渠道 → 飞书 → 添加机器人，然后使用一个新的飞书应用重复第 1-7 步。每个机器人独立运行，拥有各自的对话历史。