Integrate OpenClaw with DingTalk

1. Select or create an organization.

   Select an organization

   Go to the DingTalk Open Platform. When you log in, the following prompt appears. Select an organization for which you have developer permissions, or select an organization and then obtain developer permissions.

   Create an organization

   If no organizations are available, use the DingTalk mobile app to scan the QR code below. You will be redirected to the page for creating a new organization.

   

   Your DingTalk mobile app version must be 6.5.45 or later.

2. Go to the DingTalk Open Platform. On the developer console, find the one-click option to automatically create an OpenClaw bot and click Create Now.

3. The platform pre-fills the OpenClaw bot information. Modify the details if needed, then click OK to create the bot.

   If you need to create multiple applications, we recommend changing the bot name or icon during creation to distinguish them later.

4. After the application is created, copy and save its Client ID and Client Secret.

   If you close the window, you can still find the Client ID and Client Secret. Navigate to the application and click Credentials and Basic Information in the left-side navigation pane.

2. Configure the DingTalk application

Select the tab for your image version to view the steps.

3. Test the bot

You can create a new group chat or add the bot to an existing one. To test the bot, mention it by typing @robot_name in a group chat or search for it to start a private chat.

To change the Model Studio model, see How to change the model called by OpenClaw.

4. (Optional) Configure a scheduled task

After configuring the bot, you can create a scheduled task by talking to OpenClaw. The following example shows how to create a task that queries the real-time weather.

1. Obtain the bot's webhook address. In a group chat where the bot has been added, from the top-right corner, navigate to Group Settings > Group Management > Bot. In the bot management section, click the bot's avatar, then copy its webhook address.

   The webhook address format is https://oapi.dingtalk.com/robot/send?access_token=xxx. Click the Copy button to get the full address.

2. In the OpenClaw chat, create the task using the format: [task description] + [group bot's webhook address].

   For example, enter: Check the weather in Beijing at 9 AM every day, webhook address is https://oapi.dingtalk.com/robot/send?access_token=xxx

3. To test the scheduled task, ask the agent to send a message immediately. Check the group chat to confirm the task was executed. To modify or cancel the task, ask the agent directly in the chat.

To configure a scheduled task using AppFlow, see How to use AppFlow to configure a scheduled task.

Prerequisites

• You have deployed the OpenClaw application image, and the image version is OpenClaw 2026.3.13 or later.

• You have created multiple bots on the DingTalk Open Platform and have obtained the Client ID and Client Secret for each. For instructions, see 1. Create a DingTalk application.

Procedure

1. Modify the configuration file. Replace placeholder values like your_bot1_client_id and your_bot1_client_secret with the actual Client ID and Client Secret from the DingTalk Open Platform.

   Important

   You must replace the value of agents.list.model.primary with the name of a model that is already configured in OpenClaw. This example uses dashscope-coding/qwen3.5-plus from the Model Studio Coding Plan.

   {
     "agents": {
       "list": [
         {
           "id": "ding-bot1",
           "name": "DingTalk Customer Service Bot",
           "model": {
             "primary": "dashscope-coding/qwen3.5-plus"
           },
           "workspace": "/home/admin/.openclaw/workspace-bot1",
           "identity": {
             "name": "Service Assistant",
             "theme": "Customer Service"
           }
         },
         {
           "id": "ding-bot2",
           "name": "DingTalk Tech Support Bot",
           "model": {
             "primary": "dashscope-coding/qwen3.5-plus"
           },
           "workspace": "/home/admin/.openclaw/workspace-bot2",
           "identity": {
             "name": "Tech Expert",
             "theme": "Tech Support"
           }
         }
       ]
     },
     "channels": {
       "dingtalk-connector": {
         "enabled": true,
         "accounts": {
           "bot1": {
             "enabled": true,
             "clientId": "YOUR_BOT1_CLIENT_ID",
             "clientSecret": "YOUR_BOT1_CLIENT_SECRET"
           },
           "bot2": {
             "enabled": true,
             "clientId": "YOUR_BOT2_CLIENT_ID",
             "clientSecret": "YOUR_BOT2_CLIENT_SECRET"
           }
         },
         "separateSessionByConversation": true,
         "groupSessionScope": "group",
         "sharedMemoryAcrossConversations": false
       }
     },
     "bindings": [
       {
         "agentId": "ding-bot1",
         "match": {
           "channel": "dingtalk-connector",
           "accountId": "bot1"
         }
       },
       {
         "agentId": "ding-bot2",
         "match": {
           "channel": "dingtalk-connector",
           "accountId": "bot2"
         }
       }
     ]
   }

2. Go to the instance Web UI panel and send the following command to OpenClaw: Modify the OpenClaw configuration file, add the following content, and restart the gateway after modification. Immediately after this command, paste the configuration content from the previous step.

3. Verify the configuration. In DingTalk, send test messages to both bots to confirm that each responds correctly.