I. Preparation Before Integrating

Before integrating OpenClaw to the WeCom Smart Robot, ensure the basic environment configuration on the device side meets the requirements for both hardware/software and application versions:
1. The latest version of the WeCom client is installed.
2. OpenClaw is installed on a local device, or its deployment is completed on Tencent Cloud Lighthouse (or services from other cloud providers).
3. Confirm that the operation terminal can execute command-line instructions normally (use the local terminal for local deployment; use the corresponding server terminal for cloud deployment).
4. Risk Warning: Using model-called interfaces to operate WeCom internal apps may be affected by model hallucinations and other factors, posing risks such as data leakage and privilege escalation. It is recommended to first verify in a test company, then use it with caution. By proceeding with installation, you accept the potential risks by default.

II. Standard Integration Process

2.1 Create a Smart Robot via long connection and access the Bot ID and Secret

Creating a smart robot via API Mode (Long Connection) supports passive replies to multiple messages and proactive sending of messages to users. This is the exclusive creation method for integrating with OpenClaw. The operational steps are as follows:
1. Open the WeCom app, go to Workspace -> Smart Robot, and click Create Robot-> Manual Creation.
2. After entering the creation page, select API Mode Creation (the page indicates: “If you need to use your own system to access chats between members and the robot and output replies, you can switch to API mode creation”).

3. On the API configuration page, choose The connection method is “Use Long Connection” (does not require a domain/IP to receive messages and return results, unlike the URL callback method).
4. When configured, the page will automatically generate and display the Bot ID and Secret. Securely save this information (it will be needed for subsequent integration with OpenClaw).

5. Additionally, configure the robot’s visible scope. Keep other items as the default. The API mode currently does not support preview and debugging. Save the robot configuration directly.
Note: The Long Connection method is recommended for integrating with OpenClaw. For OpenClaw deployed on cloud service providers, the URL callback method can also be chosen to quickly create a robot for integration.
6. Long-connection smart robots support receiving/sending messages in formats such as text, images, mixed text and images, audio, video, and files. For details, please refer to the API documentation.

The message type formats are described as follows:

2.2 Associate WeCom Robot with OpenClaw

Both locally and cloud deployed OpenClaw complete plugin installation, channel addition, and information configuration via the terminal command line.

2.2.1 Deploy OpenClaw in Tencent Cloud Lighthouse and associate the robot

1. Use Tencent Cloud Lighthouse.
2. Enter Lighthouse, select the Lighthouse instance where OpenClaw is deployed, click the server instance card to enter the “Manage Instance” page, and go to the “App Management” page.

3. Under “Models”, you need to add a model

If a model is not added, the following error will occur during conversation

4. In the Channels section, select WeCom Robot (Long Connection)
Sequentially enter the Bot ID and Secret randomly generated when creating the WeCom robot mentioned earlier in the input boxes. After filling in the details, click the Add and Apply button on the interface, click OK in the pop-up box, wait for a moment, and you will see the completed WeCom robot configuration in the interface.

5. After entering the details, click Add and Apply, and complete the restart.

6. Return to the WeCom robot creation page, save, and create. You can now chat normally with the smart robot in WeCom.

7. If you cannot find the robot after configuration is complete, you can find it via the following path: Workspace -> Smart Robot -> Details -> Go to Use -> Send Message

2.2.2 Deploy OpenClaw in the local terminal and associate the robot

1. Install the WeCom plugin: Open the local terminal, open the terminal, and execute the following commands in sequence
npx -y @wecom/wecom-openclaw-cli install

2. Integrate by scanning QR code with WeCom: Select QR code integration and scan the QR code with WeCom

3. One-click robot creation: No further configuration is needed; simply click “One-click create robot”

4. Auto-integrate OpenClaw: Once the robot is successfully created, it will automatically integrate with the local OpenClaw without manual pairing. You can click “Use” to start chatting with the robot.

III. Appendix 1: Guide for Robots Using Documents via MCP

Prerequisite: Please upgrade to the latest WeCom OpenClaw plugin. If you have not upgraded yet, enter the following code in your local terminal:
openclaw plugins update wecom-openclaw-plugin

3.1 Feature introduction

The 5.0.7 version updated on March 13th now supports robots creating documents and Smart Sheets via MCP.

3.2 Configuration method

3.2.1 Configuration method 1: Authorize and use docs via chat
1. You can directly instruct the robot to operate the docs. For example: “Help me collect important news in the retail industry this week and summarize it into a WeCom doc.” The robot will automatically send an authorization link to request permission.

2. Click to enter the authorization page, then click “Confirm Authorization” to grant the robot permission to use documents.

3. After successful authorization, simply tell the robot “Authorized”, and it will automatically connect to the MCP service and generate the document.

3.2.2 Configuration method 2: Manual authorization
Prerequisite: An API mode robot has already been created, and OpenClaw integration has been completed.
1. Entry: Go to Workspace -> Smart Robot -> Locate the corresponding robot integrated with OpenClaw, enter the Edit page, and click “Available Permissions”.

2. Click “Authorize”, and copy either the streamableHTTP URL or the JSON Config (either one will suffice; in practice, the JSON Config tends to provide more stable reasoning installation across models).


3. Send the copied configuration to the robot to complete the installation.

3.2.3 Typical configuration cases
Case 1: Collect important news in the retail industry this week and summarize it into a WeCom document.


Case 2: Organize the basic information and current month’s trends of the Top 10 companies in the catering industry, and compile them into a WeCom smart sheet, including company name, organization size, main catering category, and recent trends.

IV. Appendix 2: Guide for Using Smart Sheet Webhooks

OpenClaw can quickly integrate WeCom Smart Sheet via Webhooks to achieve automatic data writing and updating. As a data carrier, Smart Sheets supports multi-scenario data synchronization and visual display. For detailed configuration and integrate methods, please refer to: Receive External Data to Smart Sheet.

4.1 Core configuration method

1. Enable the “Receive External Data” feature in the WeCom Smart Sheet. The system will generate a unique Webhook address for the sheet.
2. Use a standard HTTP POST request to synchronize data generated by OpenClaw to this address, thereby adding or updating records in the Smart Sheet.

4.2. Applicable scenarios

V. Appendix 3: WeCom API Invocation Guide

If you need to further call various WeCom app APIs (such as Docs, Approvals, Attendance, etc.) via OpenClaw, you must first access WeCom’s CorpID and App Secret, and then complete the API call authorization. The steps are as follows:

5.1 Access CorpID and app Secret

1. Access CorpID: Log in to the WeCom Admin Console, enter My Company, and the unique CorpID will be displayed at the bottom of the page.

2. Access app Secret:

• In the admin console, go to App Management -> Self-built Apps, then create a new self-built app or select an existing one (it is recommended to create a new one for a complete experience).
• On the app details page, click “View Secret”. After following the prompts to send, you can access the Secret of the app in the WeCom message list.

5.2 API call process

1. Send the accessed CorpID and App Secret to the WeCom robot that is already associated with OpenClaw.
2. Issue the command 「Get access token」 to the robot to retrieve the core credential for making API calls.
3. Use the acquired access token to invoke various WeCom server APIs (e.g., creating a document, initiating an approval, querying attendance data, etc.).
4. API call example (Taking “Create a Smart Sheet” as an example):
Note: For the specific call rules of APIs for various functional modules of WeCom, please refer to the official 「Calling API Documentation」.

VI. FAQs

1. How to deploy and install OpenClaw in the local terminal?

Currently, WeCom does not provide a download link for OpenClaw. You need to install OpenClaw on your local device yourself, or complete the deployment of OpenClaw on instances of Tencent Cloud Lighthouse (and other cloud provider services).

2. What is the difference between long-connection integration and URL callback integration?

The long connection method is recommended for integrating with OpenClaw. For OpenClaw deployed on cloud service providers, the URL callback method can also be chosen to quickly create a robot for integration.
Note: The long-connection integration method does not require a company domain or IP; the URL Callback method requires a company-trusted domain and IP, or a domain where the filing entity is the same as the company entity. See Trusted Domain Description for details.

3. Can only the company Super Admin operate the integration of OpenClaw to WeCom Smart Robot?

Currently, administrators and members with the permission to create smart robots can integrate OpenClaw in the Smart Robot section.

4. Can OpenClaw integrate to robots be restricted for company members?

Administrators can configure the available members for the robot’s Long Connection method. Operation Path:
Admin Console -> Security and Management -> Management Tools -> Smart Robot -> Management -> API Mode Management -> Configure members who can integrate via “Long Connection”

(1) Default settings:

• For large enterprises with more than 1,000 members in the Contacts, this setting is empty by default, meaning “No members in the enterprise can configure smart robots via long connection”. Administrators can manage permissions manually.
• For SMEs with 1,000 or fewer contacts, the scope of this setting is consistent with the members who have “Robot Creation Permission.” This means “Members who can create smart robots in the enterprise can configure Long Connection robots.” Administrators can manage this subsequently.
  (2) When members without permission attempt to integrate via Long Connection: The Bot ID and Secret will not be displayed, and the page will prompt: “To get the Bot ID and Secret, please contact the administrator to activate ‘Long Connection’ permission.”

5. Do I need to apply for a large language model Token before deploying OpenClaw in the local terminal?

Yes, it is required.

6. I deployed OpenClaw via Tencent Cloud Lighthouse and linked it to a robot, but the smart robot does not reply after running. What is the issue?

The plugin used by OpenClaw deployed via Tencent Cloud Lighthouse, is not provided by WeCom. It is recommended to seek assistance from the Lighthouse team.

7. Can the OpenClaw robot be used in external groups / customer groups?

Currently, configuring OpenClaw to integrate to the WeCom smart robot does not support usage in external groups / customer groups for the time being.

8. After integrating OpenClaw, what integration permissions does WeCom provide? What features can be realized?

All public skills can be installed. More official plugins will be supported in the future, so please stay tuned.

9. After integrating OpenClaw to a smart robot, can it recognize attachments?

For OpenClaw to integrate a smart robot and support attachment recognition, it must be using a multimodal model.

10. Why did I receive an update reminder for the WeCom OpenClaw plugin?

Starting from the afternoon of March 20, 2026, for long-connection robots that have had chats in the past month across the entire network, a notification regarding the upgrade of the OpenClaw WeCom official plugin will be pushed to the robot creators via the robot. You can view the updated version, new capabilities, and update commands within the update notification, and you can directly input commands in the terminal to complete the update.
Subsequently, when all the following conditions are met simultaneously, the robot creator will receive an upgrade notification once:
(1) A new version of the OpenClaw WeCom official plugin is available.
(2) The smart robot is in long-connection mode.
(3) The user enters the robot chats.