本文档详细说明如何配置 OpenClaw 与飞书机器人的集成。
- 前置准备
- 飞书开发者后台配置
- OpenClaw 配置
- 发布应用与重启网关
- 私聊配对与授权
- 插件诊断与工具配置
- 完成授权
- 常见问题
- 已安装 OpenClaw（版本 2026.3.11 或更高）
- 拥有飞书开发者后台的管理员权限
- 飞书应用已创建或准备创建
1. 创建飞书应用
- 登录 飞书开发者后台
- 点击「创建企业自建应用」
- 填写应用名称和描述，选择应用类型
2. 配置应用凭证
在「凭证与基础信息」页面获取：
- App ID：如
- App Secret：如
3. 配置事件订阅（长连接模式）
进入「事件与回调」→「订阅方式」：
- 选择 「使用长连接接收事件」（WebSocket 模式，无需公网 IP）
- 在「事件订阅」中添加以下事件：
- – 接收消息
4. openclaw 配置 配置应用权限
在「权限管理」→「应用能力」中添加所需权限，常用权限包括：
消息相关：
- – 获取与发送消息
- – 以应用身份发消息
- – 获取群组信息
- – 读取群组信息
用户相关：
- – 获取用户基本信息
- – 获取用户详细信息
文档相关：
- – 文档操作权限
- – 云空间权限
- – 多维表格权限
日历相关：
- – 日历权限
- – 日程权限
5. 配置应用发布
在「应用发布」→「版本管理与发布」：
- 创建新版本
- 填写版本号和更新说明
- 提交审核（如需）并发布
1. 编辑配置文件
编辑 ，添加飞书渠道配置：
2. 配置项说明
3. 安装飞书插件
1. 发布飞书应用版本
在飞书开发者后台：
- 进入「应用发布」→「版本管理与发布」
- 点击「创建版本」
- 填写版本号（如 1.0.0）和更新说明
- 点击「发布」按钮
⚠️ 重要：每次修改应用配置后都需要发布新版本才能生效！
2. 重启 OpenClaw 网关
在终端执行：
或重启整个服务：
3. 验证连接状态
确认输出中 部分显示：
1. 私聊机器人
在飞书中找到你的机器人，发送私聊消息（任意内容）。
2. 获取配对码
机器人会返回：
- 配对码：如
- 授权提示：需要进行用户授权
示例返回：
3. 在终端配对
替换 为实际收到的配对码。
1. 运行插件诊断
在 OpenClaw 对话中输入：
诊断命令会检查：
- 飞书插件是否正确加载
- 权限配置是否完整
- 连接状态是否正常
2. 修改工具配置
如果诊断提示工具权限不足，修改配置：
或在配置文件中：
3. 重启生效
1. 发起授权
在 OpenClaw 对话中输入：
2. 确认授权
系统会返回授权链接或卡片，点击链接完成飞书用户授权。
3. 验证授权状态
授权成功后，可以测试机器人功能：
确认所有检查项通过。
Q: 机器人不响应消息？
检查以下项目：
- 事件订阅是否正确
- 确认已添加 事件
- 确认使用长连接模式
- 应用版本是否发布
- 每次配置修改后都需要发布新版本
- 群聊策略是否开放
应为 或配置了
- 网关是否重启
Q: 私聊提示需要配对？
私聊策略默认为 ，需要先配对：
- 私聊机器人获取配对码
- 在终端执行
如需开放所有私聊：
Q: 工具调用失败？
检查工具配置：
应为 或自定义的允许列表。
Q: 如何查看日志？
Q: 如何更新飞书插件？
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。
发布者：Ai探索者，转载请注明出处：https://javaforall.net/278257.html原文链接：https://javaforall.net
