How to Connect OpenClaw to WeChat

Prerequisites

• ✓An existing OpenClaw Gateway deployment so you can attach chat channels.
• ✓Access to Tencent iLink Bot so you can use the `@tencent-weixin/openclaw-weixin` plugin.
• ✓A WeChat account you control for private chats with your OpenClaw agent.

Steps

1. 1

   Review supported chat channels in OpenClaw

   Start by understanding how WeChat sits alongside other messaging platforms in OpenClaw. The channels page lists every supported integration and highlights which ones are bundled plugins versus separate packages.

   This helps you confirm that WeChat is supported and see alternatives like Telegram or WhatsApp if your use case changes.

   textCopy

   *   [BlueBubbles](https://docs.openclaw.ai/channels/bluebubbles) — **Recommended for iMessage**; uses the BlueBubbles macOS server REST API with full feature support (bundled plugin; edit, unsend, effects, reactions, group management — edit currently broken on macOS 26 Tahoe).
   *   [Discord](https://docs.openclaw.ai/channels/discord) — Discord Bot API + Gateway; supports servers, channels, and DMs.
   *   [Feishu](https://docs.openclaw.ai/channels/feishu) — Feishu/Lark bot via WebSocket (bundled plugin).
   *   [Google Chat](https://docs.openclaw.ai/channels/googlechat) — Google Chat API app via HTTP webhook.
   *   [iMessage (legacy)](https://docs.openclaw.ai/channels/imessage) — Legacy macOS integration via imsg CLI (deprecated, use BlueBubbles for new setups).
   *   [IRC](https://docs.openclaw.ai/channels/irc) — Classic IRC servers; channels + DMs with pairing/allowlist controls.
   *   [LINE](https://docs.openclaw.ai/channels/line) — LINE Messaging API bot (bundled plugin).
   *   [Matrix](https://docs.openclaw.ai/channels/matrix) — Matrix protocol (bundled plugin).
   *   [Mattermost](https://docs.openclaw.ai/channels/mattermost) — Bot API + WebSocket; channels, groups, DMs (bundled plugin).
   *   [Microsoft Teams](https://docs.openclaw.ai/channels/msteams) — Bot Framework; enterprise support (bundled plugin).
   *   [Nextcloud Talk](https://docs.openclaw.ai/channels/nextcloud-talk) — Self-hosted chat via Nextcloud Talk (bundled plugin).
   *   [Nostr](https://docs.openclaw.ai/channels/nostr) — Decentralized DMs via NIP-04 (bundled plugin).
   *   [QQ Bot](https://docs.openclaw.ai/channels/qqbot) — QQ Bot API; private chat, group chat, and rich media (bundled plugin).
   *   [Signal](https://docs.openclaw.ai/channels/signal) — signal-cli; privacy-focused.
   *   [Slack](https://docs.openclaw.ai/channels/slack) — Bolt SDK; workspace apps.
   *   [Synology Chat](https://docs.openclaw.ai/channels/synology-chat) — Synology NAS Chat via outgoing+incoming webhooks (bundled plugin).
   *   [Telegram](https://docs.openclaw.ai/channels/telegram) — Bot API via grammY; supports groups.
   *   [Tlon](https://docs.openclaw.ai/channels/tlon) — Urbit-based messenger (bundled plugin).
   *   [Twitch](https://docs.openclaw.ai/channels/twitch) — Twitch chat via IRC connection (bundled plugin).
   *   [Voice Call](https://docs.openclaw.ai/plugins/voice-call) — Telephony via Plivo or Twilio (plugin, installed separately).
   *   [WebChat](https://docs.openclaw.ai/web/webchat) — Gateway WebChat UI over WebSocket.
   *   [WeChat](https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin) — Tencent iLink Bot plugin via QR login; private chats only.
   *   [WhatsApp](https://docs.openclaw.ai/channels/whatsapp) — Most popular; uses Baileys and requires QR pairing.
   *   [Zalo](https://docs.openclaw.ai/channels/zalo) — Zalo Bot API; Vietnam’s popular messenger (bundled plugin).
   *   [Zalo Personal](https://docs.openclaw.ai/channels/zalouser) — Zalo personal account via QR login (bundled plugin).

2. 2

   Identify the WeChat plugin package

   The WeChat integration is not a generic webhook; it is a specific Tencent iLink Bot plugin published on npm. You need the exact package name when you wire it into your OpenClaw setup or your deployment scripts.

   Copy the identifier directly from the docs so you avoid typos when adding it to your configuration or install commands.

   textCopy

   @tencent-weixin/openclaw-weixin

3. 3

   Plan your WeChat authentication with QR login

   WeChat in OpenClaw authenticates via QR login, which changes how you deploy compared to token-based channels like Telegram. You must be ready to scan a QR code from your WeChat client whenever you bring the bot online or re-authenticate.

   This impacts automation: you typically perform the QR scan during initial setup and when sessions expire.

   textCopy

   WeChat — Tencent iLink Bot plugin via QR login; private chats only.

4. 4

   Configure WeChat alongside other channels

   OpenClaw can run multiple channels at the same time and routes messages per chat, so you can enable WeChat without disabling Slack, Telegram, or WhatsApp. Group behavior and media support vary by channel, so you keep WeChat focused on private chats and use other channels where you need groups or richer features.

   Pairing and allowlists still apply, which keeps your WeChat bot safe from random contacts.

   textCopy

   Channels can run simultaneously; configure multiple and OpenClaw will route per chat.
   Group behavior varies by channel; see [Groups](https://docs.openclaw.ai/channels/groups).
   DM pairing and allowlists are enforced for safety; see [Security](https://docs.openclaw.ai/gateway/security).

Troubleshooting

Frequently asked questions