Skillppx logo

Feishu Bridge

将飞书机器人消息通过WebSocket桥接至Clawdbot网关，实现本地化通信。

已扫描
适合谁
企业IT管理员、飞书机器人开发者
不适合谁
无技术背景的普通用户、无需对接AI系统的个人用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @alexanys/feishu-bridge
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Feishu Bridge

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

架构

飞书用户 → 飞书云 ←WS→ bridge.mjs (本地) ←WS→ Clawdbot 网关 → AI 代理
  • 飞书 SDK 仅需向外连接（无需反向端口或公网 IP）
  • 桥接服务使用现有的网关令牌进行身份验证
  • 每个飞书聊天会话对应一个 Clawdbot 会话（格式为 feishu:<chatId>）

设置步骤

1. 创建飞书机器人

  1. 访问 [open.feishu.cn/app](https://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() 函数来自定义关键词列表。

环境变量

变量是否必需默认值
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
A
@alexanys

已收录 1 个 Skill

相关推荐