Mac 上で OpenClaw は動いているのに、まだ Telegram やブラウザでしか会話していない場合、欠けているのはWeChat という日常の入口です。2026 年 3 月以降、Tencent WeChat チームは公式 WeChat ClawBot プラグインを公開しました。「設定 → プラグイン」で有効化したうえで、Gateway を動かすマシンで npx を一行実行し QR を読み取れば、自分の OpenClaw（人格、メモリ、Skills、Agent ルーティング）を WeChat の一対一チャットに接続できます。本記事は基礎インストール済みで本番投入を検討する読者向けです。公式プラグインと Wechaty など非公式経路のリスクを対照し、意思決定マトリクス、八段階の実践手順、機能境界とコンプライアンス上の注意、変更レビューに書けるハードパラメータ三つ以上を整理します。コマンドとバージョン要件は Tencent 開発者コミュニティと npm パッケージ説明を正とし、リリース後はリンクを開き直して再確認してください。料金は 料金ページ、注文は 注文ページ、リモート接続は ヘルプセンター を参照してください。
[ SECTION_01 ] // PAIN_MAP WeChat 接続で最も起きやすい失敗パターン
- グレープロトコルに固執する：Wechaty や iPad プロトコルなど非公式案は、プロトコル変更やリスク管理強化で一気に使えなくなることがあり、アカウント停止の不確実性も残ります。公式プラグイン体系とはリスク水準が異なります。
- WeChat クライアントのバージョン不足：プラグイン入口は比較的新しいクライアントに依存します。iOS は 8.0.70、Android は 8.0.69 以上が目安です。古い版では「プラグイン」一覧に ClawBot が出ません。
- Gateway 未準備のまま QR 読み取り：ターミナルで
npxは成功したのに OpenClaw Gateway が LISTEN していない、またはデーモン未起動だと、QR 期限切れ後に「つながったのにすぐ切れる」ように見えます。 - メインアカウントを実験台にする：メッセージは国内インフラを経由しコンテンツ審査の対象になり得ます。日常の主 WeChat アカウントで ClawBot をバインドすると、個人の社交と自動化実験が同一 ID に縛られます。
- グループチャットや双方向ファイルを期待しすぎる：現行プロダクトは一対一アシスタント寄りです。ファイル能力や約 24 時間無通信時の切断ルールを読まずに本番投入すると、最初の一週間で躓きます。
- ノート PC のスリープで「WeChat の AI が無反応」：Gateway が蓋を閉じる Mac 上にあると、ユーザーは ClawBot 障害と誤認しますが、実際はホストオフラインでありプラグイン自体の不具合ではありません。
[ SECTION_02 ] // ROUTE_MATRIX 個人 WeChat ClawBot、WeCom、海外チャンネルの選び方
次のマトリクスは立項段階で経路を選び、「入れたらグループ非対応だった」という手戻りを避けるためのものです。
| 経路 | 公式性 | 典型用途 | 主な制限 |
|---|---|---|---|
| WeChat ClawBot プラグイン | Tencent WeChat 公式 | 個人アカウント、日常の一対一 | 一対一中心。ファイルは受信寄り。長期無会話で再バインドが必要な場合あり |
| WeCom OpenClaw プラグイン | Tencent WeCom 公式 | チーム Bot、ドキュメント連携 | 管理コンソール設定が必要。個人 WeChat とは製品形態が異なる |
| コミュニティ Wechaty 等 | 非公式プロトコル | 過去の試験、特殊統合 | プロトコルとアカウントリスクが制御不能。本番のデフォルトには非推奨 |
| Telegram / Discord | 各プラットフォーム公式 Bot API | 海外協業、複数 Bot 並行 | 中国本土の日常 IM カバーは WeChat に劣る |
WeChat 入口が必要なチームにとって ClawBot の価値は「もう一つのチャット窓」ではなく、設定済み OpenClaw 実行面を最も日次利用される IM に載せることです。その前提は Gateway 側が安定し監査可能であることであり、個人ノート PC のスリープ戦略に賭けることではありません。
[ SECTION_03 ] // INSTALL_RUNBOOK OpenClaw から WeChat 会話ウィンドウまで：推奨八段階
以下は Tencent 開発者コミュニティの公開チュートリアルと npm インストール手順を統合したものです。上流でパッケージ名やフローが変わった場合は公式ドキュメントを正としてください。
https://developer.cloud.tencent.com/article/2648517
https://openclawlaunch.com/zh/wechat-clawbot
- OpenClaw の常駐を確認する：対象 Mac で
openclaw onboard --install-daemonまたは同等のデーモン導入を完了し、openclaw doctorで Gateway ポートと PATH を潰します。サイト内 初回完走と Gateway チェックリスト も参照してください。 - WeChat クライアントを更新する：「自分 → 設定 → WeChat について」でバージョンを確認します。iOS は 8.0.70 以上、Android は 8.0.69 以上を目安にします。
- プラグイン入口を有効化する：「設定 → プラグイン」で「WeChat ClawBot」をオンにします。入口が無い場合はバージョンと地域グレー配信を疑います。
- Gateway ホストでインストールコマンドを実行する：OpenClaw と同じユーザー環境で次のコマンドを実行します（Node と npm 到達性が必要です）。
- ターミナル QR でバインドする：コマンド出力の QR を、プラグイン有効化済み WeChat で読み取り、端末側で承認します。
- WeChat 側セッションを検証する：WeChat で「WeChat ClawBot」会話を開き、生存確認メッセージを送り、応答が設定モデルと人格由来であることを確認します（WeChat 内蔵 AI ではないこと）。
- Gateway を再起動しルーティングを再確認する：バインド後に Gateway 再起動または
openclaw gateway restart相当を行い、プラグインプロセスと OpenClaw ルーティング層resolveAgentRouteが期待どおりか確認します（単一 WeChat ID で複数コンテキスト、複数 ID で複数 Agent など）。 - 運用台帳に記録する：バインド WeChat ID（サブアカウント推奨）、時刻、npm 版、ログディレクトリのディスク基線を残し、24 時間切断や審査アラート時に素早く切り分けできるようにします。
$ npx -y @tencent-weixin/openclaw-weixin-cli@latest install[ SECTION_04 ] // LIMITS_AND_OPS 機能境界、マルチ Agent、本番運用上の注意
機能境界（最新公式説明を正とする）：個人 WeChat ClawBot は一対一が中心で、テキスト、画像、音声、ファイルの利用可能な部分集合をサポートしますが、グループチャットはデフォルト製品能力として想定されていません。一部ドキュメントではファイルは受信のみと記載されています。約 24 時間会話が無いと接続が切れ、再 QR が必要な場合があります。Telegram の複数 Bot 並行運用の感覚をそのまま WeChat に当てはめないでください。
マルチ Agent のおすすめ二パターン：パターン A——単一 WeChat ID、主 Agent が内部で子 Agent を振り分け（ユーザーからは一つの会話窓、WeChat 習慣に最も近い）。パターン B——複数 WeChat ID を別 Agent に割り当て（境界が明確で、コンテンツと運用を役割分離しやすい）。同一会話内で Agent 識別子を頻繁に手動切替するとセッション状態が乱れやすいため非推奨です。
- サブアカウントでバインド：予備 WeChat ID で自動化実験を受け、メインアカウントの社交と審査リスクを下げます。
- 鍵と資格情報：モデル API Key とワークスペースパスは Gateway ホストに残します。チャットに本番鍵を貼らないでください。
- コンテンツ審査：トラフィックは Tencent 国内インフラを通るため、チームのコンプライアンスに沿って敏感命令と外部送信データを制限します。
- ディスクとログ：チャンネルプラグインと Gateway ログは伸びが早いです。リモート Mac ではローテーション方針を先に決めます。ディスクとデーモン計画 を参照してください。
- WeCom：チーム用途は WeCom 公式 OpenClaw プラグインを別プロジェクトとして並行評価し、個人 ClawBot と混ぜないでください。
[ SECTION_05 ] // HARD_FACTS 引用可能な数値と典型エラー対照
- WeChat バージョン要件：公開チュートリアルでは iOS 8.0.70+、Android 8.0.69+ でプラグイン一覧に ClawBot が現れると記載されています。（出典：Tencent Cloud 開発者コミュニティ記事 2648517。リリース後に再確認）
- 公式インストールコマンド：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install。WeChat チームが保守する CLI パッケージです。（出典：同上および OpenClaw Launch WeChat 接続ページ） - 公開タイムライン：WeChat ClawBot 公式プラグインは 2026 年 3 月 前後に公開され、正規プラグイン体系であり第三者 Hook ではありません。（出典：コミュニティ公開報道。Tencent 公告を正とする）
- Gateway ポート慣習：OpenClaw のデバッグと常駐は 18789 ループバックポート周辺が一般的です。ClawBot プラグインは稼働中 Gateway 上のチャンネル入口としてマウントされます。（出典：openclaw/openclaw README）
| 表面症状 | 優先疑い | 最小検証 |
|---|---|---|
| プラグイン一覧に ClawBot が無い | WeChat 版が古い、グレー未配信 | クライアント更新。iOS/Android 版番号確認 |
| QR 後に応答が無い | Gateway 未起動、npm 失敗 | ローカル lsof -nP -iTCP:18789 -sTCP:LISTEN。Gateway ログ確認 |
| 翌日突然無応答 | 24h 無通信ポリシー、ホストスリープ | 再 QR。Gateway を 7×24 リモート Mac へ移す |
| グループメンション無反応 | 製品がグループ入口非対応 | 一対一に切替、または WeCom プラグイン経路を検討 |
[ SECTION_06 ] // PLATFORM_CLOSE ClawBot を 7×24 リモート Mac で動かす理由
ClawBot が解くのは入口であり、安定性は Gateway ホスト次第です。個人 Mac は蓋を閉じると切断され、家庭用回線の NAT とスリープ設定により WeChat 側では「AI が消えた」ように見えます。仮想 VPS は常時オンラインでも、macOS ネイティブツールチェーン、ディスク IO、OpenClaw Node 能力との相性はベアメタル Mac mini に劣ることが多いです。Gateway と openclaw-weixin-cli を専有 Apple Silicon に置き、ログローテーションとサブアカウントバインドを組み合わせれば、公式プラグインのリスクを「製品ルール」レベルに閉じ込め、「ノート PC 停電」レベルの事故を避けられます。
六地域ノードからレイテンシとレンタル期間を選ぶ、または M4 から M4 Pro へ上げてマルチ Agent と重い Skills を載せる場合は、NOVAKVM 料金ページ で段階を比較し、注文ページ から試験機を二スプリント分確保するのが現実的です。WeChat 入口と iOS CI、OpenClaw 自動化を同一運用境界に置くスタジオにとって、NOVAKVM の Mac Mini クラウドベアメタルレンタルは、家庭 PC の妥協や不安定プロトコルより本番型 ClawBot を引き受けやすい選択肢です。リモート接続の詳細は ヘルプセンター、チャンネルとリバースプロキシの応用は OpenClaw チャンネルと Gateway トラブルシュート を参照してください。