@tencent-weixin/openclaw-weixin）により、OpenClaw はコンプライアンス準拠の公式経路で WeChat 単一チャットに接続できます。版互換行列、クライアント段階的展開、Gateway 宿主の選び方を誤ると、QR ログインは成功するのに Control UI では接続済みなのに実会話で Agent が返信しない、あるいは OpenClaw のマイナーアップグレード後にプラグイン ABI がずれて静かにパケットが落ちる、といった症状が出ます。本文では openclaw-weixin-cli 一括導入、1.0.x/2.0.x と OpenClaw 2026.3.x の対照固定、WeChat 8.0.70+ 要件、7×24 Gateway をクラウド Mac に置く三分法分担を、当番がそのまま写せる形で示します。
WeChat ClawBot 接続で多い五つの誤読パターン
2026 年の WeChat ClawBot 接続面は、macOS Gateway 宿主、OpenClaw コア版、WeChat クライアントの段階展開の三線が重なります。「QR 成功＝本番可用」と見做すと、単一チャット限定、ファイルは入站のみ、24 時間無操作後の能動メッセージがプラットフォーム側で破棄されるといった製品境界を見落とします。より隠れやすいのはプラグイン版の漂移です。1.0.x は >=2026.3.0 かつ <2026.3.22、2.0.x は >=2026.3.22 向け——境界を跨いで gateway restart しないと doctor が緑のまま残ることがあります。変更票では先に下記署名番号を付け、プラグイン巻き戻し、副号差し替え、Gateway のクラウド Mac 移設のどれを取るか決めてください。
非公式 iPad プロトコル橋を公式 ClawBot と同等とみなす：非公式橋は凍結・プロトコル変更リスクが高く、公式プラグインは API 経由で能力境界（単一チャット、ファイル方向、敏感語）が異なります。旧 Runbook は流用できません。
WeChat クライアント版を確認せず QR する：iOS は 8.0.70 以上が前提、Android 8.0.69+ は段階展開中です。低版クライアントはログイン異常やメッセージ非同期の原因になります。
OpenClaw 更新後に openclaw-weixin 大版を同期しない：2026.3.22 が境界です。1.0.x のままだと channels が偽接続に見えることがあり、openclaw --version で 2.0.x へ揃えてください。
グループチャットや企業シーンで ClawBot 応答を期待する：現行は単一チャットのみです。グループ @ 無応答は製品制限であり Gateway 障害ではありません。
本番 Agent を主号に載せ鍵断片を送る：データは国内サーバー経由、敏感語フィルタあり。コンプライアンス上副号を使い、WeChat 内で API Key や内部ネットワーク、顧客情報を送らないでください。
署名を付けてからモデルルートとチャネル方針を触ってください。Gateway をクラウドで一度も受け入れていない場合は OpenClaw クラウド Mac 導入と Lobster ワークフロー で install.sh と常駐を固めます。接続済みなのに無応答のときは チャネル接続済み・無応答 でプロセス層と方針層を分け、WeChat 側の再 QR だけで Gateway のポートや pairing 問題を隠さないでください。
第三者橋、公式 ClawBot、「クラウド Mac Gateway」の三分法マトリクス
2026 年のコミュニティには複数の WeChat 接続案が残りますが、本番選定ではコンプライアンス、能力境界、7×24 到達性を同一表で比較してください。公式 ClawBot はテンセント背書と単一チャット・内容審査を受け入れるチーム向きです。第三者橋はグループやファイル外送に余力がある一方、プロトコルとアカウントリスクを伴います。どちらのメッセージ経路でも、Gateway 制御面はスリープしないクラウド Macに置き、ノートは QR と Control UI に限定するのが 2026 年の実務合意です。
| 観点 | 第三者プロトコル橋 | 公式 openclaw-weixin | クラウド Mac Gateway + 公式 |
|---|---|---|---|
| コンプライアンス | 高リスク、凍結しやすい | 公式プラグイン、副号必須 | 公式同等、宿主が安定 |
| 会話形態 | 実装依存、グループ含むこと多い | 単一チャットのみ | 単一チャット、7×24 常駐 |
| ファイル | 双方向の実装あり | 入站のみ、外送不可 | 公式制限と同じ |
| 導入入口 | プロジェクトごとに異質 | npx @tencent-weixin/openclaw-weixin-cli | クラウド Mac で CLI + LaunchAgent |
| 版耦合 | OpenClaw と弱関連 | 1.0.x / 2.0.x 行列 | Master と同期固定が必要 |
| 2026 推奨 | 本番非推奨 | コンプライアンス単一チャット助手 | 跨リージョン小チーム |
メッセージは公式 ClawBot、制御面はクラウド Mac の loopback。ノートのスリープに WeChat 7×24 を賭けない。
公式プラグインを選んだら、どのクラウド Mac が Gateway を担い、副号の保管責任者、OpenClaw と openclaw-weixin の固定版を文書化します。実験期にローカル Mac で一時 Gateway を立てるのは構いませんが、クラウド Mac Master と同一チャネル資格を同時に刺さないでください。二重消費と静かな欠落が起きます。Windows 開発機が Node のみなら Windows/WSL2 とクラウド Mac Gateway 分担 を参照してください。
openclaw-weixin-cli 一括導入、手動チェーン、版互換マトリクス
推奨入口はテンセント提供の CLI ラッパーです。OpenClaw 済みの宿主上で適合版 @tencent-weixin/openclaw-weixin を取得し config を書き込みます。CI や変更窓では install → enable → channels login → gateway restart の手動チェーンも使えます。事前に OpenClaw >=2026.3.0 を確認し、1.0.x は >=2026.3.0 かつ <2026.3.22、2.0.x は >=2026.3.22 を選びます。WeChat は iOS 8.0.70+ または Android 8.0.69+（段階展開）を用意し、副号で QR してください。
npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config enable channels.openclaw-weixin openclaw channels login --channel openclaw-weixin openclaw gateway restart openclaw channels probe --channel openclaw-weixin openclaw doctor
CLI の @latest は現在の OpenClaw 版から適合プラグインを解決します。変更票で OpenClaw を特定 2026.3.x に固定しているなら、インストール後に openclaw plugins list を wiki に残してください。QR はGateway と同機、または安全なトンネルで Control UI に届く環境で行います。ログイン後、副号から Bot へテキストを送り inbound が Agent に入り、outbound が単一チャットで見えることを確認します。probe 失敗時は openclaw gateway status と openclaw logs のあと、プラグイン大版の境界跨ぎを疑ってください。
メモ：製品制限——単一チャットのみ；ファイルは受信のみで外送不可；24 時間無操作後は能動メッセージが届かない場合があります。データは国内サーバー経由で敏感語フィルタあり。鍵や顧客情報は送らないでください。
六ステップ Runbook：版固定から WeChat 単一チャット試験まで
版三元組を凍結：OpenClaw 版、openclaw-weixin 1.0.x または 2.0.x、WeChat クライアント版（iOS 8.0.70+ / Android 8.0.69+ 段階展開）と副号所有者を記録します。
クラウド Mac に Gateway Master：Lobster 導入記事どおり install.sh、onboard、LaunchAgent。loopback 18789 と gateway status を確認します。
公式プラグイン導入：優先 npx -y @tencent-weixin/openclaw-weixin-cli@latest install。変更窓は手動 plugins install チェーンと出力アーカイブ。
channels login で QR：Gateway 宿主または安全な Control UI 到達下で openclaw channels login --channel openclaw-weixin、副号で認可します。
restart と probe：openclaw gateway restart 後に channels probe と doctor。Windows Node がある場合、remote が Master を指しローカル Gateway と競合しないことを確認します。
単一チャット試験：副号からテキストと入站ファイル（受信のみ検証）を送り、Agent 返信に外送ファイルが含まれないことを確認。ノートを一度スリープさせ、チャネルがクラウド Mac のみに依存することを検証します。
六ステップ完了後、「単一チャットのみ」「ファイル outbound 不可」「24 時間無操作後の能動メッセージ破棄」を当番マニュアルに書き、グループ無応答やファイル外送失敗を Gateway ダウンと誤認しないようにします。Telegram や Discord 等は OpenClaw ネイティブチャネルのまま、WeChat ClawBot と並行するときはtoken と config 節を分離し、merge 時のキー衝突を防いでください。
三本の当番閾値と六リージョンクラウド Mac Gateway 選定
版整合の赤線：OpenClaw が 2026.3.22 を跨いで 24 時間以内に openclaw-weixin が 1.0.x のまま probe が間欠失敗するなら ABI 不一致とみなし、2.0.x へ上げて restart してからモデル変更に進みます。
クライアント段階展開の下限：iOS 8.0.70 未満、Android が 8.0.69+ 段階展開に入っていない場合、副号を本番に接続しない。チケットに「WeChat について」のスクリーンショットと QR 時刻を添付します。
Gateway 分裂受け入れ：Master 復旧後 10 分以内に channels probe を 3 回以上。宿主再起動後 60 秒以内に WeChat 単一チャットで Agent 返信があり、開発ノート常時オンラインに依存しないこと。
注意：閾値は当番連絡用の目安であり、テンセントや OpenClaw の SLA ではありません。敏感語と 24 時間セッション方針は WeChat 当期ルールに従います。
WeChat ClawBot Gateway を個人 Mac や Windows ノートに縛ると、スリープ、OS 更新再起動、ネットワークローミングで webhook が再び切れます。安価な Linux VPS だけでは macOS ツールチェーンと一部チャネルプラグインの近接性に欠けます。裸金属クラウド Mac を Master に openclaw-weixin と 7×24 常駐を載せ、ローカルは QR と Control UI に限定すると、コンプライアンス単一チャット、loopback 規律、予測可能な換え窓のバランスが取れます。安定した WeChat Agent を消費者ハードの常時オンラインに賭けたくないチームには、MESHLAUNCH の Mac Mini クラウドレンタルが現実的です。目標リージョンで日次レンタルから六ステップと宿主再起動を一度通し、状態が固まってから月次にロックする順序をおすすめします。容量と申込は レンタル料金 と ヘルプセンター をご覧ください。
OpenClaw >=2026.3.0 かつ <2026.3.22 は 1.0.x、>=2026.3.22 は 2.0.x です。更新後は gateway restart と channels probe を実行してください。クラウド Mac 初装は Lobster 導入ガイド、申込は 料金ページです。
推奨しません。本番 webhook はクラウド Mac Master に置き、Windows は Node かコンソールに限定します。分裂トポロジは Windows/WSL2 分担 Runbook を参照してください。
現行は単一チャットのみ、ファイルは入站のみ、データは国内サーバー経由で敏感語フィルタあり。副号を使い鍵を送らないでください。7×24 Gateway のクラウド Mac レンタルは レンタル料金をご覧ください。