メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.22latest
1.x>=2026.1.0 <2026.3.22legacy
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

​
関連ドキュメント