用途：把飞书（Lark）机器人消息桥接到 Clawdbot Gateway，让 AI 智能体可通过飞书对话接收与回复。架构为：飞书用户 → 飞书云 ←WS→ 本地 bridge.mjs ←WS→ Clawdbot Gateway → AI 智能体。飞书 SDK 为主动外连，无需入站端口或公网 IP；桥接使用已有 gateway token 认证到 Gateway；每个飞书会话映射为一个 Clawdbot 会话（feishu:<chatId>）。
搭建步骤：在 open.feishu.cn/app 创建自建应用并添加机器人能力；开启 im:message、im:message.group_at_msg、im:message.p2p_msg 权限；添加事件 im.message.receive_v1 并将投递方式设为 WebSocket 长连接；发布应用（创建版本并申请审批）；记录 App ID 与 App Secret。随后存放密钥：mkdir -p ~/.clawdbot/secrets，echo "YOUR_APP_SECRET" > ~/.clawdbot/secrets/feishu_app_secret，chmod 600 ~/.clawdbot/secrets/feishu_app_secret。安装运行：cd <skill-dir>/feishu-bridge、npm install、FEISHU_APP_ID=cli_xxx node bridge.mjs。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() 自定义名称列表。
环境变量：FEISHU_APP_ID（必填）、FEISHU_APP_SECRET_PATH（默认 ~/.clawdbot/secrets/feishu_app_secret）、CLAWDBOT_CONFIG_PATH（默认 ~/.clawdbot/clawdbot.json）、CLAWDBOT_AGENT_ID（默认 main）、FEISHU_THINKING_THRESHOLD_MS（默认 2500）。
限制：需已具备飞书自建应用与 Clawdbot Gateway 环境；其余平台支持、收费与更多配置暂未提供。