中文文档

OpenClaw DingTalk channel plugin, using Stream mode to connect enterprise robots.

• ✅ Stream Mode: No public IP or domain required, works out of the box
• ✅ Private/Group Chat: Supports private chat and group chat (only when @robot)
• ✅ Text Messages: Send and receive text messages
• ✅ Markdown Reply: Robot replies in Markdown format
• ✅ Image Messages: Receive images from users, send local/remote images
• ✅ Voice, Video, File, Rich Text: Receive voice, video, file, and rich text messages from users
• ✅ File Reply: Support replying with files; audio, video, etc. are sent as files uniformly (sending as voice/video requires duration and video cover, to be supported later)
• ✅ Active Message Push: Supports active message pushing, configurable for reminders or scheduled tasks
• ✅ OpenClaw Commands: Supports official OpenClaw commands such as /new, /compact

openclaw plugins install @largezhou/ddingtalk

---

There are two ways to add the DingTalk channel:

If you have just installed OpenClaw, you can run the wizard directly and follow the prompts to add DingTalk:

openclaw onboard

The wizard will guide you through:

1. Creating a DingTalk app robot and obtaining credentials
2. Configuring app credentials
3. Starting the gateway

After completing the configuration, you can use the following commands to check the gateway status:

• openclaw gateway status - View gateway running status
• openclaw logs --follow - View real-time logs

If you have already completed the initial installation, you can use the following command to add the DingTalk channel:

openclaw channels add

Then, follow the interactive prompts to select DingTalk, and enter the AppKey (Client ID) and AppSecret (Client Secret).

After completing the configuration, you can use the following commands to manage the gateway:

• openclaw gateway status - View gateway running status
• openclaw gateway restart - Restart the gateway to apply new configurations
• openclaw logs --follow - View real-time logs

---

Visit the DingTalk Developer Platform, log in with your DingTalk account, and select an organization to enter.

1. Click Create App in the upper right corner
2. Fill in the app name and description, upload an image (optional)

On the app's Credentials & Basic Information page, copy:

• Client ID (format like dingxxxx)
• Client Secret

❗ Important: Please keep the Client Secret safe and do not share it with others.

1. On the app's Add App Capabilities page, select Robot, and click Add

2. Enter the relevant robot information, select Stream Mode for Message Receiving Mode, and then save

In the app's permission management, make sure the following permissions are enabled:

• Permission for enterprise internal robots to send messages
• Permission to obtain download links for robot received messages via downloadCode (for receiving images)

Create a robot version, fill in the version number, description, and application availability scope, click save, then click confirm to publish.

---

Run the following command, select DingTalk according to the prompts, and paste the AppKey (Client ID) and AppSecret (Client Secret):

openclaw channels add

Edit ~/.openclaw/openclaw.json:

{
  "channels": {
    "ddingtalk": {
      "enabled": true,
      "clientId": "your_app_key",
      "clientSecret": "your_app_secret",
      "allowFrom": ["*"]
    }
  }
}

allowFrom controls which users can interact with the robot and execute commands:

• Default: ["*"] (allows everyone if not configured)
• Specified users: Fill in DingTalk user staffId, only whitelisted users can use commands (such as /compact, /new, etc.), messages from non-whitelisted users will be ignored
• allowFrom[0] also serves as the default target for active message push (openclaw send)

{
  "allowFrom": ["user_id_1", "user_id_2"]
}

---

openclaw gateway --verbose

Find the robot you created in DingTalk, and you can start a normal conversation.

---

The project includes a standalone demo that can test the DingTalk robot independently without the OpenClaw framework:

# Configure environment variables
cp .env.example .env
# Edit .env and fill in CLIENT_ID and CLIENT_SECRET

# Run demo
pnpm run demo

# Install dependencies
pnpm install

# Pack
pnpm pack

• DingTalk Open Platform - Stream Mode
• DingTalk Open Platform - Robot Receive Messages
• DingTalk Open Platform - Robot Send Messages

MIT