All Products
Search

This Product

    :DingTalk integration

    Document Center

    :DingTalk integration

    Last Updated:Mar 25, 2026

    This document describes how to integrate OpenClaw with DingTalk using a DingTalk application and a bot. This integration allows users to interact with the bot to execute tasks in OpenClaw.

    Overview

    This integration lets users interact with a DingTalk bot to perform tasks in OpenClaw. The integration process involves the following key steps:

    • Create a DingTalk application and configure security credentials to connect it to the OpenClaw cloud computer.

    • Create a DingTalk bot.

    • Create a card template.

    • Publish the DingTalk application.

    • Use the DingTalk bot.

    Create a DingTalk application

    1. Go to the DingTalk Open Platform.

      Note

      • You must select an organization where you have developer permissions, or select an organization and then obtain developer permissions.

      • If you do not have a suitable organization, you can scan the QR code below with the DingTalk mobile app to quickly create one.image

    2. In the top navigation bar, click App development. On the DingTalk apps page, click Create app.

    3. In the left-side navigation pane, select Credentials and basic information. View and copy the Client ID and Client Secret.

    4. Return to the OpenClaw Config page in your cloud computer and select Channel settings.

    5. Enable the DingTalk card toggle, and paste the copied Client ID and Client Secret into the App Key and App Secret fields, respectively.

    6. After filling in the fields, click Save in the upper-right corner.

    Create a DingTalk bot

    1. After you create the application, select Add app capabilities in the left-side navigation pane. Under the Bot card, click Add.

    2. On the bot configuration page, enable Bot configuration.

    3. For Message receiving mode, select Stream mode and click Publish to complete the bot configuration.

    4. In the left-side navigation pane, select Version management and release, and then click Create new version.

    5. After completing the configuration, click Save at the bottom to publish the version.

    Create a message card

    DingTalk bots use message cards for streaming responses, which requires creating a card template.

    1. Go to the Card Platform and click Create template.

    2. 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 app: Enter the name of the application you created.

    3. On the card editing page, click Save in the upper-right corner, and then click Publish.

    Publish the application

    After you publish the application, employees in your organization can find and use it.

    1. Return to the App list and select your target application to go to its details page.

    2. In Permission management, enable the Card.Streaming.Write, Card.Instance.Write, and qyapi_robot_sendmsg permissions.

    3. In the left-side navigation pane, choose Version management and release and click Create new version.

    4. In the version details, enter the Application version and Version description, select the application's availability scope, and then click Save.

      Note

      When selecting the availability scope, choose the visibility range based on your business needs. If you select All Employees, the application becomes visible to all employees in the current organization upon publication.

    Chat with the DingTalk bot

    Chat with the bot in a group

    1. Open the DingTalk client and enter any group chat.

      • If you use an existing group chat, ensure that its owner organization is the same as the organization where the bot was created.

      • If you create a new group chat, ensure that the owner organization you select is the same as the organization where the bot was created.

    2. Click the group settings icon in the upper-right corner, go to the group settings page, and select Bots.

    3. In the bot management section, select Add bot.

    4. On the Add Bot screen, search for the bot you created and published, then click it to add it.

    5. After the bot is added successfully, @mention the bot to trigger an auto-reply.

    Chat with the bot in a direct message

    1. In the top search bar of DingTalk, search for the name of the bot you created to start using it.

    2. Send a message to start a one-on-one conversation with the bot.

    FAQ

    Troubleshooting: Bot does not receive messages

    • Verify that the Client ID and Client Secret are configured correctly.

    • Confirm that you have granted the Card.Streaming.Write, Card.Instance.Write, and qyapi_robot_sendmsg permissions.

    • Verify that the bot's message receiving endpoint is configured correctly.

    • Ensure that you have published the application version.

    Troubleshooting: Bot not found when adding to a group

    • The group chat and the bot belong to different organizations. You must use or create a group chat in the same organization as the bot.

    • The group is not an internal group. You must convert it to an internal group to add the bot.