Mac 上で OpenClaw Gateway を既に運用しているのに、WeChat 内で自分の Agent と会話したい場合、Wechaty やプロトコル逆解析ベースのコミュニティ実装は、アカウントリスクと保守の脆さを伴います。2026 年 3 月以降、腾讯は WeChat 8.0.70+ 向けに公式 WeChat ClawBot プラグインを提供しており、Gateway をホストするマシンで npx -y @tencent-weixin/openclaw-weixin-cli@latest install を実行して接続できます。本稿では再現可能なインストール順序、監査境界、排障手順を整理し、Gateway を CALMVPS ベアメタル リモート Mac に置いたままスマートフォンからバインドする方法も説明します。
読み終えると、WeChat ビルドと OpenClaw インスタンスが公式要件を満たすか、CLI を Gateway に対してどこで実行すべきか、QR バインド失敗・UI にチャネルが出ない・返信が空になる場合に何を確認すべきかを判断できるようになります。
01 公式 ClawBot 経路が重要な理由
国内チームが求めるのは「もう一つ Telegram Bot」ではなく、毎日何十回も開くアプリ内で調査・下書き・Skill 起動・短い自動化をこなすことです。非公式ブリッジは次の三つの予測可能な失敗パターンを持ちます。
- アカウントリスク:模擬クライアントやプロトコル改変はプラットフォーム側の執行措置を招き、ビジネス連絡先にも波及することがあります。
- 運用 SLA の不在:ログインフロー、CAPTCHA、上流 API 変更は深夜のスクリプト作業になり、ベンダー SLA もありません。
- プロダクト不一致:Telegram 式のマルチ Bot パターンは WeChat ルーティングにそのまま当てはまらず、グループ機能では状態バグが増幅します。
ClawBot は腾讯のプラグイン体系を利用します。設定 → プラグインで発見し、Gateway ホストで公開 CLI を実行し、スマートフォンの QR スキャンで認可します。トラフィックは引き続き腾讯のセキュリティ審査を通るため、安定性は向上しますが、モデレーション、ダイレクトチャット限定、一部配信制限をプロダクトルールとして受け入れる必要があります。これらはインストール不具合ではありません。
運用チームは本番前に三つの責任分界を文書化すべきです。テスト端末の WeChat アップグレード担当、Gateway 上のモデル API キーローテーション担当、ファイルシステムに触れうる Skill 導入の承認担当です。この分割がないと、最初の本番インシデントは「WeChat が壊れた」と「OpenClaw が壊れた」の押し付け合いになり、実際の原因は監査されていない Skill がワークスペース外へ書き込んでいることだった、という結末になりがちです。
ClawBot は汎用 IM SDK ではなく公式チャネルプラグインとして扱ってください。インストールは速い一方、バージョン要件、モデレーション、Gateway 配置こそが本当の受入試験です。
02 ClawBot・Wechaty・企業微信プラグインの比較
| 観点 | WeChat ClawBot(公式) | コミュニティ Wechaty / プロトコル | 企業微信 OpenClaw プラグイン |
|---|---|---|---|
| アカウント種別 | モバイル個人 WeChat | 実装依存、執行リスク不確定 | 企業 WeCom Bot |
| コンプライアンス | 公式プラグイン経路 | 高い破損・BAN リスク | IT 管理下の組織ポリシー |
| サーバー要件 | Gateway ホスト到達可能、リモートベアメタル可 | 追加ミドルウェアデーモンが必要なことが多い | 公開コールバック + 企業資格情報 |
| チャット形態 | ダイレクトチャットのみ、グループ不可 | 一部フォークはグループ露出(高リスク) | チーム通知、ドキュメントワークフロー |
個人開発者はClawBotをデフォルトにしてください。組織全体への配布と監査が必要になったら企業微信プラグインへ移行します。同一の実験 Gateway プロファイルに両方を混在させないでください。
03 前提条件と Gateway 配置
ClawBot は WeChat 内の汎用クラウドモデルではなく、あなた自身の OpenClaw インスタンスにバインドされます。インストール前に次を確認してください。
- WeChat クライアント:iOS では一般的に 8.0.70+ が必要です。Android の要件はプラグインページに従い、地域によってはグレーリリース中の場合があります。
- 端末:バインドはモバイル WeChatを使用します。デスクトップ WeChat では認可を完了できません。
- CLI ホスト:Gateway が動作する Mac のシェルで
installを実行します(ローカル、または CALMVPS ベアメタルへ SSH)。 - ネットワーク:スマートフォンと CLI ホストが QR ハンドシェイクを完了できる必要があります。モデル API 出口と WeChat 側のレイテンシは別々に評価してください。
トポロジ A:ノート PC Gateway + ローカル CLI + スマートフォン QR。トポロジ B:レンタルベアメタル Mac 上で Gateway を 24/7 常駐、SSH で CLI を実行し、同じスマートフォン QR をスキャン。ノート PC がスリープするチームには B が適しています。
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
本番前に npm でパッケージ名と README を確認してください。腾讯がフラグを更新した場合は、プラグイン詳細ページからコマンドをコピーしてください。
04 六段インストールと QR バインド
- WeChat をアップグレード:設定 → バージョン情報でプラグイン要件を満たし、必要ならストアから更新します。
- プラグインを開く:設定 → プラグイン → WeChat ClawBot → インストールコマンドをコピーします。
- Gateway の健全性を確認:ステータスチェックを実行します。リモートノードでは先に SSH します。
- CLI を実行:
npx -y @tencent-weixin/openclaw-weixin-cli@latest installを貼り付け、QR が表示されるまで待ちます。 - スマートフォンで認可:モバイル WeChat でスキャンします。共有ベンダーモデルではなく、この Gateway インスタンスにバインドされます。
- チャネルを検証:コントロール UI で WeChat チャネルがオンラインか確認します。表示されない場合はワンクリック更新とブラウザのハードリフレッシュ(Cmd+Shift+R)、必要なら Gateway 再起動後に再スキャンします。
インバウンドメッセージは OpenClaw の resolveAgentRoute により channel、accountId、peer でルーティングされます。大多数の個人ユーザーには、単一 WeChat アカウント + 内部委譲するプライマリ Agent が、同一スレッド内で Agent を切り替えるより安定します。
プレイブック B として、複数 WeChat アカウントを異なる Agent にマッピングすることも可能です(例:「個人アシスタント」と「運用 Bot」の硬い境界)。各アカウントは独自の peer コンテキストを持ち、一つのチャット内で Telegram 式マルチ Bot タブは期待しないでください。バインド後は、シェル実行やブラウザ操作 Skill を有効化する前に、無害な ping(「あなたは誰 / どのモデル」)でルーティングを確認してください。
Gateway を CALMVPS ベアメタル上でホストする場合、ai.openclaw.gateway の launchd を所有するユーザーと同じセッションで SSH 経由 CLI を実行してください。ノート PC を閉じても WeChat 到達性は止まらず、Gateway の健全性だけが問題になるべきです。
05 八項ガードレールと排障マトリクス
- ダイレクトチャットのみ:グループ @mention は期待しないでください。ブロードキャストは WeCom や他チャネルを使います。
- コンテンツモデレーション:腾讯は DeFi、ウォレット、crypto 関連表現など敏感ドメインをフィルタします。空返信はポリシー起因の可能性があります。
- 予備アカウント:OpenClaw が広いシステム権限を持つ場合は、セカンダリ WeChat でバインドしてください。
- ワークスペース境界:書き込み可能パスと
system.run承認を厳格化します。 - アイドルセッション:長時間無通信後は、新規ユーザーメッセージでチャネルを再活性化する必要がある場合があります。
- Android グレーリリース:プラグイン項目がない場合は、バージョンまたは地域の問題であり、「もっと頑張ってインストール」では解決しません。
- ファイル配信:処理成果物はメールやドライブ経由の引き渡しが必要な場合があります。
- チャネル行の欠落:Gateway / CLI バージョンを揃え、UI 更新後のログを確認します。
| 症状 | 最初に確認 | 第一修正 |
|---|---|---|
| プラグインに ClawBot がない | WeChat バージョン / グレーリリース | アップグレード、公式展開を待つ |
| QR 完了後 Gateway オフライン | CLI が Gateway ホストで実行されていない | リモート Mac へ SSH、install 再実行、Gateway 再起動 |
| 返信が途中で切れる | モデレーションキーワード | プロンプトを言い換え、ブロック話題を避ける |
| UI に WeChat 行がない | 古い OpenClaw ビルド | ワンクリック更新 + ハードリフレッシュ |
「無言失敗」をデバッグするときは、Gateway ログとユーザー発話の原文を記録してください。モデレーションはスタックトレースなしで空ボディを返すことが多く、同一プロンプトを Telegram や Discord で試すとモデル経路は正常で WeChat チャネルだけがフィルタされていると証明できます。
腾讯の開発者記事には公式 ClawBot の公開タイムラインとスクリーンショットが記載されています。公開後にリンクを再確認し、手順が変わっていないか確認してください。
06 ベアメタル Mac Gateway とサイジング
- WeChat プラグイン要件(iOS):公開チュートリアルでは 8.0.70+ が一般的です。
- 公式 CLI パッケージ:
@tencent-weixin/openclaw-weixin-cliをnpx … installで呼び出します。 - デフォルト Gateway 制御ポート:
18789(リモート双機ドキュメントと同一)。 - リモートサイジング:マルチチャネル + cron + WeChat 入口なら M4 24GB から。重いローカルモデルや Skill 試行は M4 Pro。ログ増加時は CPU より先に 1TB/2TB を検討します。
スリープするノート PC 上の Gateway は、24/7 WeChat 到達性と Token 衛生を損ないます。汎用 Linux VPS には macOS ツールチェーンと TCC 関連 node ワークフローがありません。タイムシェア型仮想 Mac ファームはカスタム launch agent やディスク IO を制限し、デモには向きますが WeChat がオンコールページャーになると辛くなります。
参考ワークフロー:Gateway と WeChat チャネルを CALMVPS シンガポール月額 M4 24GB ノードに置き、ローカル MacBook は画面キャプチャと Xcode サイドタスク用 Remote node とし、ビルドスパイクは週次並列ワーカーで吸収して Gateway Token に触れません。WeChat セッションはハブに留め、ビルドスパイクはワーカーで処理します。
安定 Gateway、公式 WeChat 入口、再現可能な排障が必要なチームには、CALMVPS マルチリージョン ベアメタル Mac が通常より適したホストです。専用 Apple Silicon、約 120 秒デリバリー、日次/週次並列ワーカーでハブを昇格せずビルドスパイクを吸収できます。詳細は CALMVPS 料金ページをご覧ください。