March 9, 2026

How to Connect OpenClaw to WeChat via QClaw (2026 Guide)

Learn how to use QClaw to connect OpenClaw to WeChat. Control your AI agent from WeChat on iPhone or Android. Step-by-step setup guide.

AdSense · 728×90

WeChat is where most communication happens for over a billion people. QClaw bridges that into OpenClaw — so instead of switching to a dedicated app or terminal to interact with your AI agent, you just message it the same way you’d message anyone else.

This guide covers both the recommended path (QClaw) and the manual path (raw OpenClaw with a custom bridge) for WeChat integration, plus QQ setup.

QClaw handles WeChat binding through a QR code flow that mirrors WeChat Web login. This is the fastest and most stable way to connect OpenClaw to WeChat.

Prerequisites:

  • QClaw installed on Mac or Windows (install guide here)
  • WeChat on your iPhone or Android phone, logged into your account
  • Active internet connection on both your computer and phone

Step 1: Open QClaw

Launch QClaw from your Applications folder (Mac) or Start menu (Windows). In the left sidebar, click Channels, then click Add Channel → WeChat.

Step 2: Scan the QR Code

QClaw will display a large QR code on screen. This code is valid for 2 minutes. If it expires, click Refresh.

Open WeChat on your phone:

  • iPhone: Tap the + icon at the top right of the Chats screen → Scan QR Code
  • Android: Tap the + icon (or use the search/discover bar) → Scan QR Code

Point your camera at the QClaw QR code on your screen.

Step 3: Confirm on Phone

After scanning, WeChat will show a confirmation screen asking if you want to log in on the connected device. Tap Confirm.

You’ll see the QClaw interface update immediately — the channel status will turn green and show your WeChat display name.

Step 4: Choose How to Reach Your Agent

QClaw supports two delivery modes for WeChat:

Filehelper mode (default): Messages you send to Filehelper (文件传输助手) in WeChat go directly to your agent. Filehelper is already in every WeChat account’s chat list — no setup needed. This is the simplest mode and is recommended for personal use.

Contact mode: QClaw can create a dedicated contact in your WeChat that acts as the agent interface. This keeps agent conversations separate from your personal Filehelper. Enable this in QClaw Settings → WeChat → Use Dedicated Contact.

Step 5: Test the Connection

In WeChat, open Filehelper (or your dedicated agent contact) and send:

What time is it right now?

Your agent should respond within a few seconds. If you get no response, check the QClaw status indicator in your menu bar or system tray — a red indicator means the session has expired and you need to re-scan the QR code.

Option 2: Manual OpenClaw WeChat Bridge (Advanced)

Raw OpenClaw does not include a native WeChat integration. To connect WeChat manually, you need to run a separate WeChat bridge process that intercepts messages from WeChat Desktop and routes them to the OpenClaw gateway.

This approach uses the openclaw-wechat-bridge community project:

# Install the bridge
clawhub install wechat-bridge

# Start the bridge (requires WeChat Desktop installed and logged in)
openclaw bridge start wechat

The bridge works by hooking into the WeChat Desktop application’s local message database. It’s less stable than QClaw’s approach (it can break when WeChat updates) and requires WeChat Desktop to be running on the same machine as OpenClaw.

Recommendation: Unless you have a specific reason to avoid QClaw, use the QClaw approach above. It’s more stable, officially supported, and doesn’t require WeChat Desktop to be open constantly.

What Can You Do via WeChat?

Once connected, you interact with your OpenClaw agent exactly as you would in any other channel. Everything you can do over Telegram or WhatsApp works identically over WeChat:

Information retrieval:

Search the web for the latest news about DeepSeek

Summarize the top 5 articles on Hacker News today

What’s the weather in Shanghai this week?

Task execution:

Check my Gmail inbox and tell me if there’s anything urgent

Add a reminder to my calendar: dentist appointment, Friday March 13 at 3pm

Organize the files in my Downloads folder by file type

Multi-step workflows:

Draft a reply to the last email from [name], thank them for the proposal and say I’ll review by Thursday, then send it

Find the meeting notes from last Tuesday in my Obsidian vault and summarize the action items

Skill-powered commands:

[github] Show me open PRs in my repos that are older than 7 days

[cron] Remind me every morning at 8am with a summary of today’s calendar events

The WeChat channel is functionally identical to other channels — it’s just the delivery mechanism that differs.

QQ Setup

If you prefer QQ over WeChat, or want a separate bot account for agent interactions, QClaw supports QQ bots with a slightly different flow.

Creating a QQ Bot

  1. Go to q.qq.com and log in with your QQ account
  2. Navigate to Developer Center → Create Bot
  3. Fill in your bot’s name and description
  4. Submit for review — QQ bot approval typically takes 1–3 business days
  5. Once approved, copy your Bot Token from the bot management page

Connecting the QQ Bot to QClaw

  1. In QClaw, go to Channels → Add Channel → QQ
  2. Paste your Bot Token
  3. Click Connect

Your QQ bot will now forward messages to your local OpenClaw agent and relay its responses.

QQ Bot Commands

QQ’s bot platform supports up to 3 preset slash commands that appear as quick-action buttons in the bot’s chat interface. Configure these in QClaw Settings → QQ → Preset Commands. Useful defaults:

  • /inbox — Check and summarize your email inbox
  • /calendar — Show today’s schedule
  • /briefing — Run your daily briefing skill

QClaw supports up to 5 QQ bots simultaneously, each with its own skill configuration and preset commands. This lets you create purpose-specific bots — one for work tasks, one for personal, one for a group.

Keeping WeChat Connected

The WeChat session follows the same rules as WeChat Web:

  • Sessions expire after extended inactivity (typically 7–14 days)
  • Logging out of WeChat on your phone terminates all web sessions, including QClaw
  • WeChat may terminate sessions if it detects unusual activity patterns

QClaw monitors session health and will send you a system notification when re-authentication is needed. The re-bind process is the same as initial setup: just scan the new QR code.

For uninterrupted operation, avoid force-quitting WeChat on your phone and ensure it’s not being terminated by battery optimization features.

AdSense · 336×280