2026年テンセント WeChat ClawBot 導入と注意事項：ワンクリック CLI、バージョン互換マトリクスと安全境界 Runbook

WeChat 接続前に多い六つの落とし穴（QR スキャン前に整理）

1. Gateway 未常駐のまま QR スキャン：ノート PC を閉じるとチャネルが落ち、「WeChat プラグインが壊れた」と誤認しやすくなります。
2. 宿主とプラグインのバージョン不一致：OpenClaw が 2026.3.22+ なのに 1.0.x 系プラグインのままだと、起動時に互換エラーが出ます。
3. 本番 Agent にメイン WeChat アカウントを接続：内容はテンセント側インフラを経由するため、敏感語やアカウントリスクは自チームで制御できません。
4. 作業ディレクトリを広げすぎる：WeChat で「デスクトップを整理して」と一言されると、ユーザーホーム全体に触れる可能性があります。
5. グループチャットを前提に設計：現行能力は1対1中心で、グループ @ や複数人ファイル戦略は別物です。
6. メッセージは届くがツールが動かない：根因はしばしば tools.profile にあり、WeChat チャネル自体ではありません。ツール未実行トリアージ Runbookを参照してください。

テンセントは GitHub で openclaw-weixin プラグインを保守し、npm で @tencent-weixin/openclaw-weixin-cli を配布しています（2026年5月時点でも更新が続いています）。インストーラは openclaw --version を読み、互換マトリクスに従って latest（2.0.x）または legacy（1.0.x）の dist-tag を選び、openclaw plugins install と QR ログインまで進めます。バージョンを手で当てるより、再現可能な運用に近いです。

実務では、WeChat を「もう一つのチャット UI」とだけ見て、Gateway の電源ポリシーやバックアップ方針を書かないチームが多く見られます。夜間に QR だけ成功しても、朝にはチャネルだけ赤のまま残り、プラグイン再インストールを繰り返して変更履歴が汚れるパターンがあります。本稿の六モジュールは、その試行錯誤を手順・表・指標に落とすためのものです。

前提チェックリスト：Gateway、WeChat クライアント、ネットワーク

CLI を実行する前に、次を順に確認することをおすすめします。

• OpenClaw Gateway が起動済みで openclaw gateway status が健全であること。リモート配置では権威 Gateway プロセスが一つだけであること。
• Node 基線：他の 2026 Runbook と同様、Node 24 を推奨します。低すぎると CLI と Gateway の分裂を招きやすくなります。
• WeChat クライアント：iOS 8.0.70+、Android 8.0.69+（テンセント文書・コミュニティ手順に合わせ、QR 前に更新）。
• アウトバウンド：Gateway ホストから npm とテンセント側ハンドシェイク先へ到達できること。社内プロキシは事前に環境変数へ。
• 変更窓：openclaw update を控えるなら、先に backup create（アップグレード護航記事）。

本番で WeChat を使うチームは、変更チケットに「QR 実施者」「使用アカウント種別（メイン/専用小号）」「作業ディレクトリ上限」を書いておくと、後から監査しやすくなります。個人実験と本番 SLA では、同じコマンド列でも受け入れ基準が異なるためです。

ワンクリック導入：openclaw-weixin-cli

openclaw CLI が入っているマシンで実行します（Gateway と同機でも、SSH で入ったリモート Mac でも構いません）。

QR 成功後は、ファイル転送または専用小号へ探針メッセージを送り、Gateway ログにインバウンドイベントが出るか確認してください。Control UI に「WeChat」チャネルが見えない場合は、コンソール更新とブラウザ強制再読み込み（Windows: Ctrl+F5、macOS: Cmd+Shift+R）がコミュニティでは有効なことが多いです。

手動導入（CI / 非対話環境）

npx ウィザードで QR を出せない（TTY なし、純 SSH）場合は、次の四手順に切り替えます。

注意事項：製品境界・コンプライアンス・権限（必読）

次の制限はテンセント Public Beta 説明とコミュニティ実測の要約です。チーム Runbook に書き、事後ではなく事前に共有してください。

• 1対1中心：WeChat グループ bot で企業 WeChat アプリを代替する設計は避けてください。
• ファイルは受信のみが安定：ユーザー送信ファイルの分析は可能でも、大容量を会話へ「返送」する用途は期待しないでください。
• 24時間インタラクション窓：長期未対話後の能動プッシュは破棄され得ます。一問一答向きで、無人マーケ推送向きではありません。
• 一アカウント一インスタンス：一つの WeChat ID は通常一つのロブスター实例に紐づきます。一 Gateway に複数ログイン ID は可能です。
• 内容とコンプライアンス：メッセージはテンセントインフラを経由します。金融・暗号資産などの敏感語はフィルタされ得ます。利用規約は調整・終了の権利を留保します。
• 作業ディレクトリ最小権限：AGENTS.md とツール方針で書き込み可能パスを限定し、WeChat 起点のツールチェーンに $HOME 全体を渡さないでください。

六手順「プラグイン導入—QR—受け入れ—硬化」Runbook と KPI

1. バージョン指紋の固定：openclaw --version、プラグイン版、Gateway 形態（ローカル / Docker / リモート Mac）を記録。
2. バックアップ：本番は先に openclaw backup create。QR 状態とペアリング喪失時の復帰点を残します。
3. プラグイン導入：まず openclaw-weixin-cli install。失敗時のみ手動 plugins install。
4. QR と探針：専用小号 → ファイル転送へテスト文 → Gateway ログでインバウンド確認。
5. 権限硬化：ツールディレクトリを狭め、tools.profile がチーム方針の coding / full か確認。
6. 7×24 の載せ先：Gateway を常電ホストへ。ノートは SSH で Control UI のみ（SSH 常駐 Runbook）。

変更チケットに載せる定量例：チャネル可用率（常電 Gateway 前提で 7 日インバウンド成功率 ≥99% 目安）、プラグイン不一致回数（OpenClaw 更新後に互換インストーラ未実行＝0 目標）、メインアカウント接続比率（0 目標）。

WeChat は入口にすぎず、安定した宿主こそ土台です。個人ノートで QR だけ成功し、蓋を閉じると SLA は監査できません。7×24 の 1対1 接続・チケット化変更・明確なディレクトリ境界が必要なら、MACCOME 六地域専用リモート Mac（M4 / M4 Pro）に OpenClaw + openclaw-weixin を固定する方が、睡眠ノートとの QR/probe 争いより総コストで有利なことが多いです。公開プランは多地域ノードガイド、接続はヘルプセンターとレンタル料金をご参照ください。