飞书 Clawdbot 桥接
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-feishu-bridge。
技能介绍
要解决什么问题
飞书群聊或私聊里想用 Clawdbot 的 Agent 能力,通常得自建 Webhook、暴露公网端口或维护反向代理。企业网络往往不允许入站,运维成本也高。Feishu Bridge 在本地用 WebSocket 连到 Clawdbot Gateway,飞书侧走 SDK 长连接出站,不要求公网 IP 或开放入站端口。
工作机制与核心能力
- 鉴权:复用现有 Clawdbot 配置里的 Gateway token,与
~/.clawdbot/clawdbot.json等路径约定一致。 - 会话映射:每个飞书会话对应一个 Clawdbot session,前缀为
feishu:,便于在多群、多私聊间隔离上下文。 - 群聊触发规则:默认仅在 @-提及机器人、句末带
?/?、含「帮/请/分析/总结」等请求动词,或呼叫配置中的机器人名称时回复;可在bridge.mjs的shouldRespondInGroup()里改名单。 - 配置面:
FEISHU_APP_ID必填;App Secret默认从~/.clawdbot/secrets/feishu_app_secret读取;FEISHU_THINKING_THRESHOLD_MS(默认 2500ms)等可调思考展示阈值。
飞书应用侧需在开放平台开通 Bot、im:message 及相关权限,事件 im.message.receive_v1 投递方式为 WebSocket 长连接。
边界与注意点
- 依赖已部署的 Clawdbot Gateway,Bridge 只做消息桥接,不替代 Gateway 上的 Agent 定义。
- 群聊高消息量时依赖上述过滤规则,避免机器人对每条闲聊都响应。
- 文档中的 Auto-start (macOS) 指向本地守护方式;Linux 等环境需自行用 systemd 等等价方式保活。
使用场景
- 内网 Clawdbot 已就绪,需在飞书群用 @ 机器人向同一 Gateway 上的 Agent 提问
- 无法为飞书配置公网 Webhook,只能用长连接出站接收 im.message.receive_v1
- 多个飞书群/私聊要分别维持会话,需 feishu: 前缀与 Gateway session 一一对应
- 群聊消息密集,需按 @、问号或「请帮分析」等规则控制机器人何时回复
适合人员
- 维护内网 Clawdbot Gateway、要把飞书 IM 接进现有 Agent 流水线的平台工程师
- 负责飞书自建应用与 Bot 权限、事件订阅(WebSocket)的企业协作或集成开发
- 在飞书运营/项目群里部署助手、又需要限制非 @ 闲聊触发回复的 Bot 维护者
- 已用 `~/.clawdbot/clawdbot.json` 与 gateway token 管理多 Agent、希望会话按聊天隔离的运维