English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Regional platforms

WeChat

OpenClawは、Tencentの外部@tencent-weixin/openclaw-weixinチャネルPluginを通じてWeChatに接続します。

ステータス: 外部Plugin。ダイレクトチャットとメディアがサポートされています。グループチャットは、現在のPlugin機能メタデータでは提示されていません。

命名

  • WeChat は、このドキュメントでのユーザー向け名称です。
  • Weixin は、TencentのパッケージとPlugin IDで使われる名称です。
  • openclaw-weixin はOpenClawのチャネルIDです。
  • @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がチャネルIDopenclaw-weixinを登録します。
  4. openclaw channels login --channel openclaw-weixin がQRログインを開始します。
  5. Pluginがアカウント認証情報を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-weixin
openclaw pairing approve openclaw-weixin <CODE>

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

互換性

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

Plugin系統 OpenClawバージョン npmタグ
2.x >=2026.3.22 latest
1.x >=2026.1.0 <2026.3.22 legacy

PluginがOpenClawのバージョンが古すぎると報告する場合は、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 list
openclaw channels status --probe
openclaw --version

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

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

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

npm view @tencent-weixin/openclaw-weixin version
openclaw plugins install "@tencent-weixin/openclaw-weixin" --force
openclaw gateway restart

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

一時的な無効化:

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

関連ドキュメント