dingtalk-connection

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

DingTalk Bridge

DingTalk 桥接服务

Bridge DingTalk bot messages to Clawdbot Gateway over a local WebSocket connection.
通过本地WebSocket连接将DingTalk机器人消息桥接到Clawdbot Gateway。

Architecture

架构

DingTalk user -> DingTalk cloud -> webhook (bridge.py) -> Clawdbot Gateway -> AI agent
DingTalk user -> DingTalk cloud -> webhook (bridge.py) -> Clawdbot Gateway -> AI agent

Setup

设置步骤

1. Create DingTalk bot

1. 创建DingTalk机器人

Create a bot that can send outgoing webhooks and set the callback URL to your public endpoint.
创建一个支持发送outgoing webhook的机器人,并将回调URL设置为你的公网端点。

2. Run bridge

2. 运行桥接服务

bash
cd <skill-dir>/dingtalk-connection
uv sync
DINGTALK_SIGNING_SECRET=your_secret uv run python bridge.py
bash
cd <skill-dir>/dingtalk-connection
uv sync
DINGTALK_SIGNING_SECRET=your_secret uv run python bridge.py

3. Auto-start (macOS)

3. 自动启动(macOS系统)

bash
uv run python setup_service.py
launchctl load ~/Library/LaunchAgents/com.clawdbot.dingtalk-bridge.plist
bash
uv run python setup_service.py
launchctl load ~/Library/LaunchAgents/com.clawdbot.dingtalk-bridge.plist

Environment variables

环境变量

VariableRequiredDefault
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
变量名是否必填默认值
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