公式 @tencent-weixin/openclaw-weixin · バージョン行列 · グレー · 八段 Runbook
腾讯 ClawBot が個人微信を OpenClaw に載せる公式経路は、外部チャネルプラグイン @tencent-weixin/openclaw-weixin（チャネル ID：openclaw-weixin）です。OpenClaw 本体リポジトリに Bot を埋め込む方式ではありません。リモート Mac をレンタルして Gateway を動かしているのに「プラグインは入ったが宿主バージョン不適合」「SSH の QR が読めない」「複数アカウントの私信が一つの DM に混ざる」「スマホに ClawBot グレーがない」——そういう壁に当たった方へ、本稿は監査可能な運用の書き方でお届けします。《WeCom OpenClaw 安全ガイド》と直交する個人号の境界、SSH×VNC 判断表、八段 Runbook、チケットに貼れる四つの結論、FAQ です。先に《10分ルートマップ》で CLI/Gateway を通し、微信プラグインを足してください。コンソールを公網に出す予定なら《Gateway 公網 HTTPS 反代》も並行で読み、凭据ディレクトリと 18789 の裸露出を同時に避けてください。
個人微信接続の難所は、宿主バージョン・ログイン媒体・セッション分離・製品グレーの四つに集約されます。モデルの良し悪しは後段です。
宿主とプラグインの二重バージョン：OpenClaw ≥ 2026.3.22 で openclaw-weixin 2.x（npm latest）を入れるべきです。古い宿主に latest を強制すると起動時に宿主バージョン不適合で拒否されます。
扫码は Gateway 同居マシンで：openclaw channels login --channel openclaw-weixin の QR と token は、稼働中 Gateway と同一マシン・同一ユーザ文脈を前提にします。SSH 転送だけだと「扫いたのに別 HOME に書かれた」が起きやすいです。
複数アカウントの私信串線：login を繰り返すとアカウント行が増えます。session.dmScope 未設定だと複数微信号のメッセージが同一 DM 桶に入ります。
能力境界は単聊中心：公式メタデータは群聊を宣言していません。「微信群で @ ボット」で検収しないでください。
ClawBot グレーとチャネルプラグインの併存：スマホ微信「設定」の ClawBot はグレー放量中（8.0.70+ が多い）です。入口がなくても Gateway 側で openclaw-weixin 扫码が使える場合がありますが、製品 UI とチャネル状態は別記録し、チケットを混ぜないでください。
WeCom との混同：個人号プラグインは企業微信の自建アプリ/コールバックではありません。コンプライアンスと凭据轮换は別物です。企業微信专题を参照してください。
Telegram や Discord で慣れたチームほど、微信はモバイルクライアント状態の比重が大きいと見落としがちです。グレーフラグ・クライアント版・launchd と同じ macOS ユーザで扫ったかが「Gateway の不具合」に見えることがあります。モデル調整の前に、チャネル固有の検収語彙を揃えてください。
| 検収動作 | SSH のみ | VNC 推奨 | 合格基準 |
|---|---|---|---|
| openclaw --version / doctor | 十分 | 任意 | 宿主 ≥ 2026.3.22（2.x 時） |
| npx -y @tencent-weixin/openclaw-weixin-cli install | 十分 | 任意 | dist-tag 正しく、衝突なし |
| channels login 扫码 | ASCII QR 誤扫しやすい | 同一ユーザのデスクトップ端末＋スマホ | probe で接続アカウント |
| ClawBot グレー | スマホ UI 不可 | 実機＋版番号をチケット記載 | グレー命中または未命中を明記 |
| pairing allowlist | CLI approve | IM からテスト私信 | 見知らぬ sender は要承認 |
| Gateway 18789 / 反代 | curl 本機 | ブラウザ Network | 扫码デプロイ文同級のループバック/TLS |
個人微信の最低コスト：SSH でプラグインとログ、VNC で同一ユーザ扫码とコンソール互証——どちらか一方ではありません。
OpenClaw を上げた直後にプラグイン冷レジストリが遅い場合は、v2026.4.25 レジストリ repairで CLI/Gateway を同源にしてから openclaw-weixin を入れると、「enabled だが Gateway は旧ビルド」の混合假象を避けられます。
凍結とバックアップ：OpenClaw 設定と状態をエクスポートし、openclaw --version、Gateway ビルド、launchd ユーザを記録します。新環境は10分ルートマップが便利です。
宿主 ≥ 2026.3.22 を確認：不足なら OpenClaw を先に上げるか、インストーラに compat を選ばせます。@latest を手書きしないでください。
推奨：統一インストーラ：npx -y @tencent-weixin/openclaw-weixin-cli install が openclaw --version を見て dist-tag を選び、扫码と再起動を案内します。
手動（再現用）：openclaw plugins install "@tencent-weixin/openclaw-weixin" のあと openclaw config set plugins.entries.openclaw-weixin.enabled true。宿主 < 2026.3.22 で latest 強行は禁止です。
複数アカウント分離：二つ目の微信号を入れる前に openclaw config set session.dmScope per-account-channel-peer を設定し、「アカウント＋チャネル＋対端」で DM を割ります。
同居扫码：Gateway 所在マシンで、デーモンと同一ユーザとして openclaw channels login --channel openclaw-weixin。VNC で QR と確認画面を読みます。凭据はローカル状態（機密）です。
アクセス制御：未知の私信は pairing：openclaw pairing list openclaw-weixin と openclaw pairing approve openclaw-weixin <CODE>。「誰でも Agent 起動」は本番既定にしないでください。
再起動とプローブ：openclaw gateway restart 後 openclaw channels status --probe。ペア済み連絡先から単聊で煙テストし、ログ断片を変更票に添付します。再起動ループ時は OpenClaw とプラグインを対で上げてください。
openclaw --version openclaw doctor npx -y @tencent-weixin/openclaw-weixin-cli install openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config set plugins.entries.openclaw-weixin.enabled true openclaw config set session.dmScope per-account-channel-peer openclaw channels login --channel openclaw-weixin openclaw gateway restart openclaw channels status --probe openclaw plugins list
ClawBot グレー（スマホ）：グレー命中アカウントでは微信「設定」で ClawBot を開き製品手順に従います。リモート Gateway の openclaw-weixin 接続も必須です。グレー外は扫码＋pairing＋probe の監査可能チェーンで検収し、UI 欠如をサーバ障害と誤判定しないでください。
Sidecar が腾讯 iLink API を監視する構成では、補助プロセスが Gateway を誤殺して再起動ループになった事例があります。OpenClaw とプラグインを対でアップグレードしてから安定判定し、ログは openclaw-weixin、ilink、pairing で検索してください。「チャネルに入るが Agent が返さない」は《無応答切り分け》の配送分支と照合します。
個人微信プラグインはアカウント token を Gateway マシンにローカル保存します。このリモート Mac は高感度資産として扱ってください。
ディスクとバックアップ：状態ディレクトリをバックアップ方針に入れる前にアクセス制御を行い、token を含むフォルダを公開クラウドに同期しないでください。
pairing は既定拒否：未 approve の sender が shell/ファイルツールを動かさないようにし、pairing list を定期監査してください。
Gateway 露出：公網反代リストに従い、18789 を無認証で公網に晒さないでください。微信凭据とコンソールは別の安全域で考えます。
ユーザ文脈：SSH ユーザ ≠ VNC デスクトップユーザが最多事故です。デーモン文と同一ユーザ checklist を固めてください。
製品グレー：ClawBot 入口とチャネルプラグインは別進化です。変更票に「スマホグレー命中可否」と「openclaw-weixin probe connected」を分けて書いてください。
| 項目 | VNC 証拠 | SSH 証拠 | 合格 |
|---|---|---|---|
| プラグイン enabled | コンソールに weixin | plugins list | enabled、宿主不適合なし |
| 扫码ログイン | QR 鮮明、スマホ確認 | 状態にアカウント行 | probe: connected |
| 単聊返信 | 微信に助手返信 | 入出站ログ | 往復が SLA 内（短句煙テスト） |
| pairing 遮断 | 見知らぬ私信は実行なし | pairing pending | approve 後のみ応答 |
| ClawBot グレー | 設定スクショ＋版 | N/A（スマホ） | 命中または未命中を文書化 |
リースのリモート Mac では、VNCMac クラスのノードが Gateway・扫码端末・（必要なら）18789 コンソールを同一グラフィカルセッションに載せ、「どの HOME か当てっこ」を二十分の監査可能検収に圧縮します。Windows 主体チームは「SSH 導入＋VNC 扫码＋スマホグレー」の三軌当番を固定し、v2026.4.25 扫码と証拠形式を共有してください。SSH と VNC の両方で echo $HOME を印字してから比較すると、マルチ HOME ホストでのユーザ不一致を早く切れます。
CLI、Gateway、初回対話。
読む →HTTPS、リスン、面最小化。
読む →組織凭据とコンプライアンス。
読む →IM 認可と 18789 検収。
読む →クライアントはグレー段階です。新しめの版と名单が必要です。未命中時は openclaw-weixin 扫码と Gateway probe を通道検収とし、スマホ微信の版とグレー可否をチケットに書いてください。
いいえ。2.x は宿主 ≥ 2026.3.22 です。OpenClaw を上げるか npx -y @tencent-weixin/openclaw-weixin-cli install で compat/legacy を自動選択してください。
違います。本稿は @tencent-weixin/openclaw-weixin の個人号です。WeCom は企業微信安全ガイドをご覧ください。
公式ドキュメントは群聊を能力メタデータで宣言していません。ペア済み連絡先の単聊で検収し、群はリリースノートの更新を待ってください。
QR は出せますが、リモート運用では Gateway デーモンと同ユーザの VNC を強く推奨します。凭据の HOME 誤りを防げます。ClawBot のスマホ設定も実機が必要です。
腾讯 ClawBot と openclaw-weixin は個人微信を OpenClaw に載せる敷居を下げましたが、安定性を決めるのは宿主バージョン行列、同居・同ユーザ扫码、per-account-channel-peer、pairing の安全既定、そして単聊優先・群未宣言の製品境界です。自前 Mac や VPS でもスリープ、出口 IP、複数人のデスクトップ共有で文脈ずれは残ります。レンタルのリモート Apple Silicon では Gateway と扫码端末を同一 VNC デスクトップに置くと、「入ったが私信が来ない」を数時間の口論から二十分の監査可能検収に圧しやすいです。
第六節と同型のグラフィカル扫码とコンソール互証用に VNCMac をご利用ください：購入ページでノードとプランを選び、接続は ヘルプセンター（SSH-VNC）をご確認ください。