Integrate OpenClaw with WeChat

更新时间:
复制 MD 格式

The WeChat ClawBot plug-in lets you interact directly with OpenClaw in a WeChat chat window.

Before you begin

Before you configure a channel, you must purchase and configure a Simple Application Server instance with the OpenClaw application image by following the steps below or the instructions in Deploy an OpenClaw image. If you have already done this, you can skip this section.

Purchase and configure a Simple Application Server instance with the OpenClaw application image

Step 1: Purchase an OpenClaw package

Important

If you have already purchased a Simple Application Server, you can skip this step and deploy OpenClaw by resetting the system. When you reset the system, select the OpenClaw image under Application Images. However, resetting the system erases all data on the system disk of the Simple Application Server. Make sure that you back up your data as needed. For more information, see Reset system.

  1. Purchase a Simple Application Server instance pre-installed with the OpenClaw application.

  2. The Simple Application Server page has preset resource configurations. If you need to change them, review the following details:

    • Servers: Memory must be 2 GiB or higher. You can switch packages based on your requirements.

    • Region: The default region is China (Beijing).

    • Purchase Settings: The default subscription period is 12 months. You can change the duration as needed.

Step 2: Configure OpenClaw

OpenClaw provides two configuration methods. Select the tab for your image version below to view the instructions.

OpenClaw 2026.5.19 and later (recommended)

  1. Log on to the Simple Application Server console, click the instance ID on the server card, and then click the Server Overview tab on the Application Details page.

  2. On the Application Details page, click the Initialize button in the lower-left corner and follow the wizard to complete Step 1: Model Configuration.

    • Large Model Platform: Select a model provider from the drop-down list. Supported providers include Alibaba Cloud Model Studio Token Plan (Team Edition), Alibaba Cloud Model Studio Coding Plan, Alibaba Cloud Model Studio, DeepSeek, Kimi, GLM Coding Plan, and Zhipu.

    • API key: Select the region for your API key and enter the API key.

    • Model: Select or manually enter the model name.

    After completing the configuration, click Configure Now to proceed to the next step.

  3. In Step 2: Use Web UI of the initialization wizard, first click Allow Access in the Allow OpenClaw Access Port area to open the port. Then, click Log in to Web UI to access the OpenClaw Web UI and start a conversation with the OpenClaw agent.

    Important

    Opening the port exposes the service to the public internet. After initialization, you can disable public access with the Public access switch in the status bar at the top of the Application Details page. For more information, see How to enable or disable public access to the OpenClaw Web UI.

  4. (Optional) View the token. After initialization, you can copy the full token by clicking the copy button next to the token field in the status bar at the top of the Application Details page.

    Warning

    Do not disclose the full URL that contains the token. This link includes authentication credentials, and anyone with this link can bypass login verification and gain administrator access to the OpenClaw console.

OpenClaw before 2026.5.19

  1. In the Simple Application Server console, click the instance ID on the server card, and then click the Server Overview tab on the Application Details page.

  2. In the OpenClaw Usage Steps area, under Allow Port Access, click Run Command to open the firewall for the OpenClaw service runtime port.

    Important
  3. Click Run Command under Run Command to configure the Model Studio API key.

    You can configure two types of Model Studio API keys:

    • Coding Plan exclusive API key (recommended): This is a fixed monthly fee model that provides a monthly request quota. Calls that exceed the quota will fail without incurring charges, which helps prevent unexpected costs.

      The Coding Plan currently supports models such as qwen3.5-plus, kimi-k2.5, MiniMax-M2.5, and glm-5. For a detailed list of models, see Coding Plan overview.
    • Pay-as-you-go Model Studio API key based on token usage.

    Configure the API key. Select the Coding Plan API key from the drop-down list or directly enter the pay-as-you-go API key. After selecting a model, click Next.

    If you manually enter an API key, ensure that the selected region matches the region of the API key. Otherwise, calls to the model may fail.
    Important

    The Model Studio Token Plan is not supported during the initial configuration process. Attempting to enter it will cause an error. If you need to use the Token Plan, complete the initialization first, and then refer to How do I connect to the Model Studio Token Plan Team Edition in OpenClaw? for configuration.

  4. Under Access Web UI panel, click Run Command to obtain the URL for the OpenClaw Web UI. You can then interact with the OpenClaw agent.

    You can disable public access to the Web UI at any time if needed. For more information, see Disable public access to the OpenClaw Web UI.
  5. (Optional) View the token.

    Navigate to Application Details > Basic Configuration > View token and click View to retrieve and save the token.

    Warning

    Do not disclose the full URL that contains the token. This link includes authentication credentials, and anyone with this link can bypass login verification and gain administrator access to the OpenClaw console.

Integrate with WeChat

Make sure your WeChat application is updated to the latest version.

OpenClaw provides two methods for WeChat integration. Select the tab that corresponds to your image version to view the required steps.

OpenClaw 2026.5.19 and later (Recommended)

We recommend using the QR code method in the new console, which does not require running terminal commands.

  1. Log on to the Simple Application Server console. Find the target OpenClaw server and go to the Application Details tab.

  2. On the channels card, click Add channel.

  3. From the channel drop-down list, select WeChat.

  4. Keep the default QR Code-based IM Access tab selected and click Configure by Scanning QR Code.

  5. Use WeChat to scan the QR code in the pop-up window to complete the integration. Then, start a conversation with the WeChat ClawBot to verify the connection.

    Generating the QR code can take 30 seconds to 2 minutes.

Earlier versions

You must use the QR code in the old console or a terminal command to integrate with WeChat.

Connect via console QR code

This method is supported only for OpenClaw image version 2026.3.28 and later. For other versions, use the terminal command method.
  1. Log on to the Simple Application Server console. Find the target OpenClaw server and go to the Application Details tab.

  2. In the channel configuration area, under the WeChat section, click Scan to Configure.

  3. When the command finishes, a QR code is displayed on the page. Scan the QR code with WeChat to complete the integration.

    Generating the QR code can take 30 seconds to 2 minutes.
  4. After scanning the code, click Close.

  5. Start a conversation with the WeChat ClawBot to verify the connection.

    The first interaction may take 30 seconds to 2 minutes to initialize.

Connect via terminal command

Procedure

  1. View the WeChat ClawBot plug-in. In WeChat, go to Me > Configure > Plug-ins. Find the WeChat ClawBot card and tap View Details.

    image

  2. Log on to the Simple Application Server console. In the server list, find the target server and click Remote Connection on its card. In the pop-up window, click Log on Now in the Connect with One-click on Workbench section. Copy the installation command from the plug-in page, or run the following command directly:

    For OpenClaw 2026.3.28, use the openclaw channels login --channel openclaw-weixin command to connect.
    npx -y @tencent-weixin/openclaw-weixin-cli@latest install
  3. When the command finishes, a QR code is generated in the terminal. Scan the QR code with WeChat to bind your account.

    image

  4. Go to the OpenClaw Web UI and verify that the WeChat channel appears in the channel list.

    image

  5. After the binding is successful, you can interact with OpenClaw directly in a WeChat chat window.

    image