# Dingtalk

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

- Skill: `dvcrn/dingtalk` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add dvcrn/dingtalk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/dingtalk/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/dingtalk

---


# DingTalk Channel Plugin for OpenClaw

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

## Features

- Send/receive messages via DingTalk API
- Support for both internal apps and webhook robots
- DM and group chat policies
- User allowlist support

## Configuration

### Method 1: Environment Variables

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

### Method 2: Config File

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

Or manually edit config:

```yaml
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:

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

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

- [DingTalk Open Platform](https://open.dingtalk.com/document/isv/server-api-overview)
- [Robot Webhook API](https://open.dingtalk.com/document/isv/group-robot)

## Troubleshooting

**Error: "invalid timestamp"**
- Check your system time is synchronized

**Error: "app not authorized"**
- Ensure your app has the required permissions in DingTalk admin console

**Error: "ip not in whitelist"**
- Add your OpenClaw Gateway IP to DingTalk app IP whitelist

## Development

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

## License

MIT