---

name: dingtalk-connection description: Bridge DingTalk outgoing webhook messages to Clawdbot Gateway and send replies back to DingTalk sessions. Use when setting up DingTalk as a messaging channel, troubleshooting webhook delivery, or running the local bridge service.

DingTalk Bridge

Bridge DingTalk bot messages to Clawdbot Gateway over a local WebSocket connection.

Architecture

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

Setup

1. Create DingTalk bot

Create a bot that can send outgoing webhooks and set the callback URL to your public endpoint.

2. Run bridge

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

3. Auto-start (macOS)

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

Environment variables

| Variable | Required | Default | |---|---|---| | 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 |