2026年 WeChat公式 ClawBot + OpenClaw：設定 Runbook、避坑、リモート Mac 7×24 検証

個人 WeChatから OpenClaw を操作したい運用者は、腾讯の公式 ClawBot プラグインとレガシー第三者ブリッジを切り分ける必要があります。2026年3月以降、npm に @tencent-weixin/openclaw-weixin-cli が公開され、WeChat「設定 → プラグイン」で ClawBot を有効化したうえで QR スキャンにより Gateway を紐づけます。本稿は事前ゲート、ワンクリック対手動インストール、六手順 Runbook、リスクマトリクス、現場ケーススタディ、引用可能な数値 SLOを示します。WeChat 側は端末オンライン + グレー展開、サーバー側は24時間 Gatewayが前提です——スリープするノート PC ではチャネルが切れるため、本番ではリモート Mac 対照ノードでの受入が実務的です。サイト内《多渠道 JSONL と Bootstrap 停止》《インストール後 Gateway 未完了》《invalid config と doctor --fix》と役割を分けて参照してください。

1. ClawBot と第三者ブリッジの違い

ClawBot は OpenClaw 向けのWeChat 公式プラグイン経路であり、@tencent-weixin/openclaw-weixin による認証であって、Web プロトコルのスクレイピングではありません。対象はDM（一対一）ワークフローが中心で、企業 WeChat（WeCom）ボットとは別チャネルです。非公式ブリッジは短期動作してもアカウント停止や利用規約リスクを伴います。本番では腾讯チャネルに標準化し、Gateway を常時オンラインのハードウェア上で運用してください——ローカル常時 Mac または launchd 管理のリモート Mac です。

2. 事前受入（五つのゲート）

ゲート A：openclaw --version は ideally ≥ 2026.3.22 と openclaw doctor。ゲート B：Node.js 22+ とグローバル npm の PATH（Gateway 未完了専稿の PATH 節を参照）。ゲート C：WeChat クライアント ≥ 8.0.70、実名認証済み・登録 3 ヶ月超のアカウントを推奨し、新規号での本番バインドは避けます。ゲート D：プラグイン一覧に ClawBot が表示されること——無い場合はグレー外であり、非公式ツールで代替しないでください。ゲート E：QR スキャン前に openclaw gateway status が healthy で、/health が 2 秒以内であること。いずれかが赤のままスキャンすると、連絡先だけ作成されメッセージ経路が死んだ状態が残り、切り分け工数が倍増します。

3. 意思決定マトリクス

シナリオ	経路	備考
初回ラボ連携	`npx @tencent-weixin/openclaw-weixin-cli install`	最速の QR フロー
監査付き本番	手動 `plugins install` + 設定	変更票に追記しやすい
npm タイムアウト	ミラーレジストリで再試行	プラグイン未有効化のまま繰り返しスキャンしない
アップグレード後無応答	`plugins.entries.openclaw-weixin.enabled` を確認	2026.3.22+ でプラグインキーが移行
ノート閉蓋で DM 停止	リモート Mac Gateway で再連携	バインドはエンドポイント固有

4. 六手順 Runbook

Step 1 WeChat で ClawBot を有効化

WeChat を最新版へ更新 → 設定 → プラグイン → ClawBot をオン。エントリが無い場合はバージョンと地域を記録し、グレー待ちとします。

Step 2 Gateway 稼働を証明

連携を行うホストで openclaw gateway status と curl -m 3 http://127.0.0.1:18789/health。リモート Mac は SSH ログイン後に同様に確認します。

Step 3 チャネルをインストール

npx -y @tencent-weixin/openclaw-weixin-cli@latest install
# または:
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw channels login --channel openclaw-weixin
openclaw gateway restart --force --wait

Step 4 QR を速やかにスキャン

QR の有効期限は短いです。失効したら Step 3 を再実行してください。数時間前のスクリーンショットは使わないでください。

Step 5 送受信を検証

ClawBot 連絡先へテスト DM を送信し、並行して openclaw channels status --probe とログを確認します。受信のみ成功する場合は、WeChat を疑う前にモデル API キーと RPC タイムアウトを切り分けます。

Step 6 リモート 30 分ソーク

リモート Mac のゴールデンホストで Step 2–5 を繰り返し、probe が 30 分連続で緑になってから本番 WeChat アカウントへ切り替えます。

5. 避坑マトリクス

領域	リスク	緩和策
スコープ	DM 優先、グループ機能は限定	サポート群をこのチャネルに載せない
アカウント	メイン WeChat + 強力な Agent ツール	副アカウント専用、exec を制限
コンプライアンス	トラフィックは WeChat 基盤を経由	高リスク自動返信テンプレートを避ける
アップグレード	プラグイン読み込み順の変更	前後で doctor + probe
稼働率	オフライン Gateway = WeChat 無応答	スリープノートではなく launchd 付きリモート Mac

6. 層別トラブルシュート

プラグイン一覧に ClawBot が無い：グレー展開待ちです。スキャン後に連絡先が出ない：Gateway 未再起動またはプラグイン無効です。受信のみ：enabled フラグとポート 18789 のファイアウォールを確認します。npx 失敗：npm config set registry https://registry.npmmirror.com 後に再試行します。アップグレード後の破損：openclaw doctor --fix のあと gateway restart --force --wait——バックアップなしで ~/.openclaw を削除しないでください。RPC が《5.2 タイムアウト》のときは、WeChat チャネルを疑う前にセッションストアと compaction を切り分けます。

7. ケーススタディ：QR 成功、通勤中に無応答

「開発者が自宅 MacBook で ClawBot を連携。フタを閉めると Gateway がスリープし、WeChat DM が翌朝まで無応答。ログでは openclaw-weixin の WebSocket がローカルスリープとともに切断。」

チームは当初腾讯 API 障害と判断しましたが、実態は本機 Gateway の 7×24 欠如でした。launchd 常駐のリモート Mac mini へ移し openclaw gateway install --force 後に再スキャンすると同一 WeChat で安定復帰し、対照ノードに旧設定を残して diff 監査できました。教訓：ClawBot はスキャン時にオンラインだった Gateway エンドポイントに紐づく——ホスト名・IP の変更には再ペアリングと Runbook エントリが必要です。「自宅でスキャン、会社ネットで利用」は端点ドリフトの典型パターンです。

8. 業界観点

IM ベンダーはネイティブ Agent チャネルを提供し始め、運用負荷はセルフホスト Gateway へ移ります。WeChat のリーチは巨大ですが、SLO はサーバー側の可観測性とロールバックに依存します。Windows/Linux VPS でも OpenClaw は動きますが、ClawHub スキルやメディア系ツールでは macOS ゴールデンホストが選ばれ続けます。Apple Silicon リモート Macで 30 分プローブ窓を通してから本番トラフィックを載せるのが一般的です。MACGPU リモート Mac はディスク分離、スナップショット、ログ再生を提供します——WeChat アカウントのコンプライアンス責任はお客様側に残ります。

9. 引用可能な数値しきい値

WeChat < 8.0.70：先にクライアント更新。OpenClaw < 2026.3.22：アップグレード + doctor。スキャン後 5 分 probe が赤：本番投入禁止。DM で3 ターンコンテキスト保持後にファイル書き込み Skills を有効化。Gateway 変更後はリモートホストで 30 分 probe 緑を確認。

10. FAQ

ClawBot と WeCom は同じですか？ いいえ、チャネルと資格情報が異なります。Mac は必須ですか？ OpenClaw 自体は必須ではありませんが、本稿の受入経路はリモート Mac を推奨します。QR 期限切れ？ install / channels login を再実行してください。グループは？ 現行ドキュメントでは DM を前提に計画してください。MACGPU の役割？ 7×24 対照ノードの提供であり、WeChat コンプライアンスの代替ではありません。