All Products
Search
Document Center

Elastic Desktop Service:DingTalk integration

Last Updated:Jun 16, 2026

This topic describes how to integrate your Agent with DingTalk. Two methods are available: Quick Pairing (scan-and-go, no app creation required) and Link Existing Bot.

Prerequisites

  • You have created an Agent in the Agent Management Center.

Channel configuration

  1. Go to the Agent Management Center.

  2. In the left-side navigation pane, select your Agent type, such as JVS Computer.

  3. Click Channel Configuration.

  4. In the Actions column of the target Agent, click View/Configure Channel.

  5. On the DingTalk card, click Configure Now.

In the dialog that appears, select one of the following methods to complete bot integration:

Express Pairing

Note

Requires cloud computer image version: Windows 3.2.18 or later, or Linux 3.0.10 or later. Restart your cloud computer to update.

  1. Click Send Now. The system sends an SMS or email containing an access link to the authorized user.

  2. The authorized user opens the URL from the SMS or email to access the binding page and obtain a QR code. You can also copy the URL directly from the console.

  3. Scan the QR code with DingTalk to complete the bot binding.

  4. Chat with the bot in DingTalk to verify the connection.

Note

If another bot is already bound, it is replaced when you scan the new QR code.

Associate Existing Robot

Create a DingTalk app

Note

Your DingTalk organization must have developer permissions. If not, see Obtain developer permissions. To quickly create an organization, scan this QR code with the DingTalk mobile app.image

  1. Log in to the DingTalk Open Platform developer console.

  2. In the top navigation bar, click App Development, then click Create Now to create an OpenClaw bot app.

  3. On the Create OpenClaw page, enter the bot name, description, and icon. Keep the defaults unless needed, then click OK.

  4. The page displays the Client ID and Client Secret. Copy and store them securely for channel configuration.

    Note

    The Client ID and Client Secret grant access to your app data. Keep them confidential.

Enter credentials to complete the integration

  1. Go back to the Agent Management Center, enter the Client ID and Client Secret of your DingTalk app, then click OK.

  2. Chat with the bot in DingTalk to verify the connection.

Chat with the DingTalk bot

Chat with the bot in a group

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

    • For an existing group, ensure it belongs to the same organization as the bot.

    • For a new group, select the same organization as the bot.

  2. Click the group settings icon in the upper-right corner and select Group Bots.

  3. In the bot management section, click Add Bot.

  4. Search for the bot you created and published, then click it to add.

  5. @mention the bot in the group to trigger automatic replies.

Chat with the bot directly

  1. Search for the bot by name in the DingTalk search bar.

  2. Send a message to start a one-on-one chat.

FAQ

The DingTalk bot doesn't receive messages after configuration

  • Check that the Client ID and Client Secret are correct.

  • Ensure the app is published.

Bot not found when adding to a group

Causes:

  • The group belongs to a different organization. Use a group in the same organization as the bot, or create one.

  • The group is in the correct organization but is not an internal group. Convert it to an internal group.