Skip to main content
skill CX Codex

dingtalk-connection — Claude Code skill: DingTalk to Clawdbot bridge

This skill runs a local bridge between DingTalk bot webhooks and Clawdbot Gateway, so chat messages reach your AI agent and replies go back to DingTalk.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add XiaomingX/moltbot-connector-feishu-dingtalk --skill dingtalk-connection -a claude-code
Open on GitHub

What dingtalk-connection does

The skill covers wiring a DingTalk bot to Clawdbot Gateway over a local WebSocket connection. The path is short: a DingTalk user sends a message, DingTalk cloud fires a webhook at bridge.py, the bridge hands it to the gateway, and the agent's reply travels back into the DingTalk session.

You need a DingTalk bot that can send outgoing webhooks, with its callback URL pointing at your public endpoint. Then run uv sync inside the skill directory and start the bridge with DINGTALK_SIGNING_SECRET=your_secret uv run python bridge.py. On macOS there is an auto-start route: uv run python setup_service.py, followed by launchctl load ~/Library/LaunchAgents/com.clawdbot.dingtalk-bridge.plist.

Configuration comes from environment variables. The port defaults to 3210, the path to /dingtalk, the gateway config to ~/.clawdbot/clawdbot.json, and the agent to main. If the signing secret does not match the one set in DingTalk, webhooks fail verification — that is the first thing to check when delivery breaks.

What it helps with

  • bridge DingTalk webhooks into Clawdbot Gateway
  • send agent replies back into DingTalk sessions
  • set up DingTalk as a messaging channel
  • debug webhook delivery that never reaches the gateway
  • run the bridge as an auto-start service on macOS

Example prompts for the agent

  • Set up the DingTalk bridge using the dingtalk-connection skill
  • Start bridge.py with my DINGTALK_SIGNING_SECRET
  • Install the DingTalk bridge as a launch agent on macOS

How to install dingtalk-connection

1Skills CLI (Vercel)

npx skills add XiaomingX/moltbot-connector-feishu-dingtalk --skill dingtalk-connection -a claude-code

2Manually: put the files in place

~/.claude/skills/dingtalk-connection/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/dingtalk-connection/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about dingtalk-connection

How do I install dingtalk-connection in Claude?

Run npx skills add XiaomingX/moltbot-connector-feishu-dingtalk --skill dingtalk-connection -a claude-code. The skill lands at ~/.claude/skills/dingtalk-connection/SKILL.md.

What does dingtalk-connection do?

It bridges DingTalk bot webhooks to Clawdbot Gateway over a local WebSocket and sends the agent's replies back to DingTalk sessions.

What do I need before running the bridge?

A DingTalk bot with outgoing webhooks and a callback URL on your public endpoint, plus DINGTALK_SIGNING_SECRET. Start it with uv sync and uv run python bridge.py.

Source text

SKILL.md · Apache-2.0
---
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

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

### 3. Auto-start (macOS)

```bash
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` |

© XiaomingX · Apache-2.0 · XiaomingX/moltbot-connector-feishu-dingtalk

Similar skills

All skills for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor