add-wechat

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

1|Updated May 22, 2026
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-wechat-rosedwayane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-wechat
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-wechat
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-wechat-rosedwayane

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires wechat-ilink-client, better-sqlite3, 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 - Official API integration: Copies the WeChat adapter from the channels branch, registers it in the channel barrel, and pins the wechat-ilink-client dependency with a registration test to catch drift. - QR-code authentication: Enables the channel via WECHAT_ENABLED, prints a QR URL to logs, and persists auth credentials to data/wechat/auth.json after phone approval. - DM wiring script: The wire-dm.ts script links inbound WeChat messaging groups to agent groups with configurable sender policy (public, strict, request_approval) and session mode. - Use Case: An operator wants their NanoClaw agent to answer personal WeChat messages. They run the skill, scan the QR code with their phone, have a friend message the bot, then run wire-dm.ts so the agent responds with admin approval gating unknown senders. ## Quick Start Ask the agent to add the WeChat channel to NanoClaw and walk you through the QR login and first DM wiring.

Frequently Asked Questions about add-wechat

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

FAQPage Schema
How do I connect a personal WeChat account to a bot?

Install the WeChat adapter, set WECHAT_ENABLED=true in .env, and restart the service. The adapter prints a QR URL to the logs and data/wechat/qr.txt; scan it with the WeChat mobile app and approve the login to save credentials to data/wechat/auth.json.

What is the difference between iLink Bot API and 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 instead of a public webhook URL.

Does the WeChat bot need a public webhook URL?

No. The adapter holds a persistent long-poll connection to Tencent's iLink API and receives messages in real time, so no publicly reachable webhook endpoint is required.

Why is my WeChat bot not responding to messages after QR login?

A successful QR login only authenticates the account; the messaging group must still be wired to an agent group. Have another account message the bot to auto-create the messaging group, then run scripts/wire-dm.ts to create the messaging_group_agents row.

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.