npx -y @tencent-weixin/openclaw-weixin-cli@latest install を実行して QR をスキャンすればバインドできます。Wechaty などの灰色橋に賭ける必要はありません。本記事では公式プラグインとコミュニティ方案のリスク差、微信 8.0.70 と Gateway ready などの前提、六段階の跟做と三つの硬データ、単聊制限・24 時間ルール・安全審査、蓋閉めノート PC が ClawBot ホストに向かない理由と KVMNODE 専用クラウド Mac + launchd 常駐を整理します。OpenClaw 24 時間安定稼働、クラウド Mac 導入チェックリスト、公式 install-daemon、診断ラダー、launchd token、CLI 整合 と併読してください。
2026 年微信 ClawBot とコミュニティ橋：公式プラグインが変えたこと
OpenClaw は長らく Telegram、Discord、Slack など海外チャネル経由でモバイル端末と接続してきました。国内チームが微信を使う場合、従来は Wechaty、iPad プロトコル、各種非公式 webhook しかありませんでした。共通の問題はプロトコルがいつ失効するか不明、口座に风控・凍結の不確実性、保守コストが個人開発者に集中することです。2026 年 3 月 22 日前後、腾讯は微信内に「微信 ClawBot」公式プラグインを公開し、npm スコープ @tencent-weixin/openclaw-weixin-cli をリリースしました。「稼働中の OpenClaw Gateway に QR でバインドする」流れが正規製品手順になりました。
製品意味では、ClawBot は微信内蔵の大規模言語モデルではなく、すでに構成済みの OpenClaw Agent（人格、MEMORY、Skills、モデルルーティング）を微信の連絡先リスト上の会話ウィンドウへ接続する仕組みです。メッセージは微信クライアントを経由し、推論とツール呼び出しは Gateway ホストで実行されます。腾讯側はコンテンツの安全審査を行いますが、対話を腾讯モデルへ托管するものではありません。排障時は微信チャネルが切れたのか、Gateway またはモデル API が切れたのかを区別する必要があります。
プロトコル準拠：公式プラグインは微信プラグイン体系を通り、コミュニティ橋で多い凍結とプロトコル突变を避けます。
インストール面が狭い：ターミナルで npx 一行が QR を生成し、中間層サービスを自前で立てる必要がありません。
能力は OpenClaw を継承：微信で対話する相手は固定ベンダーモデルではなく、あなたの Agent です。
製品制限が明確：現状は単聊が中心で、群聊や企業シーンは企微プラグインなど別チャネルが必要です。
運用は自側：Gateway オフライン、18789 不健康、launchd token 欠落時は、微信側は送信不可または遅延として現れます。
クラウドホストで Gateway を観測可能な常駐サービスにしていない場合は、先に install-daemon 跟做 を完了してから ClawBot を開いてください。順序を逆にすると、QR 成功後の初条メッセージが「Gateway が実は listen していない」状態で止まりやすくなります。
前提条件対照表：微信バージョン、OpenClaw 就绪、モデル Key
ClawBot インストール失敗の半数は微信クライアントのバージョン未達、残り半数はOpenClaw インスタンスが truly ready でないことに起因します。下表は当番で揃える項目をまとめたもので、変更票にそのまま貼れます。
| 確認項目 | 要件 | 未充足時の典型現象 |
|---|---|---|
| 微信バージョン | iOS 8.0.70+ / Android 8.0.69+、設定→プラグインに ClawBot が表示 | プラグイン一覧に入口が無い、または QR 画面でバージョン不足 |
| OpenClaw Gateway | openclaw gateway status --deep が ready、18789 が単一 LISTEN | QR 成功後に返信なし、または CLI が RPC タイムアウト |
| Node / CLI | install.sh または文書と一致する Node 22、SSH と launchd で which openclaw が一致 | install スクリプトが Gateway を見つけられない、誤インスタンスへバインド |
| モデル API | openclaw.json に少なくとも一条の有効な上流 Key | 微信は送受信できるが返信が空または 401、微信ではなくモデル課金を確認 |
| ネットワーク出向 | ホストがモデル API と npm registry に到達可能 | npx パッケージ取得失敗または QR 生成タイムアウト |
先にターミナルで Gateway を healthy にし、その後で微信プラグインを開いてください。順序を逆にすると、すべての問題が「微信が壊れた」と記録されます。
KVMNODE 専用クラウド Mac では、状態ディレクトリが iCloud や企業同期盘に置かれていないことも確認してください。Gateway が断続的に DB 書き込みに失敗すると、ClawBot はランダム掉線のように見えます。凭证と token は launchd token と 診断ラダー L2 を参照し、微信の再インストールを先に行わないでください。
六段階跟做：微信プラグインから QR バインドとチャネル受け入れ
微信をアップグレード：我 → 設定 → 微信についてでバージョンを確認し、要件を満たしたら「プラグイン」へ戻ります。
ClawBot プラグインを有効化：設定 → プラグイン →「微信 ClawBot」→ 詳細ページのインストール手順を確認します。
Gateway ホストで実行：npx -y @tencent-weixin/openclaw-weixin-cli@latest install（OpenClaw と同一マシンまたは SSH セッション）。
微信でターミナル QR をスキャンし、スマートフォンでバインドを確認します。QR は有効期限が短く、失効時は前段を再実行します。
微信「微信 ClawBot」会話でテスト文を送信し、Gateway ログと openclaw channels probe（channels プローブ設定済みの場合）を照合します。
Gateway 再起動後にもう一条送信：launchd 再起動後もチャネルが online のままであることを確認し、バージョン、バインド時刻、初条メッセージのタイムスタンプを変更票に記録します。
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH" openclaw gateway status --deep npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw gateway restart openclaw channels probe 2>/dev/null || true
バインド命令はGateway が実際に動いているホストで実行する必要があります。OpenClaw が KVMNODE シンガポールノード上にあり、ローカルノートのターミナルで npx を走らせると、QR は誤ったインスタンスを指します。リモートチームはクラウド Mac へ SSH してから install するか、ssh user@host 'npx ...' でセッションを明示してください。
単聊、複数 Agent、企業微信：製品形態の選び方
公式文書とコミュニティ実測は、現行 ClawBot は単聊向けであり、同一プラグインを微信群に @ 付きで入れることはできないと示しています。プラグインの入站は OpenClaw の resolveAgentRoute を通り、channel + accountId + peer でルートを一致させます。「各微信口座 + 各チャット相手」に独立セッションコンテキストがありますが、同一微信会話内で Agent 役割を頻繁に切り替えることは推奨されません。状態機が乱れやすくなります。
| 運用パターン | 適用 | 注意 |
|---|---|---|
| 単一微信号 + 主 Agent 内部ディスパッチ | 大多数の日常アシスタント | 微信では一つのウィンドウのみ、裏側 Skills でタスク分流 |
| 複数微信号各々一 Agent | コンテンツ / 運用ロールの硬隔离 | プラグインは複数口座 online を支持、それぞれ QR スキャン |
| 企業微信 OpenClaw プラグイン | 組織内 bot、ドキュメント協作 | 個人 ClawBot と並行、相互に置換しない |
企業シーンで群 bot、アプリメッセージ、ドキュメント API が必要な場合は、企業微信側の公式 OpenClaw プラグイン（腾讯文書が別途保守）を使い、個人 ClawBot を企微代替と見なさないでください。個人微信は「いつでも自分の Agent に聞く」入口、企微は「チームフローと承認」向けです。両チャネルを同一 Gateway に載せられますが、openclaw.json のルート表で peer 規則の重複を避けてください。
注意事項、排障順序、クラウド Mac 常駐選定
QR 失効：ターミナル QR は数分で無効になります。タイムアウト時は npx を再実行し、同じスクリーンショットを繰り返しスキャンしないでください。24 時間インタラクションルール：長時間未対話後の能動プッシュは破棄される場合があり、「質問と回答」向きで、無人マーケティング一斉送信には向きません。コンテンツ安全審査：微信側はメッセージを合规検査し、ルール違反時は送信失敗または警告として現れます。OpenClaw 側でプロンプトやツール出力を調整し、プラグインの再バインドだけに頼らないでください。Gateway スリープ：ノート PC を閉じると ClawBot は切断されます。Telegram チャネル掉線と机理は同じですが、微信は日次入口のため体感が強くなります。
公式 CLI パッケージ名：@tencent-weixin/openclaw-weixin-cli。コミュニティ npm の偽パッケージと区別します。
デフォルトプローブポート：Gateway は引き続き 18789 でローカルヘルスチェック。導入チェックリスト と一致します。
微信バージョン閾値：8.0.70（iOS）/ 8.0.69（Android）が 2026 年 3 月文書の一般的記載です。アップグレード後にプラグインを開いてください。
排障順序の推奨：gateway status --deep → モデル API プローブ → npx install で QR 再スキャン → Gateway ログ確認 → 最後に微信再インストール。channels 401 や split brain の場合は、先に CLI と Gateway 整合 を読み、微信内で解绑・再バインドを繰り返さないでください。
| ホスト | ClawBot 体験 | 運用結論 |
|---|---|---|
| 蓋閉めノート PC | スリープ即断線、QR 成功後も長持ちしない | 個人試験のみ |
| 家庭 NAS / 低スペック VPS | 動くが Node とディスク IO が揺れやすい | 自前監視が必要、Apple 生态外 |
| KVMNODE 専用クラウド Mac | launchd 常駐 + 近区 Git/モデル出网選択可 | 7×24 微信入口の本番デフォルト |
同一クラウド Mac で iOS CI と複数 Skills を並行する場合、16GB 統一メモリは尖峰週に Gateway と xcodebuild がメモリを奪い合い、微信返信が遅くなる（チャネル切断ではない）現象が出ます。その場合は同プール隔離文を参照して M4 Pro へ昇格するかプール分割し、QR を繰り返しスキャンしないでください。監査可能・リージョン変更可能・ClawBot と Gateway 同機を要するチームには、KVMNODE Mac mini クラウドレンタルが実務上の定番です。専用ホスト、六リージョン、日次から月次までの契約で、18789、launchd、モデル Key と同一 Runbook を共有できます。SKU は 価格ページ、手順は ヘルプセンター、注文は 注文入口 をご覧ください。