Create a DingTalk bot
Select or create an organization.
Go to the DingTalk Open Platform. When prompted to select an organization, choose one where you have developer permissions. Alternatively, select an organization and then obtain developer permissions.
If no organization is available, use the DingTalk mobile app to scan the following QR code. You will be redirected to a page where you can create a new organization.
DingTalk mobile app version 6.5.45 or later is required.
Create an OpenClaw bot with one click
Go to the DingTalk Open Platform. In the DingTalk app list of the developer console, find the banner Automatically create an OpenClaw bot app with one click to begin intelligent collaboration and click Create Now.
The platform preconfigures the OpenClaw bot information. You can modify the settings based on your business needs and then click OK to create the app.
If you plan to create multiple apps, change each bot's name or icon during creation so you can distinguish them later.
After the app is created, copy and save its Client ID (AppKey) and Client Secret (AppSecret).
After closing the dialog box, you can still open the created app and click Credentials and Basic Information in the left-side navigation pane to view its Client ID and Client Secret.
Create a custom bot
Create an app: In the developer console, click Create App, enter the App Name and App Description, upload an app icon, and save.
Add a bot: On the app details page, click Add App Capability in the left-side navigation pane, and select Add Bot.
Configure the bot: On the bot details page, configure the bot's name, icon, profile, description, and other information. Set the message receiving mode to stream mode. When configuration is complete, click Publish.
Configure permissions: Click Permission Management in the left-side navigation pane. Make sure the app has at least the following permissions. You can add others as needed:
Basic permission required to call the SNS API (snsapi_base)
Basic permission required to call the enterprise API (qyapi_base)
Permission for bots within the organization to send messages (qyapi_robot_sendmsg)
Write permission for interactive card instances (Card.Instance.Write)
Streaming update permission for AI cards (Card.Streaming.Write)
Configure the event subscription mode: Click Event Subscription in the left-side navigation pane. Under Subscription Management, set the push method to stream mode.
Publish the app: Click Version Management and Release in the left-side navigation pane, create a version, and publish the app.
Configure a DataClaw instance in the DataWorks console
Return to the DataWorks console and create an AI assistant service instance. For details, see AI assistant service configuration guide.
Test the bot
You can create a group chat or add the bot to an existing group chat. Mention @Bot in the DingTalk group to chat with it, or find the bot through search and start a private chat to test it.
Group chat
Go to the DingTalk group's Group Settings page and click the Bot card. On the Bot Management page, click Add Bot. In the Add Bot dialog box, enter the target bot's name in the Search text box and select the bot to add. Click Add , and then click Finish Adding.
Mention @Bot in the DingTalk group to interact with it. You can also enter the bot's name in the DingTalk search bar, find it on the results page, and start a private chat.
Private chat
Search for the bot's name in the search box at the top of DingTalk and click its avatar to start a private chat.
On the private chat page, chat directly with the bot.
Other considerations
If you use a non-commercial edition of DingTalk, check the following bot settings to avoid issues:
Set the bot's Message Receiving Mode and the Event Subscription > Standard Subscription > Push Mode to stream mode.
Do not configure an allowlist in the DingTalk app's Security Settings.
Make sure the DingTalk app has Write permission for interactive card instances and Streaming update permission for AI cards.