飞书桥接器

通过本地 WebSocket 将飞书机器人消息桥接到 Clawdbot 网关。

架构

飞书用户 → 飞书云 ←WS→ bridge.mjs (本地) ←WS→ Clawdbot 网关 → AI 智能体

• 飞书 SDK 建立出站连接（无需入站端口 / 公网 IP）
• 桥接器使用现有网关令牌向网关进行身份验证
• 每个飞书聊天对应一个 Clawdbot 会话 (feishu:<chatId>)

设置

1. 创建飞书机器人

1. 前往open.feishu.cn/app→ 创建自建应用 → 添加机器人能力
2. 启用权限：im:message、im:message.group_at_msg、im:message.p2p_msg
3. 事件：添加im.message.receive_v1，将事件投递方式设置为WebSocket 长连接
4. 发布应用（创建版本 → 申请发布）
5. 记下应用 ID和应用密钥

2. 存储密钥

mkdir -p ~/.clawdbot/secrets
echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret
chmod 600 ~/.clawdbot/secrets/feishu_app_secret

3. 安装并运行

cd <skill-dir>/feishu-bridge
npm install
FEISHU_APP_ID=cli_xxx node bridge.mjs

4. 自动启动 (macOS)

FEISHU_APP_ID=cli_xxx node setup-service.mjs
launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

诊断

# 检查服务
launchctl list | grep feishu

# 日志
tail -f ~/.clawdbot/logs/feishu-bridge.err.log

# 停止
launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist

群聊行为

桥接器仅在以下情况回复：用户@提及机器人、消息以?/？结尾、包含请求动词（帮/请/分析/总结…），或通过名称呼叫机器人。可在bridge.mjs→shouldRespondInGroup()中自定义名称列表。

环境变量