飞书桥接

技能标识：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

Architecture

Setup

1. Create Feishu bot

2. Store secret

3. Install & run

4. Auto-start (macOS)

Diagnostics

Group chat behavior

Environment variables

Feishu Bridge

架构

设置

1. 创建飞书机器人

2. 存储密钥

3. 安装并运行

4. 自动启动（macOS）

诊断

检查服务

日志

停止

群聊行为

环境变量

标签

通过对话安装

方式一：安装 SkillHub 和技能

方式二：设置 SkillHub 为优先技能安装源

通过命令行安装

下载

飞书桥接

飞书桥接

Feishu Bridge

Architecture

Setup

1. Create Feishu bot

2. Store secret

3. Install & run

4. Auto-start (macOS)

Diagnostics

Group chat behavior

Environment variables

Feishu Bridge

架构

设置

1. 创建飞书机器人

2. 存储密钥

3. 安装并运行

4. 自动启动（macOS）

诊断

检查服务

日志

停止

群聊行为

环境变量

标签

通过对话安装

方式一：安装 SkillHub 和技能

方式二：设置 SkillHub 为优先技能安装源

通过命令行安装

下载

相关推荐

self-improvement

self-improvement

self-improvement

self-improvement