WeChat OpenILink 設定チュートリアル

本文では、WeChat OpenILink アダプターの設定方法と、Nekro Agent を WeChat に接続する手順を説明します。このアダプターは wechatbot-sdk ベースで、QR コードログインによる認証を行います。

実験的機能およびリスクに関する注意

• WeChat OpenILink は現在 MVP（最小限の動作可能）段階にあり、テキスト受信、テキスト/画像/ファイル送信が主な機能です。グループチャットには対応していません。

開始前の準備

• Nekro Agent のデプロイが完了しており、WebUI を開けること
• Bot とチャットしたい WeChat アカウント

ステップ1：Nekro Agent でアダプターを有効化

1. Nekro Agent の WebUI を開く
2. 「アダプター」->「WeChat OpenILink」に入る
3. アダプターを有効化 スイッチをオンにする
4. 設定を保存

ステップ2：Nekro Agent を再起動して QR コードログインを完了

1. Nekro Agent コンテナを再起動し、アダプターの初期化を開始させる
2. 「アダプター」->「WeChat OpenILink」->「ログイン」に入る
3. Bot とチャットしたい WeChat アカウントで QR コードをスキャンしてログイン

ログインタイムアウト

デフォルトのログインタイムアウトは 180 秒です。この時間内に QR コードのスキャンを完了しない場合、アダプターの初期化が失敗してエラーが発生します。フローを再トリガーするには、Nekro Agent を再起動してください。

ステップ3：接続成功を確認

1. WeChat が自動的に開いたウィンドウにメッセージを送信
2. Nekro Agent が正常に応答すれば、接続成功です

グループチャットは現在利用できません

このアダプターは現在プライベートチャットのみでトリガーされ、グループチャットへの追加はできません。

よくある質問

起動後にログインページの QR コード生成が失敗する

• アダプターが有効化され、設定が保存されていることを確認
• Nekro Agent が完全に再起動されていることを確認（設定の保存だけではアダプターの再初期化はトリガーされません）
• ログにネットワークエラーがないか確認し、サーバーが BASE_URL にアクセスできることを確認

QR コードスキャン後にメッセージを受信しない

以下の順序で切り分けてください：

1. Nekro Agent メインサービスのログに wechat_openilink 関連のエラーがないか確認
2. モデルグループが正しく設定されているか確認（モデル管理 を参照）。設定されていない場合、メッセージを受信しても AI の応答は発生しません

次のステップ

• モデルがまだ？モデル管理 で少なくとも1つのチャットモデルグループを設定してください
• ロボットに個性を与えたい？ペルソナのコツ を参考にしてください
• WeChat アカウントを複数設定、または複数プラットフォームのアカウントがある？チャンネル管理 を参考にしてください