2026年 テンセント WeChat ClawBot OpenClaw 導入：ワンクリック install、バージョン互換と Mac VPS 回避 Runbook（意思決定表と FAQ）
2026 年、テンセントは個人 WeChat で公式 ClawBot プラグインをグレー配信開始しました。日常 IM を OpenClaw Gateway に接続でき、企業 WeChat や非公式ブリッジを経由する必要がなくなります。ただし「OpenClaw 本体を先に通してから QR スキャン」の順序、openclaw-weixin 2.0.x と 1.0.x の互換表、単聊のみ・24 時間インタラクション窓などのハード制限により、npm 一発では済みません。本稿は Mac/Linux で Gateway を通過済み、WeChat が ClawBot グレー対象（iOS 8.0.70+ / Android 8.0.69+）の開発者向けに、意思決定表、グレー自己診断、Mac VPS 前提、七步 Runbook、バージョンと制限対照、層別排障、FAQ を示し、Apple Silicon Mac クラウド上で監査可能な 7×24 デプロイを目指します。
目次
1. 意思決定表：個人 WeChat ClawBot vs 企業 WeChat/Feishu vs Telegram
チームが既に企業 WeChat でワークフローを固めているなら、企業向けコネクタが第一候補です。ClawBot の価値は「個人 WeChat の習慣 + 公式プラグイン」にあり、開発者自用アシスタントや小規模非公式協業向きで、コンプライアンス重視のグループ Bot には向きません。
| 観点 | 個人 WeChat ClawBot | 企業 WeChat / Feishu | Telegram / Discord |
|---|---|---|---|
| 入口習慣 | 個人 WeChat 日常会話 | 企業協業・承認 | 海外・技術コミュニティ |
| グループ | 非対応（単聊のみ） | @bot 対応 | mention 対応 |
| コンプライアンス | コンテンツはテンセントサーバー経由 | 企業域・監査 | 自前 Bot API |
| 7×24 常駐 | Mac VPS + launchd | 同左 | 同左；マルチチャネル Runbook参照 |
2. グレー自己診断：ClawBot 入口とバージョン閾値
デプロイ前にスマホ WeChat で 設定 → プラグイン → ClawBot 入口を確認してください。iOS は 8.0.70 以上、Android は 8.0.69 からグレー中です。入口が無い場合は VPS 側でプラグインを繰り返し入れ替えても解決しません。実験的 Agent が本番フローを壊さないようサブアカウントでの連携を推奨します。グレー通過後に Mac VPS で OpenClaw 本体スモークを完了してから QR を読み取ってください。Gateway 未準備時の QR は期限切れや online 表示のまま無応答になりがちです。
- ClawBot 入口なし：App バージョン確認。非グレーアカウントは待機のみ。
- 入口あり未連携：先に VPS 側 Gateway と Provider 検収。
- 他 OpenClaw に既連携：一 WeChat 番号一連携制約。解除後に新 QR。
3. Mac VPS 前提：Node 22、18789、同一アカウント HOME
openclaw-weixin は Gateway プラグインであり、独立 Bot プロセスではありません。半インストール状態で npx だけ実行すると QR は出ても再起動後 session が消える典型が出ます。前提チェックは以下の通り。初回 5 ステップとゲートウェイ Runbookも併読してください。
- ランタイム：Node.js 22+。
openclaw --versionとopenclaw doctorで半インストール警告なし。 - Gateway：
lsof -i :18789またはopenclaw gateway statusで待受確認。 - LLM Provider：少なくとも 1 ルート利用可能。無いとチャネル online でも返信なし。
- アカウント整合：launchd plist の
UserNameと CLI が同一 macOS ユーザ、HOME一致。 - 権限監査：プラグインディレクトリ最小権限。ClawHub 監査を先行。
openclaw gateway status
openclaw --version
echo "USER=$USER HOME=$HOME"
4. 七步 Runbook：本体 → CLI install → QR → 検収
推奨順序は「本体スモーク → 公式 CLI → QR → 再起動 → 単聊検収 → launchd 常駐再検証」に固定。CLI は OpenClaw バージョンに応じて dist-tag を自動選択します。CLI 失敗時のみ手動パスを使います。
- 本体スモーク：doctor 通過、18789 待受、最小 Agent 会話可能。
- ワンクリック CLI install：下記コマンド。プラグインディレクトリと openclaw.json 差分を確認。
- 手動代替：
openclaw plugins install @tencent-weixin/openclaw-weixin、続けてopenclaw channels login weixin。 - QR 連携：端末 QR 表示後、スマホ ClawBot 内でスキャン。タイムアウト時は restart 後再試行。
- Gateway 再起動：
openclaw gateway restart、openclaw gateway statusで weixin online。 - 単聊検収：ClawBot へプレーンテキスト送信、Agent 返信と JSONL
toolCallIdを確認。 - 7×24 再検証：launchctl 再読み込みまたはノード再起動後に手順 6 を再実行。
# 手動代替
openclaw plugins install @tencent-weixin/openclaw-weixin
openclaw channels login weixin
openclaw gateway restart
openclaw gateway status
5. バージョン互換表と ClawBot ハード制限
バージョン不一致時プラグインは読み込み拒否し、ログに semver や peer dependency 警告が出ます。OpenClaw アップグレード後は5月バージョン列車 Runbookで検収し、必要なら CLI install を再実行してください。
| openclaw-weixin | OpenClaw 要件 | 備考 |
|---|---|---|
| 2.0.x | ≥ 2026.3.22 | 現行推奨。CLI デフォルト dist-tag |
| 1.0.x legacy | 旧 OpenClaw | 既存互換のみ。新規は固定しない |
| 制限 | 説明 | 運用提案 |
|---|---|---|
| 単聊のみ | グループ @bot 非対応 | グループは企業 WeChat や Telegram |
| テキスト中心 | リッチメディア混在なし | 長文分割または他チャネル |
| 24h 窓 | 非インタラクティブな能動送信は破棄されうる | 定期 ping や cron で会話維持 |
| 一アカウント一連携 | 同一 WeChat を複数 Gateway に不可 | 解除後に新 QR |
| データ経路 | テンセントサーバー中継 | 機密資格情報を送らない。作業ディレクトリ最小権限 |
6. 層別排障：QR なし、バージョン拒否、online 無応答
「WeChat が通らない」は層で切り分け：プロトコル/QR → プラグインバージョン → Gateway 18789 → Provider/ルーティング → 単聊ポリシー。各層で JSONL と openclaw gateway status --deep を揃え、再起動だけに頼らないでください。
| 症状 | 根因 | 修復 |
|---|---|---|
| QR なし / プロトコル設定失敗 | Gateway 未準備または HOME 分裂 | doctor + 同一ユーザ CLI。ゲートウェイ Runbook 参照 |
| プラグイン読み込み拒否 | openclaw-weixin と OpenClaw 不一致 | ≥2026.3.22 へアップグレードまたは CLI 再 install |
| QR 後切断 | ローカルスリープまたは launchd ユーザ不一致 | Mac VPS 常駐 + plist UserName 整合 |
| online 無応答 / 受信のみ | Provider 制限または session ルーティング誤り | モデルルート確認。マルチチャネル時は Runbook 参照 |
7. FAQ
質問：ClawBot は Telegram などと並行できますか？ 可能です。チャネルごとに session 名前空間を分け、マルチチャネル Runbook で最小会話検収を行ってください。
質問：なぜ Mac VPS がローカルより良いですか？ ノート PC スリープで長接続切断。Mac クラウドは launchd 常駐、固定 IP と HOME で 7×24 に向きます。
質問：海外ノードは使えますか？ WeChat アカウントとテンセント到達性に依存。本番は低遅延リージョンを推奨し切断率を監視。
質問：Android 全量はいつ？ テンセント公式告知に従ってください。現状 8.0.69 グレー中。入口が無ければ旧版プラグイン強制は避けてください。
8. まとめ
成功基準は OpenClaw 本体 → CLI install → QR → 18789 単聊再現 の連鎖です。ClawBot は個人 WeChat 入口向きで、企業 WeChat コンプライアンス群聊の代替にはなりません。互換表と 24h 窓は変更票に明記してください。WeChat と他 IM・Skill を並行常駐させるなら、VPSMAC Apple Silicon Mac クラウドで Gateway、プラグインディレクトリ、launchd を一本の Runbook に収める方が安定します。ゲートウェイ Runbook、マルチチャネル検収、Skill 監査も参照してください。