feishu-bridge飞书桥接

Connect a Feishu (Lark) bot to Clawdbot via WebSocket long-connection. No public server, domain, or ngrok required. Use when setting up Feishu/Lark as a messaging channel, troubleshooting the Feishu bridge, or managing the bridge service (start/stop/logs). Covers bot creation on Feishu Open Platform, credential setup, bridge startup, macOS launchd auto-restart, and group chat behavior tuning.

作者: admin | 来源: ClawHub

Feishu Bridge

Bridge Feishu bot messages to Clawdbot Gateway over local WebSocket.

Architecture

CODEBLOCK0

- Feishu SDK connects outbound (no inbound port / public IP needed)
Bridge authenticates to Gateway using the existing gateway token
Each Feishu chat maps to a Clawdbot session (feishu:<chatId>)

Setup

1. Create Feishu bot

1. Go to open.feishu.cn/app → Create self-built app → Add Bot capability
Enable permissions: im:message, im:message.group_at_msg, INLINECODE3
Events: add im.message.receive_v1, set delivery to WebSocket long-connection
Publish the app (create version → request approval)
Note the App ID and App Secret

2. Store secret

CODEBLOCK1

3. Install & run

CODEBLOCK2

4. Auto-start (macOS)

CODEBLOCK3

Diagnostics

CODEBLOCK4

Group chat behavior

Bridge replies only when: user @-mentions the bot, message ends with ?/？, contains request verbs (帮/请/分析/总结…), or calls the bot by name. Customize the name list in bridge.mjs → shouldRespondInGroup().

Environment variables

Variable	Required	Default
INLINECODE9	✅	—
INLINECODE10

— | ~/.clawdbot/secrets/feishu_app_secret | | CLAWDBOT_CONFIG_PATH | — | ~/.clawdbot/clawdbot.json | | CLAWDBOT_AGENT_ID | — | main | | FEISHU_THINKING_THRESHOLD_MS | — | 2500 |

Feishu Bridge

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

架构

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

- 飞书 SDK 采用出站连接（无需入站端口/公网 IP）
Bridge 使用现有 gateway token 向 Gateway 进行身份验证
每个飞书聊天对应一个 Clawdbot 会话（feishu:）

设置

1. 创建飞书机器人

1. 访问 open.feishu.cn/app → 创建自建应用 → 添加 机器人 能力
启用权限：im:message、im:message.groupatmsg、im:message.p2pmsg
事件：添加 im.message.receive_v1，设置推送方式为 WebSocket 长连接
发布应用（创建版本 → 申请审批）
记录 App ID 和 App Secret

2. 存储密钥

bash
mkdir -p ~/.clawdbot/secrets
echo 你的应用密钥 > ~/.clawdbot/secrets/feishuappsecret
chmod 600 ~/.clawdbot/secrets/feishuappsecret

3. 安装并运行

bash
cd <技能目录>/feishu-bridge
npm install
FEISHUAPPID=cli_xxx node bridge.mjs

4. 自动启动（macOS）

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

诊断

bash

检查服务

launchctl list | grep feishu

日志

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

停止

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

群聊行为

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

环境变量

变量	必需	默认值
FEISHUAPPID	✅	—
FEISHUAPPSECRETPATH

— | ~/.clawdbot/secrets/feishuapp_secret | | CLAWDBOTCONFIGPATH | — | ~/.clawdbot/clawdbot.json | | CLAWDBOTAGENTID | — | main | | FEISHUTHINKINGTHRESHOLD_MS | — | 2500 |

feishu-bridge飞书桥接

feishu-bridge

Feishu Bridge

Architecture