微信公式 ClawBot OpenClaw 導入ガイドのカバー画像

2026年 微信公式 ClawBot と OpenClaw:ワンコマンド導入・バージョン要件・本番回避の決定マトリックス

2026年、Tencent は OpenClaw 向けの公式 WeChat プラグイン(@tencent-weixin/openclaw-weixin-cli)を公開し、ClawBot が正規チャネルでスマートフォン会話を扱えるようになりました。Wechaty などの非公式プロトコルに頼らず導入したい開発者向けに、プラグインが見えない・QR 失敗・ゲートウェイは起動するが返信がない、といった症状を四層で切り分け、五手順の導入と本番マトリックス、そして 7×24 運用にリモート Mac が適する理由をまとめます。

1. 先に層を決める:四つの失敗パターン

再インストールの前に、次のどれに当てはまるかを確認してください。グレー未開放をゲートウェイ障害と誤認しないことが重要です。

  • L0 プラグイン入口がない: WeChat が 8.0.70 未満、アカウントがグレー対象外、または OpenClaw ホストがプラグイン 2.0.x が要求する 2026.3.22 より古い場合が多いです。
  • L1 QR/ペアリング失敗: 端末とゲートウェイのタイムゾーン・プロキシ不一致、コールバックポートの遮断などが典型です。
  • L2 ゲートウェイが起動しない/updating ループ: CLI 導入後に openclaw gateway restart をしていない、launchd と手動プロセスが競合しているケースです。
  • L3 接続はあるが無応答: モデル資格情報が空、channels --probe が赤、session.dmScope の誤設定によるセッション混線です。

2. 公式 ClawBot と Wechaty・WeCom Webhook の違い

公式ルートではメッセージが Tencent 経由で流れますが、実行できる能力はローカルの OpenClaw 設定(モデル・Skills・plugins.fs)に依存します。WeCom の自建アプリ Webhook とは別物であり、PC 版 WeChat の常駐も想定されていません。Wechaty よりコンプライアンスとアップデート経路が明確な一方、グレー範囲・コンテンツフィルタ・「スマホ常時オンライン」という制約を受け入れる必要があります。

3. 導入前チェックリスト

  1. WeChat クライアント: iOS/Android ≥ 8.0.70(Android は 8.0.69+ から早めの更新を推奨します)。
  2. OpenClaw ホスト: v2026.3.22 以上を推奨し、openclaw doctor で extensions と CLI の版を揃えます。
  3. 常時オンライン: ノート PC のスリープでは本番に不向きです。ログ永続化できるホストが必要です。
  4. 最小権限ワークスペース: shell/fs プラグインを開く前に workspaceAccess を絞ります。

4. 五手順:コマンドコピーから会話検証まで

  1. スマホ WeChat → 自分 → 設定 → プラグイン から公式コマンドをコピーします。
  2. ゲートウェイホストで npx -y @tencent-weixin/openclaw-weixin-cli@latest install を実行します。
  3. QR/アカウント紐付け(本番前はサブアカウントでの試験を推奨します)。
  4. openclaw gateway restart 後、gateway status が ready になるまで待ちます。
  5. openclaw channels status --probe のあと WeChat からテスト送信し、agent.jsonl のタイムスタンプを照合します。
openclaw gateway restart
openclaw channels status --probe
openclaw doctor

5. 本番回避の決定マトリックス

リスク/現象 推奨 非推奨
グレー未開放 公式開通を待つ間は Telegram/Slack で自動化を検証する Wechaty に戻して長期安定を期待する
海外回線・プロキシ ゲートウェイと端末の出口戦略を一致させる 多段プロキシで QR コールバックがタイムアウトする
複数 WeChat アカウント session.dmScope: per-account-channel-peer でルーティング分離 デフォルト session を共有してコンテキストが混線する
Docker 隔離 資格情報 volume を固定し再起動ポリシーを設計する コンテナ再作成のたびに pairing 状態を失う

6. リモート Mac・SFTP ワークスペースとの接続

WeChat チャネルはゲートウェイの長時間接続を前提とします。一方で Skills やプロンプトは SFTP/rsync で同一 Mac に同期されることが多いです。リモート Mac に OpenClaw を載せると、launchd 常駐・統一ログパス・CI 成果物ディレクトリのホワイトリストを一度に満たせます。障害時は statusgateway status --deepdoctorlogs の公式ラダーに沿い、サイト内の gateway restart・pairing・本番セキュリティ記事と併読するのが効率的です。

7. まとめ:正規チャネルと安定ホストの両輪

公式 ClawBot が解くのは「WeChat を合法的に接続できるか」であり、モデルコストやディレクトリ権限、24/7 運用設計の代替ではありません。npx 一行は半分に過ぎません。残り半分はバージョン要件・再起動検証・セッション分離です。

WeChat アシスタントと Xcode/CI 成果物を同一ノードで運用したい場合は、SFTPMAC のリモート Mac レンタルが現実的な選択肢です。Apple Silicon の統合メモリはマルチエージェント向き、macOS の権限モデルは allowedPaths の絞り込みに向き、バックボーン回線はチャネルコールバック遅延を抑えます。ClawBot を「蓋を閉じたら消える実験」ではなく、途切れない個人アシスタントとして運用できます。