DingTalk Bridge 用于将钉钉机器人消息桥接到 Clawdbot Gateway,通过本地 WebSocket 连接实现消息转发与回复回传。
用途 当需要把钉钉作为消息通道接入 Clawdbot Gateway 时使用该工具。它负责接收钉钉的 outgoing webhook 消息,转发给 Clawdbot Gateway 中的 AI 代理,并将代理生成的回复发送回对应的钉钉会话。
架构 消息流向为:钉钉用户 -> 钉钉云 -> webhook(bridge.py)-> Clawdbot Gateway -> AI 代理。
主要能力
- 桥接钉钉 outgoing webhook 消息到 Clawdbot Gateway。
- 通过本地 WebSocket 连接与 Clawdbot Gateway 通信。
- 将 AI 代理的回复发送回钉钉会话。
- 提供 bridge.py 作为桥接服务入口。
- 提供 setup_service.py 用于在 macOS 上配置自动启动。
使用方式
- 创建钉钉机器人:创建一个能够发送 outgoing webhook 的机器人,并将回调 URL 设置为你的公网端点。
- 运行桥接服务: cd <skill-dir>/dingtalk-connection uv sync DINGTALK_SIGNING_SECRET=your_secret uv run python bridge.py
- macOS 自动启动: uv run python setup_service.py launchctl load ~/Library/LaunchAgents/com.clawdbot.dingtalk-bridge.plist
环境变量
- DINGTALK_PORT:非必填,默认 3210。
- DINGTALK_PATH:非必填,默认 /dingtalk。
- DINGTALK_SIGNING_SECRET:非必填,默认无。
- DINGTALK_BOT_ID:非必填,默认无。
- DINGTALK_BOT_NAME:非必填,默认无。
- CLAWDBOT_CONFIG_PATH:非必填,默认 ~/.clawdbot/clawdbot.json。
- CLAWDBOT_AGENT_ID:非必填,默认 main。
- DINGTALK_THINKING_THRESHOLD_MS:非必填,默认 2500。
适用场景 适用于需要将钉钉作为消息通道接入 Clawdbot Gateway 并让 AI 代理在钉钉会话中自动回复的场景。
限制 资料未提供关于收费、价格、平台支持范围、性能效果等方面的信息,暂未提供。