configure

name	configure
description	Set up the WeChat channel — scan QR code to login, check channel status. Use when the user asks to configure WeChat, login, or check channel status.
user-invocable	true
allowed-tools	["Read","Write","Bash(ls *)","Bash(mkdir *)","Bash(bun *)"]

/weixin:configure — WeChat Channel Setup

Manages WeChat iLink Bot login and credential storage. Credentials live in ~/.claude/channels/weixin/credentials.json.

Arguments passed: $ARGUMENTS

---

Dispatch on arguments

No args — status and guidance

Read both state files and give the user a complete picture:

1. Credentials — check ~/.claude/channels/weixin/credentials.json for token and baseUrl. Show set/not-set; if set, show token first 6 chars masked.

2. Access — read ~/.claude/channels/weixin/access.json (missing file = defaults: dmPolicy: "pairing", empty allowlist). Show:

   • DM policy and what it means
   • Allowed senders: count and list
   • Pending pairings: count with codes and sender IDs

3. What next — concrete next step based on state:

   • No credentials → "Run /weixin:configure login to scan QR code and connect."
   • Credentials set, nobody allowed → "Send a message to the bot on WeChat. It replies with a code; approve with /weixin:access pair <code>."
   • Credentials set, someone allowed → "Ready. Message the bot on WeChat to reach the assistant."

login — QR code login

This is a TWO-STEP process. The scripts are in the plugin install directory. Find the plugin root by looking for the login-qr.ts file:

~/.claude/plugins/cache/m1heng-plugins/weixin/*/login-qr.ts

Use ls to resolve the wildcard and get the actual path.

Step 1: Fetch and display QR code

bun <plugin-root>/login-qr.ts

This script:

• Fetches a QR code from https://ilinkai.weixin.qq.com/
• Renders it in the terminal using npx qrcode-terminal
• Shows the direct link (user can open in WeChat)
• Outputs JSON as the last line: {"qrcode":"...","url":"..."}

Wait for the user after showing the QR code. Tell them: "用微信扫描二维码，或在微信中打开上面的链接。扫码完成后告诉我。"

Extract the qrcode value from the last line of output — you'll need it for step 2.

Step 2: Poll for scan result

After the user says they've scanned (or just proceed after showing the QR):

bun <plugin-root>/login-poll.ts <qrcode>

This script polls the WeChat API for scan status. It outputs one line:

• scaned — user scanned, waiting for confirmation on phone
• expired — QR expired (exit code 1). Offer to re-run step 1.
• timeout — timed out (exit code 1). Offer to re-run step 1.
• {"token":"...","baseUrl":"...","accountId":"...","userId":"..."} — success! Credentials saved and scanner added to allowlist. (exit code 0)

On success, tell the user:

• "✅ 微信连接成功！"
• Credentials saved, user added to allowlist
• "重启 Claude Code 会话以启用微信频道"

On scaned, tell the user "已扫码，请在微信上点击确认..." and note the poll script is still running.

clear — remove credentials

Delete ~/.claude/channels/weixin/credentials.json.

baseurl <url> — set custom API base URL

For testing or alternative iLink endpoints. Read existing credentials.json, update baseUrl, write back.

---

Implementation notes

• The channels dir might not exist if the server hasn't run yet. Missing file = not configured, not an error.
• The server reads credentials.json once at boot. Credential changes need a session restart. Say so after saving.
• access.json is re-read on every inbound message — policy changes via /weixin:access take effect immediately, no restart.
• Default API base URL is https://ilinkai.weixin.qq.com/.
• The QR code URL is a WeChat mini-program link. It works when scanned with WeChat's QR scanner OR when opened in WeChat's built-in browser.