WeChat

OpenClaw は、Tencent の外部チャンネル Plugin @tencent-weixin/openclaw-weixin を通じて 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 が担当します。

インストール

簡単なインストール方法:

npx -y @tencent-weixin/openclaw-weixin-cli install

手動インストール:

openclaw plugins install "@tencent-weixin/openclaw-weixin"openclaw config set plugins.entries.openclaw-weixin.enabled true

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

openclaw gateway restart

ログイン

Gateway を実行しているものと同じマシンで QR ログインを実行します。

openclaw channels login --channel openclaw-weixin

スマートフォンの WeChat で QR コードをスキャンし、ログインを確認します。スキャンが成功すると、 Plugin がアカウントトークンをローカルに保存します。

別の WeChat アカウントを追加するには、同じログインコマンドを再度実行します。複数の アカウントを使用する場合は、アカウント、チャンネル、送信者ごとにダイレクトメッセージのセッションを分離します。

openclaw config set session.dmScope per-account-channel-peer

アクセス制御

ダイレクトメッセージでは、チャンネル Plugin 向けの通常の OpenClaw ペアリングおよび許可リストモデルを 使用します。

新しい送信者を承認します。

openclaw pairing list openclaw-weixinopenclaw pairing approve openclaw-weixin <CODE>

アクセス制御モデルの詳細については、ペアリングを参照してください。

互換性

Plugin は起動時にホスト側の OpenClaw バージョンを確認します。

OpenClaw のバージョンが古すぎると Plugin から報告された場合は、OpenClaw を更新するか、 旧 Plugin 系列をインストールしてください。

openclaw plugins install @tencent-weixin/openclaw-weixin@legacy

サイドカープロセス

WeChat Plugin は Tencent iLink API を監視しながら、Gateway の傍らで補助処理を 実行できます。issue #68451 では、この補助処理のパスによって OpenClaw の 汎用的な古い Gateway クリーンアップ処理のバグが明らかになりました。子プロセスが親の Gateway プロセスをクリーンアップしようとする可能性があり、systemd などのプロセスマネージャー下で 再起動ループが発生していました。

現在の OpenClaw の起動時クリーンアップでは、現在のプロセスとその祖先プロセスが除外されるため、 チャンネル補助プロセスが自身を起動した Gateway を終了させることはありません。この修正は 汎用的なものであり、コア内の WeChat 固有の処理ではありません。

トラブルシューティング

インストールとステータスを確認します。

openclaw plugins listopenclaw channels status --probeopenclaw --version

チャンネルがインストール済みと表示されても接続されない場合は、Plugin が 有効になっていることを確認し、再起動します。

openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw gateway restart

WeChat を有効にした後に Gateway が繰り返し再起動する場合は、OpenClaw と Plugin の両方を更新します。

npm view @tencent-weixin/openclaw-weixin versionopenclaw plugins install "@tencent-weixin/openclaw-weixin" --forceopenclaw gateway restart

起動時に、インストール済みの Plugin パッケージについて requires compiled runtime output for TypeScript entry と報告される場合、OpenClaw が必要とするコンパイル済み JavaScript ランタイムファイルを含めずに npm パッケージが公開されています。Plugin の 公開元が修正版パッケージをリリースした後で更新または再インストールするか、Plugin を一時的に 無効化またはアンインストールしてください。

一時的に無効化する場合:

openclaw config set plugins.entries.openclaw-weixin.enabled falseopenclaw gateway restart

関連ドキュメント

• チャンネルの概要: チャットチャンネル
• ペアリング: ペアリング
• チャンネルルーティング: チャンネルルーティング
• Plugin アーキテクチャ: Plugin アーキテクチャ
• チャンネル Plugin SDK: チャンネル Plugin SDK
• 外部パッケージ: @tencent-weixin/openclaw-weixin