DingTalk Channel Plugin for OpenClaw

---

name: dingtalk

description: DingTalk channel plugin for OpenClaw - send and receive messages via DingTalk (钉钉)

metadata:

{

"openclaw":

{

"requires": { "openclaw": ">=2026.2.0" },

},

}

---

# DingTalk Channel Plugin for OpenClaw

Connect OpenClaw to DingTalk (钉钉) for enterprise messaging.

Features

Configuration

Method 1: Environment Variables

export DINGTALK_CLIENT_ID="your-app-key"
export DINGTALK_CLIENT_SECRET="your-app-secret"

Method 2: Config File

openclaw config --section channels
# Select DingTalk and follow prompts

Or manually edit config:

channels:
  dingtalk:
    enabled: true
    clientId: "ding6kntxc33nvloty5z"
    clientSecret: "your-secret"
    dmPolicy: "allowlist"  # or "open", "pairing"
    allowFrom:
      - "user001"
      - "user002"
    groupPolicy: "allowlist"  # or "open", "disabled"
    groupAllowFrom:
      - "chat001"

Method 3: Webhook Robot (Group Chat)

For group robot webhooks:

channels:
  dingtalk:
    enabled: true
    webhookUrl: "https://oapi.dingtalk.com/robot/send?access_token=xxxxx"
    webhookSecret: "SECxxxxx"  # optional, for signature verification

Getting Credentials

1. Go to [DingTalk Open Platform](https://open.dingtalk.com)

2. Create a micro-app or internal robot

3. Copy the **App Key** and **App Secret**

4. For internal apps, ensure these permissions:

- Contact management (读取通讯录)

- Message notifications (发送工作通知)

Usage

Sending Messages

await message({
  channel: "dingtalk",
  target: "user-id",
  text: "Hello from OpenClaw!"
});

Receiving Messages

Configure DingTalk callback URL to point to your OpenClaw Gateway:

https://your-gateway/webhook/dingtalk

API Reference

Troubleshooting

**Error: "invalid timestamp"**

**Error: "app not authorized"**

**Error: "ip not in whitelist"**

Development

This plugin is in beta. Report issues at: https://github.com/openclaw/openclaw

License

MIT