Agent Skills
返回列表
🔒

飞书 Clawdbot 桥接

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 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 或开放入站端口。

工作机制与核心能力

  1. 鉴权:复用现有 Clawdbot 配置里的 Gateway token,与 ~/.clawdbot/clawdbot.json 等路径约定一致。
  2. 会话映射:每个飞书会话对应一个 Clawdbot session,前缀为 feishu:,便于在多群、多私聊间隔离上下文。
  3. 群聊触发规则:默认仅在 @-提及机器人、句末带 ?/?、含「帮/请/分析/总结」等请求动词,或呼叫配置中的机器人名称时回复;可在 bridge.mjs 的 shouldRespondInGroup() 里改名单。
  4. 配置面: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、希望会话按聊天隔离的运维