WeChat Channel Configuration Assistant

Get Started (3 Steps)

Step 1: Scan QR Code to Log in to WeChat

qwen channel configure-weixin

1. The terminal will display a QR code URL
2. Open the URL to view the QR code
3. Scan the QR code with WeChat and confirm login
4. Wait for the prompt "Connected to WeChat successfully!"

• Token and BaseURL are automatically saved to

  ~/.qwen/channels/weixin/account.json

• Your WeChat user ID will be automatically recorded for subsequent configuration

Step 2: Add to Configuration File

~/.qwen/settings.json

channels

{
  "channels": {
    "my-weixin": {
      "type": "weixin",
      "senderPolicy": "allowlist",
      "allowedUsers": ["YOUR_WEIXIN_USER_ID"],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "You are a concise programming assistant, replying via WeChat. Keep answers brief.",
      "model": "qwen3.5-plus"
    }
  }
}

cat ~/.qwen/channels/weixin/account.json | grep userId

userId

allowedUsers

Step 3: Start the Channel Service

qwen channel start my-weixin

Configuration Option Explanations

type

"weixin"

"weixin"

senderPolicy

allowlist

open

pairing

"allowlist"

allowedUsers

["o9cq803zPvc..."]

sessionScope

user

single

"user"

cwd

"/Users/name/project"

instructions

model

"qwen3.5-plus"

Common Management Commands

# View currently configured channels
qwen channel --help

# Start WeChat channel
qwen channel start my-weixin

# Check WeChat account status
qwen channel configure-weixin status

# Clear WeChat credentials (use when re-logging in)
qwen channel configure-weixin clear

# Stop the channel (Ctrl+C or kill process)
kill <PID>

Troubleshooting

Issue 1: Failed to Connect After Scanning QR Code

• Timeout due to network issues
• iLink API is temporarily unavailable

# Re-run the configuration command
qwen channel configure-weixin

Issue 2: No Response When Sending Messages

• Is the channel service running (

  ps aux | grep "channel start"

  )
• Is your WeChat user ID in

  allowedUsers

• Is the

  settings.json

  format correct (JSON syntax)

# View detailed logs
DEBUG=1 qwen channel start my-weixin

Issue 3: Want to Switch WeChat Accounts

# Clear old credentials
qwen channel configure-weixin clear

# Re-scan QR code to log in
qwen channel configure-weixin

Advanced Usage

Multi-User Support

allowedUsers

{
  "channels": {
    "my-weixin": {
      "type": "weixin",
      "senderPolicy": "allowlist",
      "allowedUsers": ["user1@im.wechat", "user2@im.wechat", "user3@im.wechat"]
    }
  }
}

Open Mode (Available to Anyone)

{
  "channels": {
    "my-weixin": {
      "type": "weixin",
      "senderPolicy": "open"
    }
  }
}

Customize AI Behavior

instructions

{
  "instructions": "You are a professional code review assistant. Answers should be concise and professional, prioritizing solutions followed by explanations."
}

Security Notes

1. Protect account.json: This file contains your WeChat authentication token, and its permissions are set to

   600

   (only the owner can read and write)
2. Do not share tokens: Never share the content of

   account.json

   with others
3. Regularly clean up: When not in use for a long time, run

   configure-weixin clear

   to clear credentials

Next Steps

• Read the full documentation: See

  docs/users/features/channels/overview.md

• Learn about Telegram channel: See

  docs/users/features/channels/telegram.md

• Explore more features: Run

  qwen --help