Docs

WeChat Bot

QR コードをスキャンして、iLink 経由で WeChat アカウントを Multica エージェントに接続します。

Multica は Tencent の OpenClaw Weixin プラグイン が実装するプロトコルを使い、WeChat の iLink Bot サービスに接続します。WeCom とは別のチャネルです。OpenClaw のインストールやデスクトップ版 WeChat の自動操作ツールは必要ありません。

接続する

  1. 自分が所有するエージェントを開きます。ワークスペースの所有者または管理者は、ワークスペース内のどのエージェントにも接続できます。メッセージチャネルの メッセージチャネルを追加 から WeChat を選びます。QR コードがすぐに表示されます。
  2. 自分の WeChat アカウント で QR コードをスキャンし、スマートフォンで承認します。WeChat が確認コードを求めた場合は、スマートフォンに表示された数字をダイアログに入力します。接続が完了するとダイアログが閉じ、エージェントのメッセージチャネルに WeChat が表示されます。
  3. WeChat で Bot に新しい DM を送ります。エージェントが作業を実行するには、オンラインのランタイムが必要です。

スキャンしたアカウントは、このダイアログを開いた Multica ユーザーに紐づきます。メッセージはそのユーザーのワークスペース権限で実行されます。QR コードを共有したり、他の人にスキャンを頼んだりしないでください。他の WeChat アカウントやグループからのメッセージは受け付けません。

ログインの有効期間は最大 5 分です。WeChat がそれより早くコードを失効させる場合もあります。期限が切れたら新しい QR コードを生成してください。ダイアログを閉じると、承認待ちのログインはキャンセルされます。他のエージェントやワークスペースに接続済みの Bot は、先に元の接続を解除する必要があります。アカウントの利用資格は WeChat が判断し、接続の拒否や追加確認が行われる場合があります。

エージェントの設定に表示された WeChat の QR ログイン

この画像の QR コードはテスト用で、実際の認証には使えません。

メッセージとコマンド

  • テキストメッセージは同じ Multica チャットを継続します。最終回答はプレーンテキストで WeChat に返され、長い回答は Unicode 文字を壊さずに分割されます。ストリーミングによるメッセージ編集はありません。
  • エージェントの実行中は、利用可能な場合に WeChat の入力中表示を更新します。完了、失敗、キャンセル後は停止します。更新に失敗した場合は、次の 5 秒間隔で再試行します。入力中表示の権限やリクエストに問題があっても、メッセージや返信は中断しません。
  • /new [メッセージ] は新しい Multica チャットを開始します。/clear [メッセージ] は現在のチャットのエージェント向けコンテキストをリセットします。/issue <タイトル> は接続先のエージェントに割り当てるタスクを作成します。
  • オブジェクトストレージが設定されていれば、受信した画像、ファイル、動画、文字起こしのない音声メモを Multica チャットに添付します。WeChat が提供する音声の文字起こしはテキストとして使います。Multica 独自の音声認識サービスや SILK 音声の変換は行いません。
  • エージェントの最終回答に添付されたファイルは WeChat に返されます。対応画像と MP4 動画はネイティブのメディアメッセージ、それ以外の形式と音声はファイルメッセージで送信します。このアダプターの転送上限は 1 ファイル 20 MiB です。送信に失敗した場合は通知を返し、ファイルは Multica に残ります。
  • グループチャット、連絡先へのアクセス、能動的な通知、転送メッセージの展開、引用メッセージの履歴取得には対応していません。

返信には、WeChat がその会話に発行したコンテキスト認証情報が必要です。有効期限切れで返信が拒否された場合は、新しいメッセージを送ってください。Multica は有効期間を固定値として扱いません。API の成功応答はプロバイダーによる受理を示すもので、配信や既読を保証しません。送信結果の応答が失われた場合は結果不明として記録し、自動再送は行いません。

負荷が高い場合、WeChat への返信通知が省略されることがあります。回答は Multica のチャットで確認できます。

接続を解除する

エージェントのメッセージチャネルで WeChat を管理 → 接続を解除 を選びます。新しいメッセージはエージェントに届かなくなり、保存された返信用コンテキストも削除されます。Multica のチャット履歴は残ります。iLink が明示的に認証期限切れを返した場合も接続を無効化し、期限切れの通知を表示します。新しい QR コードをスキャンして再接続してください。同じエージェントへの既存接続を再認証した場合は、チャットと受信カーソルを保持します。同じワークスペースの別のエージェントに接続済みの場合、そのエージェントを管理できる場合はダイアログにエージェント名が表示されるので、先にそこで接続を解除してください。他のワークスペースのエージェント情報は表示されません。

ワークスペースのメッセージ設定に表示された接続済み WeChat アカウント

セルフホスト

永続的に保存する暗号化キーを生成します。

openssl rand -base64 32

API サーバーの MULTICA_WEIXIN_SECRET_KEY に設定し、サーバーを再起動します。全レプリカで同じキーを使い、デプロイのシークレットやバックアップとともに保管してください。キーを変更すると既存の認証情報を復号できなくなり、Bot の再接続が必要になります。未設定の場合、接続操作は無効です。Docker Compose はこの変数を引き継ぎます。

API サーバーから ilinkai.weixin.qq.com、WeChat が返す *.weixin.qq.com の地域別ホスト、novac2c.cdn.weixin.qq.com への HTTPS アクセスが必要です。公開 webhook や受信用トンネルは不要です。ブラウザーに渡されるのは QR コードの表示内容と状態だけで、Bot の認証情報と返信用コンテキストはサーバー上で暗号化して保存します。

通常のデータベースマイグレーションを適用してください。共通のチャネル管理機構がレプリカ間で各接続のロングポーリングを 1 本に保ち、共通の受信エンジンがバッチを受理した後に更新カーソルを保存します。最終回答はデータベースの配信リースで重複送信を防ぎます。送信待ちイベントはメモリ内にあるため、サーバー再起動で返信が中断する場合があります。送信結果が不明な場合は再送しません。回答と添付ファイルは Multica に残ります。

プロトコルの参照元は Tencent @tencent-weixin/openclaw-weixin 2.4.10、ソースコミット 874637a とそのプロトコル文書です。このアダプターは Go によるネイティブ実装で、実行時にそのパッケージを必要としません。プロバイダーの動作やアカウントの利用資格は Multica のリリースとは独立して変わる場合があります。

このページの内容