2026 WeChat ClawBot 公式プラグイン完全ガイド：
@tencent-weixin/openclaw-weixin-cli による OpenClaw 接続、バージョン要件と 1対1/審査/権限の落とし穴（日貸し macOS 隔離検証付き）
OpenClaw Gateway は動いているのに、個人 WeChat にアシスタントをつなぎたい——しかし第三者ブリッジや非公式プロトコルは避けたい、という要件に対し、Tencent が 2026 年に出した ClawBot 公式プラグイン は QR バインドの正規ルートを提供します。一方で 1対1限定・コンテンツ審査・サブアカウント運用・Gateway の常時到達 を軽視すると、「接続は成功するが返信がない」をモデル障害と誤認しがちです。本稿は開発者と自ホスト運用者向けに、三つの痛点、ClawBot と他 IM の決定マトリクス、七手順、分診表、三指標、1～3 日の日貸し macOS 日程を示します。関連：導入・デプロイガイド、Telegram／Discord チャネルペアリング、Microsoft Teams 接続、SSH/VNC FAQ。
目次
01. 三つの痛点：ClawBot を「もう一つの Telegram」とみなす、本番アカウントバインド、Gateway の断続オフライン
1）メンタルモデルのずれ：ClawBot は openclaw.json に Bot Token を書けば終わるチャネルではありません。WeChat クライアント公式プラグインと、ホスト上の @tencent-weixin/openclaw-weixin-cli が出す使い捨て QRによるアカウント単位バインドが前提です。Telegram/Discord の Allowlist・pairing の感覚で WeChat 側をいじると、夜通し「モデルルート」を疑うことになります。合格信号はQR 成功 + Gateway プロセスの持続到達 + 連絡先にアシスタント会話が現れることです。
2）本番 WeChat ID とコンプライアンス：メッセージは Tencent 基盤を経由し、コンテンツ安全ポリシーの対象になります。金融・暗号資産などの話題はフィルタされやすいです。日常のメインアカウントで ClawBot を縛ると、ポリシー変更やグレーアウト終了時に実社交グラフへ波及します。Runbook では検証専用サブアカウントを既定とし、OpenClaw の作業ディレクトリ・Skills・ファイルツールを最小権限サンドボックスに閉じるべきです（マルチプラットフォーム導入ガイドの隔離原則と同型）。
3）「Gateway は生きているが WeChat が無言」：ClawBot は OpenClaw を動かすホスト（またはトンネル後の同等エンドポイント）が長時間到達可能であることを要求します。ノート PC のスリープ、家庭用 NAT の漂移、Docker の restart 未設定は「たまに返るが夜は必ず死ぬ」に見えます。Teams の Dev Tunnel + webhook 3978 とは異なり、WeChat 側に「もう一度パブリック URL を足す」第二のチャンスはなく、バインドセッションと Gateway ハートビートが同寿命である点を Runbook に明記してください。
02. ClawBot vs Telegram/Discord：公式チャネル決定マトリクス
30 秒で「ClawBot か、成熟した IM チャネルか」を切り分ける表です。
| 観点 | WeChat ClawBot（公式） | Telegram / Discord | 日貸し macOS 証跡 |
|---|---|---|---|
| 接続方式 | WeChat「設定→機能→プラグイン」+ CLI QR | Bot Token / OAuth + channels.* |
QR 前後のターミナル stdout（マスク済） |
| 会話形態 | 1対1のみ（2026 公開説明時点でグループ非対応） | グループ・Topic・Allowlist 対応 | テスト用サブアカウントから 3 通プローブ |
| ファイル | 多くの説明で受信のみ・送信不可 | チャネルプラグイン依存 | 受入で「WeChat へ PDF 返送」に依存しない |
| アカウントリスク | 公式経路・審査・グレー方針の変更あり | プラットフォーム ToS + 自前 Allowlist | Runbook に「非メイン ID」と保持方針 |
| クライアント版 | iOS ≥ 8.0.70、Android ≥ 8.0.69（グレーは Tencent 基準） | WeChat 非依存 | バインド前に「WeChat について」画面を保存 |
グループ @ ボット・アウトバウンドファイル・テナント横断の企業 IMが必須なら、Teams や Telegram/Discord を優先し、ClawBot を万能チャネル扱いしないでください。
03. 七手順：Gateway 準備 → WeChat プラグイン → CLI QR → 初回メッセージ → doctor → 権限縮小 → 証跡
- OpenClaw ベースライン：導入ガイドで Gateway を起動し、
openclaw --version、読み込みopenclaw.json、gateway status、doctorを記録します。Node は 22.19+ またはドキュメント推奨の 24.x を推奨します。 - WeChat で ClawBot 有効化：バージョン要件を満たすよう更新 →「自分」→「設定」→「機能」→「プラグイン」→ ClawBot をオン。一覧に無い場合は版数確認と再起動を先に行い、未確認のまま QR を繰り返しません。
- 公式 CLI を Gateway ホストで実行：同一マシン（または SSH セッション）で install を実行し、数分以内に WeChat「スキャン」で確定します。
- バインドと初回受入：連絡先にアシスタントが現れたら短いプローブを送り、Gateway ログの inbound/outbound を時刻照合します。
- doctor とモデル認証：無返信時は Gateway 生存・API Key・WeChat 側フィルタの順で切り分け、いきなりチャネルルートを書き換えません。
- 権限とディレクトリ：Agent ワークスペースを専用パスに限定し、不要な
file_writeや高リスク Skills を止めます。ClawHub 技能は隔離環境で先に試します。 - 証跡と消去：CLI 出力・ログ・版画面をマスク保存し、日貸しホストではバインド解除・デモ鍵削除まで行います。
# Gateway ホストで実行（Tencent 公式 npm スコープ）
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
openclaw gateway status
openclaw doctor 2>&1 | tee /tmp/clawbot-doctor.txt
# WeChat：アシスタントへプローブ送信し Gateway ログと突合QR 期限切れ：npx を再実行し、スクリーンショットの使い回しは避けます。スキャン後も連絡先が無い：CLI と Gateway が同一到達ホストか、ファイアウォールの出站を確認します。空きディスク 15 GB 未満 では並行インストールが不安定になります。帯域は FAQ を参照してください。
04. 分診表：症状 → 優先動作 → 誤操作
| 症状 | 優先動作 | 誤操作 |
|---|---|---|
| プラグイン一覧に ClawBot が無い | WeChat 更新・グレー/地域説明確認・再起動 | 旧版のまま非公式 OpenClaw ブリッジを試す |
| スキャン失敗・期限切れ | npx … install 再実行・端末時刻同期 |
アルバムの古い QR を何度も試す |
| 受信はあるが返信が空/極短 | 審査・センシティブ語・モデル切替・Gateway OOM | 即メイン WeChat を再インストール |
| 夜間は必ず切断 | スリープ・systemd/launchd・公網到達性 | WeChat だけ再起動し Gateway を放置 |
| グループで @ したい | Telegram/Discord/Teams へ切替（ClawBot は非対応） | 非公式グループ bot ブリッジ（BAN リスク） |
05. 三指標・誤解と 1～3 日レンタル日程
- 指標 1：Tencent は npm スコープ
@tencent-weixinでopenclaw-weixin-cliを配布しています。コミュニティ文書は ClawBot 公開を 2026 年 3 月 前後に置くことが多く、「公式経路」監査の根拠になります（非公式リバースエンジニアリングではありません）。 - 指標 2：公開要件は iOS WeChat ≥ 8.0.70、Android ≥ 8.0.69（グレーは Tencent 基準）。未満だとプラグイン入口自体が見えないことがあります。
- 指標 3：M4 日貸しで OpenClaw 基線がある場合、「CLI QR + 初回双方向 + doctor 保存」はチームサンプルで 2～4 時間 の単一セッションに収まることが多いです。主力 Mac のスリープ後の再バインドより夜間当番を節約できます。
誤解 A：企業 WeChat グループ bot と同等。誤解 B：メイン ID + Agent にフルディスク権限。誤解 C：Gateway 常駐未設定で「本番完了」と宣言。
1 日目：隔離ホストで OpenClaw 導入と doctor、夕方に WeChat プラグインと QR、ログ保存。2 日目：20 ラウンド対話・ファイル片方向・審査サンプル（本番データ禁止）。3 日目：本番切替 Runbook、バインド解除、鍵消去、Telegram/Teams を群補助に残すか判断。
06. 自宅 PC / クラウド vs 日貸し Mac：QR と Control UI の証跡線
Gateway をスリープする自宅 MacやGUI の無い安価 VPSに置くと、スマホで QR を読みながら別マシンのログを追う隠れコストが増えます。短いネイティブ macOS レンタルなら npx @tencent-weixin/...、gateway status、Control UI、Keychain の読み取り専用鍵を一本の証跡線に揃え、本番移行を決められます。
常時クラウド + systemdは 7×24 確定後に向きます。1～3 日で「WeChat を個人入口にする価値」を試す段階では、日貸し Mac の方がメイン ID と開発ツリーを汚しません。料金ガイド と SSH/VNC FAQ をご参照ください。