add-wechat

Integrates a WeChat personal account channel into NanoClaw via Tencent's iLink Bot API.

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-wechat-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-wechat
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-wechat
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-wechat-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wechat-ilink-client, and includes scripts (resource) components.

What problem does it solve? Connecting a personal WeChat account to a NanoClaw agent normally requires unofficial libraries that risk account bans, paid tokens, or public webhook endpoints. This Skill installs a WeChat channel adapter built on Tencent's official iLink Bot API, using QR-code login and long-polling so no webhook URL, paid token, or ToS violation is involved. ## Core Features & Use Cases - Adapter installation: Copies the WeChat channel adapter and its registration test from the channels branch, registers it in the channel barrel, and pins the wechat-ilink-client dependency. - QR-code authentication: Enables the channel via WECHAT_ENABLED, prints a QR URL to logs and data/wechat/qr.txt, and persists auth credentials to data/wechat/auth.json after phone approval. - DM wiring script: The wire-dm.ts helper finds unwired WeChat messaging groups and connects them to an agent group through the running host's ncl CLI, supporting interactive or non-interactive flags. - Use Case: After running /setup, install this Skill, scan the QR code with your phone, have a friend message your bot account, then run the wire script so the agent replies to that WeChat DM. ## Quick Start Ask the assistant to add the WeChat channel to NanoClaw, then scan the QR code shown in the logs and run the wire-dm script to connect the first incoming DM to an agent group.

Frequently Asked Questions about add-wechat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a WeChat channel to NanoClaw?

Run the add-wechat skill: it copies the adapter from the channels branch, registers it in src/channels/index.ts, installs wechat-ilink-client, and builds the project. Then set WECHAT_ENABLED=true, restart the service, and scan the QR code from the logs with your phone.

How does WeChat bot login work without an API key?

Authentication uses a QR code scan instead of pre-configured API keys. The adapter prints a QR URL to the logs and data/wechat/qr.txt; you scan it with the WeChat mobile app and approve, after which credentials are saved to data/wechat/auth.json.

Is the iLink Bot API safer than wechaty or PadLocal?

The iLink Bot API is Tencent's official first-party API for personal WeChat bots, so there is no ToS violation or ban risk and no paid PadLocal token is required. It uses long-polling, so no public webhook URL is needed either.

Why is my WeChat bot not responding to messages?

A successful QR login alone is not enough; the messaging group must be wired to an agent group. Send a message from another account to auto-create the group row, then run scripts/wire-dm.ts while the NanoClaw host service is running.

What happens when the WeChat session expires?

When logs show 'WeChat: session expired', delete data/wechat/auth.json and restart the service to trigger a fresh QR scan. Do not delete data/wechat/sync-buf.txt in normal operation, since it holds the long-poll cursor and deleting it replays recent history.

Can multiple NanoClaw instances share one WeChat account?

No. Only one instance can use a given token at a time, so you must not point multiple NanoClaw instances at the same data/wechat/auth.json file. Each running bot needs its own WeChat account login.