weixin-channel-setup

WeChat チャンネル設定アシスタント

このスキルは、Qwen Code の WeChat チャンネル機能をすばやく設定し、AI アシスタントが WeChat を通じてユーザーとやり取りできるようにします。

クイックスタート（3 ステップで完了）

ステップ 1：QR コードをスキャンして WeChat にログインする

次のコマンドを実行して、WeChat のログインフローを開始します。

qwen channel configure-weixin

操作手順：

1. ターミナルに QR コードの URL が表示されます
2. URL を開いて QR コードを表示します
3. WeChat で QR コードをスキャンし、ログインを確認します
4. "Connected to WeChat successfully!" と表示されるまで待ちます

保存される情報：

• Token と BaseURL は ~/.qwen/channels/weixin/account.json に自動的に保存されます
• WeChat ID は自動的に記録され、以降の設定で使用します

ステップ 2：設定ファイルに追加する

~/.qwen/settings.json を編集し、channels の設定を追加または更新します。

{
  "channels": {
    "my-weixin": {
      "type": "weixin",
      "senderPolicy": "allowlist",
      "allowedUsers": ["YOUR_WEIXIN_USER_ID"],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "你是一个简洁的编程助手，通过微信回复。保持回答简短。",
      "model": "qwen3.5-plus"
    }
  }
}

WeChat ID の取得方法：

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

出力の userId の値を、設定ファイルの allowedUsers 配列に置き換えます。

ステップ 3：チャンネルサービスを起動する

qwen channel start my-weixin

"[Channel] "my-weixin" is running. Press Ctrl+C to stop." と表示されれば成功です！

WeChat を開き、ボットアシスタントを見つけて、メッセージを送信してテストしましょう。

---

設定オプションの説明

オプション	必須	説明	例
type	✅	チャンネルの種類。"weixin" に固定されています	"weixin"
senderPolicy	❌	アクセスポリシー：allowlist（許可リスト）、open（公開）、pairing（ペアリング）	"allowlist"
allowedUsers	推奨	利用を許可する WeChat ユーザー ID の一覧	["o9cq803zPvc..."]
sessionScope	❌	セッション範囲：user（ユーザーごとに独立）、single（全体で共有）	"user"
cwd	推奨	AI の作業ディレクトリ	"/Users/name/project"
instructions	❌	AI の動作スタイルを制御するシステム指示	"回答は簡潔に保つ"
model	❌	使用するモデル	"qwen3.5-plus"

---

よく使う管理コマンド

# 查看当前配置的通道
qwen channel --help

# 启动微信通道
qwen channel start my-weixin

# 查看微信账号状态
qwen channel configure-weixin status

# 清除微信凭证（重新登录时使用）
qwen channel configure-weixin clear

# 停止通道（Ctrl+C 或 kill 进程）
kill <PID>

---

トラブルシューティング

問題 1：QR コードをスキャンした後に接続できない

考えられる原因：

• ネットワークの問題によるタイムアウト
• iLink API が一時的に利用できない

解決方法：

# 重新运行配置命令
qwen channel configure-weixin

問題 2：メッセージを送信しても応答がない

確認項目：

• チャンネルサービスが実行中か（ps aux | grep "channel start"）
• WeChat ID が allowedUsers に含まれているか
• settings.json の形式が正しいか（JSON 構文）

デバッグ方法：

# 查看详细日志
DEBUG=1 qwen channel start my-weixin

問題 3：WeChat アカウントを変更したい

# 清除旧凭证
qwen channel configure-weixin clear

# 重新扫码登录
qwen channel configure-weixin

---

高度な使い方

複数ユーザーへの対応

allowedUsers に複数の WeChat ユーザーを追加します。

{
  "channels": {
    "my-weixin": {
      "type": "weixin",
      "senderPolicy": "allowlist",
      "allowedUsers": ["[email protected]", "[email protected]", "[email protected]"]
    }
  }
}

オープンモード（誰でも利用可能）

⚠️ 警告：このモードでは誰でもボットを利用できます。有効にする際はご注意ください！

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

AI の動作をカスタマイズする

instructions フィールドを使って、AI のスタイルを定義します。

{
  "instructions": "你是一个专业的代码审查助手。回答要简洁专业，优先给出解决方案，然后解释原因。"
}

---

セキュリティに関する注意事項

1. account.json を保護する：このファイルには WeChat 認証用の token が含まれています。権限は 600（所有者のみ読み書き可能）に設定されています
2. token を共有しない：account.json の内容を他人と共有しないでください
3. 定期的にクリーンアップする：長期間使用しない場合は、configure-weixin clear を実行して認証情報を削除します

---

次のステップ

• 全ドキュメントを読む：docs/users/features/channels/overview.md を参照してください
• Telegram チャンネルについて確認する：docs/users/features/channels/telegram.md を参照してください
• その他の機能を確認する：qwen --help を実行してください