All Products
Search

This Product

    :Integrate the AI Assistant service with DingTalk

    Document Center

    :Integrate the AI Assistant service with DingTalk

    Last Updated:May 09, 2026

    Create a DingTalk bot

    Select or create an organization

    1. 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 get developer permissions.

    2. If no organizations are available, scan the QR code below with the DingTalk mobile app to create an organization.

      image

      Your DingTalk mobile app must be version 6.5.45 or later.

    Create an OpenClaw bot with one click

    Go to the DingTalk Open Platform. In the developer console's DingTalk application list, find the banner that says Automatically create an OpenClaw bot application with one click and start your intelligent collaboration journey and click Create Now.

    1. The platform pre-fills the information for the OpenClaw bot. You can modify the configuration based on your business needs, and then click OK to create the application.

      If you plan to create multiple applications, change the bot name or icon during creation to easily tell them apart later.

    2. After the application is created, copy and save its Client ID (AppKey) and Client Secret (AppSecret).

      If you close the dialog, you can still find the Client ID and Client Secret by opening the created application and selecting credentials and basic information from the left-side navigation pane.

    Custom bot

    1. Create an application: In the developer console, click Create App. Enter the App Name and App Description, upload an application icon, and then save.

    2. Add a bot: On the application details page, click Add App Capability in the left navigation pane, and select Add bot.

    3. Configure the bot: On the bot details page, configure its information, such as name, icon, profile, and description. Ensure that the message receiving mode is set to stream mode. When finished, click Publish.

    4. Configure permissions: Click permission management in the left navigation pane. The application must have at least the following permissions. You can add other permissions as needed:

      1. Basic permission required to call the SNS API (snsapi_base)

      2. Basic permission required to call the enterprise API (qyapi_base)

      3. Permission for bots within the organization to send messages (qyapi_robot_sendmsg)

      4. Write permission for interactive card instances (Card.Instance.Write)

      5. Streaming update permission for AI cards (Card.Streaming.Write)

    5. Configure the event subscription mode: Click event subscription in the left navigation pane. In subscription management, set the Push Mode to stream mode.

    6. Publish the application: Click version management and release in the left navigation pane, create a version, and publish the application.

    Configure DataClaw instance

    Return to the DataWorks console to create an AI Assistant service instance. For detailed instructions, see AI Assistant service configuration guide.

    Test the bot

    You can create a new group chat or add the bot to an existing one. In the group chat, @mention the bot to start a conversation. Alternatively, search for the bot to start a private chat for testing.

    Group chat

    1. Go to the Group Settings page of a DingTalk group and click the Bot card. On the Bot Management page, click Add Bot. In the Add Bot dialog, enter the name of your target bot in the Search text box and select it. Click Add , then click Finish.

    2. In the group chat, @mention the bot to interact with it. Alternatively, find the bot by entering its name in the DingTalk search bar and selecting it from the search results to start a private chat.

    Private chat

    1. In the search bar at the top of DingTalk, search for the name of the bot you created, then click its avatar to start a private chat.

    2. On the private chat page, start chatting with the bot.

    Notes

    If you are using a non-commercial version of DingTalk, check the following bot configurations to avoid unexpected behavior:

    • Both the bot's message receiving mode and the Push Mode under event subscription > General Subscription must be set to stream mode.

    • Do not configure an allowlist in the application's Security Settings.

    • Ensure the DingTalk application has the Write permission for interactive card instances and Streaming update permission for AI cards.