WeCom Channel Setup

Connect OpenClaw to WeCom (企业微信) via the official Tencent WebSocket plugin.

Prerequisites

• OpenClaw >= 2026.2.13
• A WeCom AI Bot created at WeCom Open Platform
• Bot API mode: 长连接 (WebSocket long-polling, no domain/IP required)
• Bot ID and Secret from the bot management page

> 📖 Full WeCom AI Bot docs: https://open.work.weixin.qq.com/help?doc_id=21657

Setup Steps

1. Install the plugin

openclaw plugins install @wecom/wecom-openclaw-plugin

Wait for installation to complete. A security warning about "Environment variable access combined with network send" is expected — the plugin needs the bot secret to establish WebSocket connections.

2. Configure the channel

Edit ~/.openclaw/openclaw.json. Add wecom under channels:

{
  "channels": {
    "wecom": {
      "enabled": true,
      "botId": "<YOUR_BOT_ID>",
      "secret": "<YOUR_BOT_SECRET>",
      "dmPolicy": "open",
      "allowFrom": ["*"],
      "groupPolicy": "open"
    }
  }
}

Also ensure the plugin is allowed and enabled under plugins:

{
  "plugins": {
    "allow": ["wecom-openclaw-plugin"],
    "entries": {
      "wecom-openclaw-plugin": {
        "enabled": true
      }
    }
  }
}

3. Verify the model configuration

The WeCom channel uses the global default model (agents.defaults.model.primary). Confirm it points to a provider with sufficient credits:

openclaw models status

If the default model's provider has no balance, update the primary:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "<provider>/<model>"
      }
    }
  }
}

4. Restart the gateway

openclaw gateway restart

If the restart exits with code 1 or produces no output (common on Windows), verify health manually:

# PowerShell
Invoke-WebRequest -Uri http://localhost:<port>/health -UseBasicParsing | Select-Object -ExpandProperty Content
# Expected: {"ok":true,"status":"live"}

5. Test

Send a message to the bot in WeCom. It should reply within a few seconds.

Troubleshooting

Access Control Options

Restrict to specific users (DM)

{
  "channels": {
    "wecom": {
      "dmPolicy": "allowlist",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Restrict to specific groups

{
  "channels": {
    "wecom": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["group_id_1"]
    }
  }
}