DingTalk integration
This document describes how to integrate OpenClaw with a DingTalk application and robot. This integration allows users to complete tasks in OpenClaw by interacting with the robot.
Overview
The integration consists of the following steps:
Create a DingTalk application and configure security credentials to connect to the OpenClaw cloud computer.
Create a DingTalk robot.
Create a card template.
Publish the DingTalk application.
Use the DingTalk robot.
Create a DingTalk application
Go to the DingTalk Open Platform.
NoteYou must select an organization where you have developer permissions, or select an organization and then get developer permissions.
If you do not have a suitable organization, you can scan the following QR code with the DingTalk mobile app to quickly create one.

In the top navigation bar, click Application development. On the DingTalk applications page, click Create application.
In the left navigation pane, select credentials and basic information. View and record the Client ID and Client Secret.
Create a DingTalk robot
After you create the application, select Add application capabilities in the left navigation pane. On the Robot card, click Add.
On the robot configuration page, turn on Robot configuration.
For message receiving mode, select Stream mode, and then click Publish to complete the robot configuration.
In the left navigation pane, select version management and release, and then click Create new version.
After you complete the configuration, click Save to publish the version.
Create a card template
DingTalk robots use message cards to stream results. You must first create a card template.
Go to the Card Platform and click Create template.
In the create template dialog box, create a template with the following settings:
Card type: Select Message card.
Card template scenario: Select AI card.
Associated application: Enter the name of the application you created.
On the card editing page, click Save in the upper-right corner, and then click Publish.
Publish the application
After you publish the application, enterprise employees can find and use it.
Return to the Application list and select the target application to open its details page.
In permission management, grant the
Card.Streaming.Write,Card.Instance.Write, andqyapi_robot_sendmsgpermissions.In the left navigation pane, select version management and release, and then click Create new version.
In the version details, enter the Application version number and Version description, select the availability scope, and then click Save.
NoteWhen selecting the availability scope, choose a scope that matches your business requirements. If you select all employees, the application will be visible to all employees in the enterprise after it is published.
Integrate with OpenClaw cloud computer
Open the Wuying Client and log in to the Personal Edition. Scan the QR code on the desktop to open the Wuying Cloud Computer mini program.
In the Cloud computer list of the mini program, find the OpenClaw cloud computer and click OpenClaw application configuration.
On the OpenClaw application configuration page, select IM channel configuration.
Click Add channel and select DingTalk as the service provider.
Enter the Client ID and Client Secret of the DingTalk application, and then click Save.
Interact with the DingTalk robot
Interact in a group chat
Open the DingTalk client and go to any group chat.
If you use an existing group chat, ensure that it belongs to the same organization where you created the robot.
If you create a new group chat, ensure that you select the same organization where you created the robot.
Click the group settings icon in the upper-right corner and select Robot.
In the robot management module, select Add robot.
On the add robot page, find the robot that you created and published, and then click to add it.
After you add the robot, @mention it to receive an automatic reply.
Interact with the robot directly
In the search bar at the top of DingTalk, search for and select the robot you created to start a direct conversation.
Send a message to start a one-on-one conversation with the robot.
FAQ
Robot does not receive messages
Verify that the Client ID and Client Secret are configured correctly.
Ensure the application has the
Card.Streaming.Write,Card.Instance.Write, andqyapi_robot_sendmsgpermissions.Check whether the robot's message receiving address is configured correctly.
Ensure that you have published the application version.
Robot not found in group chat
Possible causes:
The group chat belongs to a different organization than the one where you created the robot. Select or create a group chat in the correct organization.
The group chat belongs to the correct organization but is not an internal group. You must convert it to an internal group.