2026 Tencent WeChat ClawBot 導入ガイド
openclaw-weixin-cli、バージョン互換と本番運用の注意点

個人 WeChatから自分の OpenClaw「ロブスター」を直接操作したいのに、WeChat ClawBot プラグインと Gateway のどちらを先に入れるべきか迷っていませんか。本記事は 2026 年に OpenClaw を稼働させる(またはこれから導入する)開発者向けに、Tencent 公式 openclaw-weixin チャネルの導入前チェックnpx @tencent-weixin/openclaw-weixin-cli install と手動 4 ステップの対照、2.0.x / legacy バージョンマトリクス、複数アカウントの dmScope、WeChat 側の 1:1/ファイル/キープアライブなどの本番注意点をまとめます。サイト内の Telegram 排錯、channels probe、半インストール復旧記事と役割分担し、誤った段階で設定をいじらないようにします。

01

ClawBot とは?なぜ「ロブスター」が先で「回線」が後なのか

Tencent が 2026 年に提供するWeChat ClawBot(設定 → プラグイン)は公式チャネル入口です。スキル実行と LLM 呼び出しは、PC またはサーバー上の OpenClaw Gateway が担います。コミュニティでは OpenClaw を「ロブスター」、ClawBot を WeChat 内の「回線」と呼びます。回線がつながらなければ、Gateway が健全でも WeChat メッセージは届きません。

  • 01

    WeChat プラグインのみで OpenClaw なし:QR ログインは成功しても inbound を処理する Agent がありません。

  • 02

    OpenClaw が古い:プラグイン 2.0.x はホスト >=2026.3.22 が必要。古いと requires OpenClaw >=2026.3.22 でロード拒否されます。

  • 03

    Gateway が常駐していない:ノート PC のスリープ、Docker の restart 未設定、Linux VPS で systemd 未導入——「昨日は動いたが今日は無音」になります。

  • 04

    ClawBot を Tencent 版の汎用ボットと混同:ClawBot は自分の OpenClaw とモデル設定に接続します。自由度は高い一方、運用責任も自分にあります。

  • 05

    複数 WeChat を 1 セッションに混在:デフォルト DM で文脈が混線。複数ログイン後に session.dmScope 未設定だと A 向けの返答が B に届きます。

  • 06

    WeChat 製品制限の無視:公式チャネルは現状1:1 のみ・グループ不可。ファイルは「入るが出ない」境界があります(第 4 節)。

02

対照表:個人 WeChat ClawBot vs 企業 WeChat vs Telegram

観点公式 ClawBot プラグイン企業 WeChat 自社アプリTelegram Bot(OpenClaw 内蔵)
向く用途個人の試用、1:1 自動化チーム、グループ/コンプライアンス海外・開発者コミュニティ、グループ制御が成熟
導入難易度低:openclaw-weixin-cli + QR高:公開 IP、コールバック URL、信頼 IP中:Bot Token + pairing
WeChat バージョン推奨 8.0.70+(プラグイン入口)プラグイン QR で企業号フォロー該当なし
グループ非対応拡張可能対応(mention 等のポリシー)
排錯専用記事本記事企業 WeChat プラグイン文書デプロイ後トリプル症候群

「WeChat で送れる」は「チャネルが閉ループした」とは限りません。プラグイン enabled、Gateway restart、probe 合格——この三つが揃って初めて本番です。

03

6 ステップ導入 Runbook:CLI から最初の WeChat 返信まで

推奨順序:OpenClaw と Node のベースライン確認(Node 24 本番デプロイ参照)の後に WeChat プラグインを入れます。Gateway がまだ無い場合は先に 半インストール復旧を読んでください。

  1. 01

    ホスト版確認:openclaw --version。< 2026.3.22 で 2.0.x を使うなら openclaw update か legacy ライン(次節)。

  2. 02

    一括導入(推奨):npx -y @tencent-weixin/openclaw-weixin-cli install — 版検出、plugins install、QR 案内、Gateway 再起動まで自動。

  3. 03

    手動(同等 4 ステップ):openclaw plugins install "@tencent-weixin/openclaw-weixin"openclaw config set plugins.entries.openclaw-weixin.enabled trueopenclaw channels login --channel openclaw-weixinopenclaw gateway restart

  4. 04

    WeChat 側確認:WeChat 8.0.70+、「自分 → 設定 → プラグイン」に「WeChat ClawBot」。Android が灰度外なら CLI QR でプラグイン更新を促す手順あり(WeChat 終了後に再スキャンが必要な場合あり)。

  5. 05

    複数アカウントと観測(任意):再度 channels login でアカウント追加。複数時は openclaw config set session.dmScope per-account-channel-peeropenclaw.jsonchannels.openclaw-weixin.botAgent はログ帰属用(認証には不使用)。

  6. 06

    受け入れプローブ:openclaw channels status --probeopenclaw doctor --deep。WeChat からテスト送信し openclaw logs --follow で inbound 確認。ペアリング/沈黙が重なる場合は channels probe 専用記事

bash
# 2026 Tencent WeChat チャネル — 一括 + 受け入れ
npx -y @tencent-weixin/openclaw-weixin-cli install

openclaw --version
openclaw channels status --probe
openclaw doctor --deep
openclaw logs --follow

# ホストが古い場合は legacy ライン
openclaw plugins install @tencent-weixin/openclaw-weixin@legacy
info

ヒント:npm が遅い地域では registry をミラーに切り替えてから npx を実行してください。プラグイン失敗時は QR を繰り返さず、先に openclaw plugins list にエントリがあるか確認します。

warning

注意:メッセージは Tencent 公式経路を通りコンテンツ審査があります。本番ではサブアカウントでバインドし、メインは観測用に留めることを推奨します。

04

バージョン互換マトリクス、WeChat 側の制限とホスト選定

プラグインラインOpenClaw ホストnpm dist-tag典型エラー
2.0.x>= 2026.3.22latestホストが古い → OpenClaw をアップグレード
1.0.x>= 2026.1.0 < 2026.3.22legacy@legacy を入れ、無理にホストを上げない
  • WeChat 8.0.70+:プラグイン入口と QR 認可は新バージョン依存。iOS の展開は通常 Android 灰度より早いです。
  • 1:1 のみ / グループ不可:グループ文は手動で Bot に転送するか企業 WeChat へ切り替えます。
  • ファイルは入るが出ない:PDF/画像の分析は可能でも、結果は OpenClaw Web や別チャネルで取得し、WeChat 添付で返らないことが多いです。
  • 24h インタラクション維持:長時間無会話でプッシュが止まる場合あり。自動化では cron ハートビートや日次 ping を推奨します。

スリープするノート PC 上の Gateway では、蓋を閉めると WeChat チャネルが一斉に沈黙します。専有で常時オンラインの macOS ノードの方が 7×24 WeChat 自動化に向きます。VPS を借りる感覚で SSH 保守可能な Mac 算力と「6 ステップ Runbook」を標準イメージに載せたい場合、NodeMini の Mac Mini クラウドレンタルが実務上はっきり有利です。リモート Mac launchd 常駐や iOS CI と同じ運用心智で、「自宅 Gateway は眠る、会社 WeChat は返信待ち」の割裂を減らせます。

FAQ

よくある質問

WeChat ClawBot はチャネルプラグイン、OpenClaw Gateway はランタイムです。先に OpenClaw を入れ、openclaw-weixin-cli で WeChat を接続します。入門は 全プラットフォーム導入トラブルシュートを参照ください。

plugins.entries.openclaw-weixin.enabled が true か確認し gateway restart。複数アカウントでは session.dmScope per-account-channel-peer。ノード仕様は レンタル料金をご覧ください。

Telegram 記事は 409/Webhook/Relay を扱います。本記事はTencent WeChat 公式プラグインの導入と製品制限です。接続・監査は ヘルプセンターを参照ください。