Back to Setup Guides

Connect DingTalk with SetupClaw

This guide walks you through creating a DingTalk bot and connecting it to OpenClaw via SetupClaw APP. Once configured, your team can interact with your AI assistant directly inside DingTalk.

Prerequisites

  • SetupClaw APP installed on your computer (macOS or Windows)
  • DingTalk admin access for your organisation
  • OpenClaw set up with at least one AI model configured

Setup Steps

1

Create a DingTalk App

Go to the DingTalk Open Platform at open.dingtalk.com and sign in with your admin account.

  • Navigate to the Application Development section and create a new custom robot or enterprise internal app.
  • Once the app is created, locate the Client ID and Client Secret on the app credentials page.
  • Keep these credentials safe — you will need them in Step 4.
2

Configure Robot Capabilities

Enable the robot feature in your DingTalk app settings to allow the app to send and receive messages.

  • In the app settings, find the Robot section and enable it.
  • Set a name and avatar for your robot. This is what users will see inside DingTalk.
  • Save the robot configuration before proceeding.
3

Set Permissions and Stream Mode

Grant the necessary permissions and enable Stream mode for real-time message delivery.

  • Under the Permissions Management section, grant message sending and receiving permissions to your app.
  • Navigate to the message push settings and enable Stream mode. This allows DingTalk to deliver messages to your bot in real time.
  • Stream mode is the recommended approach — it does not require a public callback URL.
4

Enter Credentials in SetupClaw

Open SetupClaw APP and add DingTalk as a new channel.

  • In SetupClaw APP, go to Channels and click Add Channel.
  • Select DingTalk from the list of available channels.
  • Enter the Client ID and Client Secret you obtained in Step 1.
  • SetupClaw will install the DingTalk connector plugin automatically and enable the gateway HTTP endpoint.
5

Test Your Bot

Verify that everything is working by sending a test message in DingTalk.

  • Open DingTalk and find your bot in the contacts or group chat.
  • Send a message to the bot.
  • If the AI responds, your DingTalk integration is complete.

Troubleshooting

Bot not responding

Check that the OpenClaw gateway is running in SetupClaw APP. Go to the Dashboard and verify the gateway status shows a green indicator. If it is stopped, restart it.

Credential errors

Double-check that the Client ID and Client Secret match what is shown on the DingTalk Open Platform. Re-enter them in SetupClaw if needed.

Stream mode issues

Ensure Stream mode is enabled in the DingTalk app settings. If messages are not being delivered, try disabling and re-enabling Stream mode, then restart the gateway in SetupClaw.