想在個人微信裡直接指揮自己養的 OpenClaw，卻分不清微信 ClawBot 外掛與 Gateway 誰該先裝？本文面向 2026 年已跑通或準備跑通 OpenClaw、要用騰訊官方 openclaw-weixin 渠道的開發者，給出安裝前檢查、npx @tencent-weixin/openclaw-weixin-cli install 與手動四步對照、2.0.x / legacy 版本矩陣、多帳號 dmScope，以及微信側單聊/檔案/保活等生產注意事項；並與站內 Telegram 排錯、channels probe、半安裝恢復文分工，避免裝錯階段。
騰訊在 2026 年推出的微信 ClawBot（設定 → 外掛）是官方渠道入口；真正執行技能、呼叫大模型的是跑在你電腦或伺服器上的 OpenClaw Gateway。ClawBot 是微信裡的那根「電話線」——線沒接好，Gateway 再健康也收不到微信訊息。
只裝微信外掛、沒裝 OpenClaw：掃碼可能成功，但沒有任何 Agent 處理 inbound。
OpenClaw 版本過舊：外掛 2.0.x 要求宿主 >=2026.3.22，否則 requires OpenClaw >=2026.3.22 並拒絕載入。
Gateway 未常駐：筆電合蓋、Docker 未設 restart、Linux VPS 未裝 systemd——表現為「昨天還能聊，今天全啞火」。
把 ClawBot 當成騰訊版內建助手：ClawBot 連的是你自己的 OpenClaw 與模型設定，自由度更高，維運責任也在你。
多微信號共用一個會話桶：多帳號登入後未設 session.dmScope，會出現 A 用戶話術回覆給 B。
忽略微信產品限制：官方渠道目前僅單聊、不進群，且檔案處理有「只進不出」等邊界——見第四節。
| 維度 | 官方 ClawBot 外掛 | 企業微信自建應用 | Telegram Bot（OpenClaw 內建） |
|---|---|---|---|
| 適合誰 | 個人快速嘗鮮、單聊自動化 | 團隊、要進群/合規通道 | 海外/開發者社群、群聊門控成熟 |
| 安裝複雜度 | 低：openclaw-weixin-cli + 掃碼 | 高：公網 IP、回呼 URL、可信 IP | 中：Bot Token + pairing |
| 微信版本 | 建議 8.0.70+（外掛入口） | 外掛掃碼關注企業號 | 不適用 |
| 群聊 | 不支援 | 可擴展 | 支援（需 mention 等策略） |
| 排錯專文 | 本文 | 企業微信外掛文件 | 部署後三聯症 |
「能在微信裡發訊息」不等於「渠道已閉環」——外掛 enabled、Gateway restart、probe 通過，三件套缺一不可。
建議順序：先確認 OpenClaw 與 Node 基線（可參考 Node 24 生產部署），再裝微信外掛。若 Gateway 尚不存在，請先讀 半安裝恢復。
檢查宿主版本：openclaw --version；若 < 2026.3.22 且要用外掛 2.0.x，先 openclaw update 或走 legacy 線。
一鍵安裝（推薦）：npx -y @tencent-weixin/openclaw-weixin-cli install — 自動偵測版本、引導掃碼並重啟 Gateway。
手動安裝（等價四步）：openclaw plugins install "@tencent-weixin/openclaw-weixin" → enabled true → channels login --channel openclaw-weixin → gateway restart。
微信端確認：微信 8.0.70+，「我 → 設定 → 外掛」可見 ClawBot；Android 未灰度可透過 CLI 掃碼觸發外掛更新。
多帳號與觀測（可選）：再次 channels login 可增帳號；多號時 session.dmScope per-account-channel-peer；botAgent 僅供日誌歸因。
驗收探針：channels status --probe + doctor --deep；從微信發測試句並 logs --follow。配對/靜默問題讀 channels probe 專文。
# 2026 騰訊微信渠道 — 一鍵 + 驗收 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
提示：npm 在部分地區較慢時，可將 registry 切到鏡像源後再執行 npx；外掛安裝失敗時勿反覆掃碼，先確認 openclaw plugins list 中有條目。
注意：訊息經騰訊官方通道，會經過內容安全審查；生產環境建議用小號綁定、主號僅作觀察。
| 外掛線 | OpenClaw 宿主 | npm dist-tag | 典型報錯 |
|---|---|---|---|
| 2.0.x | >= 2026.3.22 | latest | 宿主過舊 → 升級 OpenClaw |
| 1.0.x | >= 2026.1.0 < 2026.3.22 | legacy | 安裝 @legacy 而非強行升宿主 |
把 Gateway 放在會睡眠的筆電上，微信渠道會在合蓋後集體失聯；獨占、長期在線的 macOS 節點更適合 7×24 微信自動化。若你需要像租 VPS 一樣快速拿到可 SSH 維護、可把「六步 Runbook」寫進標準映像的 Mac 算力與穩定頻寬，NodeMini 的 Mac Mini 雲端租賃通常是更優解：與 遠端 Mac launchd 常駐、iOS CI 同機編排同一維運心智，減少「家裡 Gateway 睡著、公司微信還在等回覆」的割裂體驗。