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. 導入前チェックリスト
- WeChat クライアント: iOS/Android ≥ 8.0.70(Android は 8.0.69+ から早めの更新を推奨します)。
- OpenClaw ホスト: v2026.3.22 以上を推奨し、
openclaw doctorで extensions と CLI の版を揃えます。 - 常時オンライン: ノート PC のスリープでは本番に不向きです。ログ永続化できるホストが必要です。
- 最小権限ワークスペース: shell/fs プラグインを開く前に
workspaceAccessを絞ります。
4. 五手順:コマンドコピーから会話検証まで
- スマホ WeChat → 自分 → 設定 → プラグイン から公式コマンドをコピーします。
- ゲートウェイホストで
npx -y @tencent-weixin/openclaw-weixin-cli@latest installを実行します。 - QR/アカウント紐付け(本番前はサブアカウントでの試験を推奨します)。
openclaw gateway restart後、gateway statusが ready になるまで待ちます。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 成果物ディレクトリのホワイトリストを一度に満たせます。障害時は status → gateway status --deep → doctor → logs の公式ラダーに沿い、サイト内の gateway restart・pairing・本番セキュリティ記事と併読するのが効率的です。
7. まとめ:正規チャネルと安定ホストの両輪
公式 ClawBot が解くのは「WeChat を合法的に接続できるか」であり、モデルコストやディレクトリ権限、24/7 運用設計の代替ではありません。npx 一行は半分に過ぎません。残り半分はバージョン要件・再起動検証・セッション分離です。
WeChat アシスタントと Xcode/CI 成果物を同一ノードで運用したい場合は、SFTPMAC のリモート Mac レンタルが現実的な選択肢です。Apple Silicon の統合メモリはマルチエージェント向き、macOS の権限モデルは allowedPaths の絞り込みに向き、バックボーン回線はチャネルコールバック遅延を抑えます。ClawBot を「蓋を閉じたら消える実験」ではなく、途切れない個人アシスタントとして運用できます。