安装飞书插件：
1.1 创建飞书应用
- 访问 飞书开放平台
- 创建企业自建应用
- 记录应用的 App ID 和 App Secret
1.2 配置事件订阅
进入应用的「事件订阅」页面，选择 Stream 模式（WebSocket 长连接）。
1.3 添加订阅事件
事件名称 用途 接收消息 表情回应（可选）
1.4 配置应用权限
在「权限管理」中添加以下权限：
权限名称 说明 获取与发送消息 以应用身份发消息 获取群组信息 读取群组信息 获取用户基础信息
1.5 发布应用版本
配置完成后，创建版本并发布应用。
2.1 配置文件位置
2.2 完整配置文件示例
以下是完整的 配置文件，重点关注 和 部分：
2.3 配置参数详解
基础配置
参数 类型 必填 说明 boolean 是 是否启用飞书通道。 启用， 禁用 string 是 飞书应用的 App ID，在飞书开放平台「凭证与基础信息」页面获取。格式： string 是 飞书应用的 App Secret，在飞书开放平台「凭证与基础信息」页面获取。格式：32 位字符串 string 否 飞书域名。
取值 ：（国内版，默认）、（国际版） string 否 连接模式。
取值 ：（默认，推荐）、（需公网服务器）
私聊配置
参数 类型 必填 说明 string 否 私聊策略。
取值 ：（开放，任何人可私聊）、（需配对确认）、（白名单模式）。
默认 ： array 否 允许私聊的用户列表。
取值 ：（允许所有人）、（指定用户的 open_id）。
注意 ： 时必须包含
群聊配置
参数 类型 必填 说明 string 否 群聊策略。
取值 ：（开放，任何群可用）、（白名单模式）、（禁用群聊）。
默认 ： array 否 允许的群聊列表。
取值 ：（允许所有群）、（指定群的 chat_id） boolean 否 群聊是否需要 @机器人 才会响应。
取值 ：（需要 @）、（所有消息都响应）。
默认 ：
体验优化配置
参数 类型 必填 说明 boolean 否 是否显示「正在输入...」状态。
取值 ：（显示）、（不显示）。
默认 ： boolean 否 是否解析发送者名称。
取值 ：（解析，消息中会显示发送者名字）、（不解析）。
默认 ：
Webhook 模式专用配置
参数 类型 必填 说明 string 是* Webhook 服务器域名，如 。*仅 webhook 模式需要 number 否 Webhook 服务器端口，如 、 string 否 Webhook 接收路径。
默认 ： string 是* 飞书事件订阅的验证令牌，在飞书开放平台获取。*仅 webhook 模式需要
如何获取必要信息
信息 获取方式 / 飞书开放平台 → 你的应用 → 凭证与基础信息 用户的 让用户给机器人发消息，查看日志中的 字段；或通过飞书 API 获取 群聊的 将机器人加入群聊，查看日志中的 字段；或在飞书群设置中查看 飞书开放平台 → 你的应用 → 事件订阅 → 验证令牌
3.1 启动 Gateway
3.2 验证连接成功
启动成功后会看到以下日志：
3.3 测试机器人
- 私聊测试：在飞书中直接给机器人发送消息
- 群聊测试：将机器人拉入群聊，@机器人 后发送消息
直接在飞书中给机器人发送消息即可开始对话。
在群聊中需要 @机器人 才会触发回复（除非配置了 ）。
以下示例均为完整的 配置文件，请直接替换或参考修改。
3.1 白名单模式
只允许特定用户和群聊使用机器人：
字段说明：
- - 使用白名单模式限制私聊，只有 列表中的用户可以私聊
- - 允许私聊的用户 open_id 列表。、 需替换为实际的用户 open_id
- - 使用白名单模式限制群聊，只有 列表中的群可以触发机器人
- - 允许的群聊 chat_id 列表。 需替换为实际的群 chat_id
3.2 多账号支持
一个 OpenClaw 实例管理多个飞书机器人：
字段说明：
- - 默认使用的机器人账号，当没有指定账号时使用此账号
- - 多个机器人账号配置对象
- / - 自定义的账号标识符，用于区分不同机器人
- - 账号显示名称，方便识别，可选
- - 该机器人账号的 App ID，格式：
- - 该机器人账号的 App Secret，32 位字符串
3.3 自定义群聊配置
为特定群聊设置不同的行为：
字段说明：
- - 按群聊 ID 进行个性化配置的对象
- / - 群聊的 chat_id，需要替换为实际的群 ID
- - 是否在该群启用机器人， 启用， 禁用
- - 该群是否需要 @机器人。设置为 可覆盖全局设置，让机器人在该群响应所有消息
- - 该群使用的系统提示词，可让机器人在不同群扮演不同角色
- 检查应用是否已发布版本
- 检查事件订阅是否配置正确
- 检查权限是否已添加
- 查看日志文件排查错误
- 检查网络是否能访问飞书服务器
- 确认 App ID 和 App Secret 是否正确
- 确认应用已启用 Stream 模式
- 确认机器人已加入该群
- 确认消息中 @了机器人
- 检查 配置
如果需要将飞书机器人切换到另一个 OpenClaw 实例：
方法一：修改配置文件
- 停止当前 OpenClaw Gateway
- 将 中的飞书配置复制到新的 OpenClaw 实例
- 启动新的 OpenClaw Gateway
方法二：使用环境变量
注意事项
- 同一时间只能有一个 OpenClaw 实例连接同一个飞书机器人
- WebSocket 模式下，新连接会自动断开旧连接
- 切换后需要等待几秒钟让飞书服务器更新连接状态
问题说明
飞书 WebSocket 模式是单连接的，同一时间只能有一个客户端保持连接。如果多个 OpenClaw 实例尝试连接同一个飞书机器人：
- 后连接的实例会成功建立连接
- 先连接的实例会被断开，出现连接丢失
解决方案
方案一：单实例部署（推荐）
只运行一个 OpenClaw Gateway 实例，通过配置文件管理多个机器人账号。参见上方「3.2 多账号支持」。
方案二：使用 Webhook 模式
如果需要多实例部署，可以改用 Webhook 模式。
完整配置文件示例：
GPT plus 代充 只需 145 Webhook 模式需要：
- 公网可访问的服务器
- 配置 HTTPS（飞书要求）
- 在飞书开放平台配置事件推送 URL：
方案三：负载均衡
使用消息队列（如 Redis、RabbitMQ）进行消息分发：
- 单一入口接收飞书消息
- 通过消息队列分发到多个处理节点
- 结果汇总后返回
架构建议
场景 推荐方案 单机器人、单租户 单实例 WebSocket 多机器人、单租户 单实例多账号配置 单机器人、高可用 主备切换 + WebSocket 高并发、多租户 Webhook + 负载均衡
- 飞书开放平台
- 飞书开发文档
- 飞书插件教程
- OpenClaw 官方文档
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/242978.html