openclaw对接飞书

文档

飞书侧配置

参考飞书开放平台官方文档：https://open.feishu.cn/document/develop-an-echo-bot/faq，添加一个飞书机器人
基本步骤
- 进入开发者后台：https://open.feishu.cn/app，选择：`创建企业自建应用`
  - 应用名称：OpenClaw编码助手
  - 应用描述：OpenClaw编码助手
- 选择：按能力添加-机器人-添加
- 权限管理-开通权限-应用身份权限，开通如下权限
  - im:message (发送和接收消息)
  - im:message:send_as_bot (以机器人身份发送消息)
  - im:message.p2p_msg:readonly (读取发给机器人的私聊消息)
  - im:message.group_at_msg:readonly (接收群内 @机器人的消息)
- 事件与回调-事件配置
  - 订阅方式：使用 长连接 接收事件
  - 已添加事件-添加事件-应用身份订阅：
    - im.message.receive_v1 (接收消息)，这个一定要配置，不然无法跟机器人发消息
发布应用
- 版本管理与发布-创建版本
  - 应用版本号：1.0.0
  - 移动端的默认能力：机器人，默认
  - 桌面端的默认能力：机器人，默认
  - 更新说明：OpenClaw编码助手发布
- 保存
- 确认发布
应用凭证
- 凭证与基础信息-应用凭证
  - 记下App ID、App Secret，后续与openclaw对接会用到
回到飞书，OpenClaw编码助手机器人已经创建好了，并且可以给机器人发消息
此时，openclaw对接飞书，飞书侧的配置已经配置好了

openclaw侧配置

进入到容器里
shell 复制代码
```
docker exec -it openclaw-gateway sh
```
执行配置命令，添加一个channel
shell 复制代码
```
openclaw channels add
```
会有如下交互：
- Configure chat channels now?
- Yes
- Select a channel
  - Feishu/Lark (飞书)
- How do you want to provide this App Secret?
  - Enter App Secret (Stores the credential directly in OpenClaw config)
- Enter Feishu App Secret
  - 填飞书机器人的App Secret
- Enter Feishu App ID
  - 填飞书机器人的App ID
- 会弹出 Feishu connection test，不用配置
  - Connected as ou_xxxxxx
- Feishu connection mode
  - WebSocket (default)，长连接，这样不需要配置复杂的公网回调地址
- Which Feishu domain?
  - Feishu (feishu.cn) - China
- Group chat policy
  - Allowlist - only respond in specific groups，这是"白名单"模式。意味着机器人默认不理会任何群，只有明确把群 ID 填进去，它才会在那个群里说话。防止把机器人拉进"公司大群"或"摸鱼群"时，它突然开始回复别人的闲聊，造成尴尬。
- Group chat allowlist (chat_ids)
  - oc_xxxxxx，允许的群聊，点击群名，在设置的后面可以看到会话 ID
- Select a channel
  - Finished
- Configure DM access policies now? (default: pairing)
  - No
- Add display names for these accounts? (optional)
  - No
- Bind configured channel accounts to agents now?
  - Yes
- Route feishu account "default" to agent
  - 选择我们自定义的agent，如果没有自定义，会显示默认的agent：main (default)
  配置结束。
退出容器

重启openclaw-gateway、openclaw-nginx

shell 复制代码

docker restart openclaw-gateway
docker restart openclaw-nginx

此时在飞书机器人对话框与机器人对话，输入：你好，会有如下回复
properties 复制代码
```
OpenClaw: access not configured.
Your Feishu user id: ou_xxxxxx
Pairing code: xxxxxx
Ask the bot owner to approve with:
openclaw pairing approve feishu xxxxxx
```
- 进入到容器中，执行openclaw pairing approve feishu xxxxxx
进入到容器里
shell 复制代码
```
docker exec -it openclaw-gateway sh
```
执行上面的命令命令
shell 复制代码
```
openclaw pairing approve feishu xxxxxx
```
此时可以与飞书机器人正常对话了，openclaw对接飞书完成。

注意事项

部分内容由AI生成
如有不对，欢迎指正！！！