SuperAPI AI 工具集

feishu-connection

智能体与模型

查看项目

更新于 10-16 06:47

技能介绍

用途:把飞书机器人消息经本地 WebSocket 桥接到 Clawdbot Gateway,再交给 AI 代理处理。链路为:飞书用户 → 飞书云端 ←WS→ 本地 bridge.py ←WS→ Clawdbot Gateway → AI 代理。飞书 SDK 主动外连,因此不需要入站端口或公网 IP;bridge 使用现有 gateway token 向 Gateway 认证,每个飞书会话映射为一个 Clawdbot 会话(feishu:<chatId>)。

主要能力:支持单聊与群聊消息转发;群聊中仅在被 @、消息以 ?/? 结尾、包含请求类动词(帮/请/分析/总结等)或按名称呼唤机器人时回复,名称列表可在 bridge.py 的 should_respond_in_group() 中自定义;提供 macOS 开机自启与日志诊断。

必要用法:在 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-connection;uv sync;FEISHU_APP_ID=cli_xxx uv run python bridge.py。macOS 自启:FEISHU_APP_ID=cli_xxx uv run python setup_service.py,然后 launchctl load ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist。

环境变量: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)。

诊断:launchctl list | grep feishu 查看服务;tail -f ~/.clawdbot/logs/feishu-bridge.err.log 查看日志;launchctl unload ~/Library/LaunchAgents/com.clawdbot.feishu-bridge.plist 停止服务。

限制:资料未提供价格、支持平台范围及非 macOS 系统的自启方案;群聊回复条件依赖关键词与名称列表,需要自行调整;运行依赖本地 Clawdbot Gateway 与有效 token。