WeChat Integration

The WeChat adapter binds a bot account by QR code, then authorizes individual private-chat users through pairing or an allowlist.

It supports text, transcribed voice content, image and file attachments, project selection, status, stop, and text-based permission approval. Group chats are not supported.

Bind the WeChat bot account

Open Settings → IM Integration → WeChat:

Select Scan to bind.
Scan the QR code with WeChat.
Confirm the login in WeChat.
Wait for Desktop to show the bound state.
Save the configuration.

Desktop stores the returned accountId, botToken, baseUrl, and userId in the wechat section of ~/.claude/adapters.json, then restarts the adapter sidecar.

Binding credentials does not authorize every WeChat user.

Authorize a user

Generate a pairing code at the top of IM Integration, then send the six-character code to the bound bot in a private chat.

The code:

expires after 60 minutes;
can be used once;
is replaced immediately when a new code is generated;
is rate limited after repeated failures.

Known WeChat user IDs can instead be entered in Allowed Users.

Projects and sessions

With a default project configured, the first accepted message creates or resumes a session in that directory.

Without a default project, the adapter returns recent projects. Reply with a number, project name, or absolute path. The resulting chat-to-session mapping is stored in ~/.claude/adapter-sessions.json.

Use /new to choose another project and start a new session.

Commands

/help or 帮助
/status or 状态
/projects or 项目列表
/new or 新会话
/new <number, project name, or absolute path>
/clear or 清空
/stop or 停止

Permission approval

Reply to the text approval message with:

/allow <requestId> — allow once
/always <requestId> — persist the matching approval
/deny <requestId> — deny

The adapter sends the response back to the pending Desktop session.

Attachments and replies

WeChat messages are received through long polling.
Long text is split into platform-sized messages.
Images enter model input as inline images.
Other files are downloaded to a local temporary path for the session.
Shared attachment size limits are enforced.

Unbind

Unbinding the WeChat account clears its credentials and platform authorization lists. Removing one paired user only revokes that user.

Development

Packaged Desktop starts the sidecar automatically. For source development:

cd adapters
bun install
bun run wechat

Optional overrides:

export WECHAT_ACCOUNT_ID="..."
export WECHAT_BOT_TOKEN="..."
export WECHAT_BASE_URL="https://ilinkai.weixin.qq.com"
export WECHAT_USER_ID="..."
export ADAPTER_SERVER_URL="ws://127.0.0.1:3456"

If messages are rejected, confirm that Desktop is running, the account is bound, the sender is paired or allowlisted, and both adapter state files are writable.

3.0 KiB Raw Blame History