Skip to main content
OpenClaw は、Tencent の外部 @tencent-weixin/openclaw-weixin チャンネル Plugin を介して WeChat に接続します。 ステータス: Tencent Weixin チームが保守する外部 Plugin。ダイレクトチャットと メディアがサポートされています。グループチャットは Plugin のケイパビリティ メタデータでは公開されていません（ダイレクトチャットのみを宣言しています）。

​
名前

  • WeChat は、このドキュメントでユーザー向けに使用する名前です。
  • Weixin は、Tencent のパッケージと Plugin ID で使用される名前です。
  • openclaw-weixin は OpenClaw のチャンネル ID です（weixin と wechat はエイリアスとして機能します）。
  • @tencent-weixin/openclaw-weixin は npm パッケージです。
CLI コマンドと設定パスでは openclaw-weixin を使用してください。

​
動作の仕組み

WeChat のコードは OpenClaw のコアリポジトリには含まれていません。OpenClaw は 汎用チャンネル Plugin コントラクトを提供し、外部 Plugin が WeChat 固有のランタイムを提供します。
  1. openclaw plugins install は @tencent-weixin/openclaw-weixin をインストールします。
  2. Gateway は Plugin マニフェストを検出し、Plugin のエントリポイントを読み込みます。
  3. Plugin はチャンネル ID openclaw-weixin を登録します。
  4. openclaw channels login --channel openclaw-weixin は QR ログインを開始します。
  5. Plugin は OpenClaw の状態ディレクトリ （デフォルトでは ~/.openclaw）にアカウント認証情報を保存します。
  6. Gateway が起動すると、Plugin は設定された各アカウントの Weixin モニターを開始します。
  7. 受信した WeChat メッセージはチャンネルコントラクトを通じて正規化され、 選択された OpenClaw エージェントにルーティングされ、Plugin の送信パスを通じて返信されます。
この分離は重要です。OpenClaw コアはチャンネル非依存のまま維持されます。WeChat ログイン、 Tencent iLink API 呼び出し、メディアのアップロード／ダウンロード、コンテキストトークン、 アカウント監視は外部 Plugin が担当します。

​
インストール

クイックインストール:
手動インストール:
インストール後に Gateway を再起動します。

​
ログイン

Gateway を実行している同じマシンで QR ログインを実行します。
スマートフォンの WeChat で QR コードをスキャンし、ログインを確認します。スキャンが 成功すると、Plugin はアカウントトークンをローカルに保存します。 別の WeChat アカウントを追加するには、同じログインコマンドをもう一度実行します。複数の アカウントでは、アカウント、チャンネル、送信者ごとにダイレクトメッセージセッションを分離します。

​
アクセス制御

ダイレクトメッセージでは、チャンネル Plugin 向けの通常の OpenClaw ペアリングおよび 許可リストモデルを使用します。 新しい送信者を承認します。
アクセス制御モデルの詳細については、ペアリングを参照してください。

​
互換性

Plugin は起動時にホストの OpenClaw バージョンを確認します。 Plugin が OpenClaw のバージョンが古すぎると報告した場合は、OpenClaw を更新するか、 レガシー Plugin 系列をインストールします。

​
サイドカープロセス

WeChat Plugin は Tencent iLink API を監視しながら、Gateway と並行して 補助処理を実行できます。issue #68451 では、この補助処理のパスによって OpenClaw の 汎用的な古い Gateway クリーンアップにあるバグが顕在化しました。子プロセスが親の Gateway プロセスをクリーンアップしようとする可能性があり、systemd などのプロセスマネージャー下で 再起動ループが発生していました。 現在の OpenClaw の起動時クリーンアップでは、現在のプロセスとその祖先を除外するため、 チャンネルの補助プロセスが、それを起動した Gateway を終了させることはありません。この修正は 汎用的なものであり、コア内の WeChat 固有のパスではありません。

​
トラブルシューティング

インストールとステータスを確認します。
チャンネルがインストール済みと表示されるものの接続されない場合は、Plugin が 有効になっていることを確認して再起動します。
WeChat を有効にした後に Gateway が繰り返し再起動する場合は、OpenClaw と Plugin の両方を更新します。
起動時に、インストール済みの Plugin パッケージが requires compiled runtime output for TypeScript entry と報告される場合、npm パッケージは OpenClaw に必要なコンパイル済み JavaScript ランタイムファイルを含めずに公開されています。Plugin の公開者が修正版パッケージを リリースした後に更新／再インストールするか、Plugin を一時的に無効化／アンインストールしてください。 一時的に無効化する場合:

​
関連ドキュメント