Add WeChat Channel (NanoClaw)

Step-by-step skill for wiring a personal WeChat account into NanoClaw using Tencent's official iLink Bot API with QR-code login.

AutomationAdvanced★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026

What it does

Guides the full process of adding a personal WeChat account as a messaging channel for a NanoClaw agent host.

Pulls the WeChat adapter and its registration test from the channels branch via git show
Appends the self-registration import to src/channels/index.ts and installs pinned wechat-ilink-client@0.1.0
Builds and runs a vitest integration test that proves wechat is actually in the channel registry
Sets WECHAT_ENABLED=true, restarts the service, and surfaces the QR URL from logs or data/wechat/qr.txt for phone scan login
Wires the first inbound DM to an agent group with the wire-dm.ts helper (interactive and non-interactive modes)
Adds operational guidance: session-expiry re-login, single-instance token rule, sync-cursor file care

Unlike wechaty/PadLocal setups, this uses a first-party Tencent API — no paid token, no public webhook, no ban risk.

Who it's for

NanoClaw operators who want to talk to their agent from WeChat
Home-server or intranet users who cannot expose a webhook URL
Anyone experimenting with personal WeChat bots without ToS exposure

Examples

Ask "add a WeChat channel to NanoClaw" — the skill runs pre-flight checks, copies the adapter, installs the dep, builds, and validates.
After QR login, message the bot from another WeChat account to auto-create the messaging group, then run wire-dm.ts --platform-id wechat:wxid_xxxxx --agent-group ag-xxxxx --non-interactive.
When logs show WeChat: session expired, delete data/wechat/auth.json and restart to re-scan the QR.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-wechat/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on AI Skill Mart.
Copy the .claude/skills/add-wechat folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-wechat/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-wechat ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

You need a local NanoClaw checkout. If you don't have one: git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw.
The skill already ships at .claude/skills/add-wechat in that repo. To use it globally: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-wechat ~/.claude/skills/.
Make sure Node.js >= 20 and pnpm are installed.
Open Claude Code in the project root and ask it to "add the WeChat channel" to trigger the skill.
Follow the prompts: add WECHAT_ENABLED=true to .env and restart the service (systemd on Linux, launchctl on macOS).
Open the URL in data/wechat/qr.txt in a browser and scan it with the WeChat app on your phone.
Have another WeChat account message the bot, then run pnpm exec tsx .claude/skills/add-wechat/scripts/wire-dm.ts to wire it to an agent group.
Never commit data/wechat/auth.json — it holds your session credentials.

View source on GitHub ↗License: MIT