若你已在 Mac 上跑通 OpenClaw，卻仍在 Telegram 或網頁裡跟助理對話，真正缺的是微信這個日常入口。2026 年 3 月起，騰訊微信團隊發布官方 微信 ClawBot 外掛：在「設定 → 外掛」裡開啟後，於執行 Gateway 的機器跑一條 npx 指令、掃碼即可把你自己的 OpenClaw（人格、記憶、Skills、Agent 路由）接到微信單聊。本文面向已完成基礎安裝、準備上生產的讀者：先對照官方外掛與 Wechaty 等非官方路徑的風險，再給決策矩陣、八步跟做清單、能力邊界與合規注意事項，並整理三條以上可寫進變更評審的硬參數。指令與版本門檻請以騰訊開發者社群與 npm 套件說明為準，發版後請重新開啟連結核對。價格見 租用價格頁，下單見 訂購頁，遠端工作階段見 說明中心。
[ SECTION_01 ] // PAIN_MAP 接入微信時最常見的翻車點有哪些
- 繼續用灰色協定：Wechaty、iPad 協定等非官方方案在協定變更或風控收緊時可能整條鏈路失效，且存在封號不確定性；與「官方外掛體系」不是同一風險等級。
- 微信版本未達標：外掛入口依賴較新的用戶端；iOS 需 8.0.70、Android 需 8.0.69 及以上，舊版在「外掛」裡看不到 ClawBot。
- Gateway 未就緒就掃碼：終端機裡
npx安裝成功但 OpenClaw Gateway 未監聽或守護行程未啟動，QR Code 過期後表現為「連上了又掉線」。 - 把主號當試驗田：訊息經境內伺服器轉發並可能觸發內容審核；用日常主微信帳號綁定 ClawBot 會把個人社交與自動化實驗綁在同一帳號上。
- 誤以為支援群聊與雙向檔案：目前產品形態偏單聊助理；檔案能力與 24 小時靜默掉線規則若未讀文件，會在上線第一週就踩坑。
- 筆電睡眠導致「微信裡 AI 不回」：Gateway 跑在會合蓋的 Mac 上，使用者以為 ClawBot 壞了，實際是宿主離線而非外掛故障。
[ SECTION_02 ] // ROUTE_MATRIX 個人微信 ClawBot、企業微信與海外頻道怎麼選
下列矩陣幫助你在立項階段選對通道，避免「裝完才發現不支援群聊」的返工。
| 路徑 | 官方性 | 典型適用 | 主要限制 |
|---|---|---|---|
| 微信 ClawBot 外掛 | 騰訊微信官方外掛 | 個人號、日常單聊助理 | 單聊為主；檔案能力偏「只進不出」；長期無對話可能需重綁 |
| 企業微信 OpenClaw 外掛 | 騰訊企業微信官方 | 團隊機器人、文件與訊息能力 | 需企業微信管理側設定；與個人微信產品形態不同 |
| 社群 Wechaty 等 | 非官方協定 | 歷史試驗、特殊整合 | 協定與封號風險不可控，不建議生產預設項 |
| Telegram / Discord | 各平台官方 Bot API | 海外協作、多 Bot 並行 | 境內日常入口覆蓋弱於微信 |
對需要微信入口的團隊而言，ClawBot 的意義不是「多一個聊天視窗」，而是把已設定好的 OpenClaw 執行面放進日活最高的 IM；前提是 Gateway 側穩定、可稽核，而不是在個人筆電上賭睡眠策略。
[ SECTION_03 ] // INSTALL_RUNBOOK 從 OpenClaw 到微信對話視窗：推薦八步閉環
下列步驟綜合騰訊開發者社群公開教學與 npm 安裝指令整理；若上游更新套件名稱或流程，請以官方文件為準。
https://developer.cloud.tencent.com/article/2648517
https://openclawlaunch.com/zh/wechat-clawbot
- 確認 OpenClaw 已常駐：在目標 Mac 上完成
openclaw onboard --install-daemon或等價守護行程安裝，並用openclaw doctor排除 Gateway 連接埠與 PATH 問題；可參考站內 首跑與 Gateway 清單。 - 升級微信用戶端：在「我 → 設定 → 關於微信」核對版本，iOS 不低於 8.0.70，Android 不低於 8.0.69。
- 開啟外掛入口：「設定 → 外掛」中找到「微信 ClawBot」並打開開關；若無入口，先排除版本與地區灰度因素。
- 在 Gateway 主機執行安裝指令：在與 OpenClaw 相同的使用者環境下執行下列指令（需 Node 與網路可存取 npm）。
- 終端機掃碼綁定：指令輸出 QR Code 後，用已開啟外掛的微信掃描並在手機端確認授權。
- 驗證微信側工作階段：在微信中開啟「微信 ClawBot」對話，傳送探活訊息，確認回覆來自你設定的模型與人格而非微信內建 AI。
- 重啟 Gateway 並複查路由：綁定後執行 Gateway 重啟或
openclaw gateway restart類操作，確認外掛行程與 OpenClaw 路由層resolveAgentRoute行為符合預期（單微信號可多工作階段上下文，多微信號可對應多 Agent）。 - 寫入維運台帳：記錄綁定微信號（建議小號）、綁定時間、npm 套件版本、以及日誌目錄磁碟基線，便於 24 小時掉線或審核告警時快速歸因。
$ npx -y @tencent-weixin/openclaw-weixin-cli@latest install[ SECTION_04 ] // LIMITS_AND_OPS 能力邊界、多 Agent 玩法與生產注意事項
能力邊界（請以目前官方說明為準）：個人微信 ClawBot 側重單聊場景，支援文字、圖片、語音與檔案收發中的可用子集，但不支援群聊作為預設產品能力；部分文件提到檔案只進不出；若超過約 24 小時無對話，連線可能需重新掃碼或刷新綁定。不要把 Telegram 多 Bot 並行經驗直接套到微信上。
多 Agent 推薦兩種玩法：玩法 A——單微信號、主 Agent 內部調度子 Agent（對使用者只有一個對話視窗，體驗最貼近微信習慣）；玩法 B——多個微信號分別綁定不同 Agent（邊界清晰，適合內容、維運分角色）。不建議在同一對話裡頻繁手動切換 Agent 識別，以免工作階段狀態混亂。
- 小號綁定：用備用微信號承接自動化實驗，降低主號社交與審核風險。
- 金鑰與憑證：模型 API Key、工作區路徑仍保存在 Gateway 主機；勿在聊天中貼上生產金鑰。
- 內容審核：流量經騰訊境內基礎設施，需按團隊合規要求限制敏感指令與外傳資料。
- 磁碟與日誌：頻道外掛與 Gateway 日誌成長快，遠端 Mac 上應預留輪替策略；參見 磁碟與守護行程規劃。
- 企業微信：團隊場景可並行評估企業微信官方 OpenClaw 外掛頁，與個人 ClawBot 分開立項。
[ SECTION_05 ] // HARD_FACTS 可引用參數與典型報錯對照
- 微信版本門檻：公開教學要求 iOS 8.0.70+、Android 8.0.69+ 方可在插件列表看到 ClawBot。（來源：騰訊雲開發者社群文章 2648517，發版後請複核）
- 官方安裝指令：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install，由微信團隊維護的 CLI 套件。（來源：同上及 OpenClaw Launch 微信接入頁） - 發布時間線：微信 ClawBot 官方外掛於 2026 年 3 月 前後對外發布，屬正規外掛體系而非第三方 Hook。（來源：社群公開報導，以騰訊公告為準）
- Gateway 連接埠慣例：OpenClaw 除錯與常駐仍常圍繞 18789 回環連接埠；ClawBot 外掛作為頻道入口掛載在已執行的 Gateway 之上。（來源：openclaw/openclaw README）
| 表面症狀 | 優先懷疑 | 最小驗證動作 |
|---|---|---|
| 外掛列表沒有 ClawBot | 微信版本過低、灰度未覆蓋 | 升級用戶端；核對 iOS/Android 版本號 |
| 掃碼後無回覆 | Gateway 未啟動、npm 安裝失敗 | 本機 lsof -nP -iTCP:18789 -sTCP:LISTEN；查看 Gateway 日誌 |
| 隔天突然不回訊息 | 24h 靜默策略、宿主睡眠 | 重新掃碼；將 Gateway 遷到 7×24 遠端 Mac |
| 群聊@無反應 | 產品不支援群聊入口 | 改單聊或評估企業微信外掛路徑 |
[ SECTION_06 ] // PLATFORM_CLOSE 為什麼 ClawBot 更適合跑在 7×24 遠端 Mac 上
ClawBot 解決的是入口，穩定性仍取決於 Gateway 宿主：個人 Mac 合蓋即斷、家用寬頻 NAT 與睡眠策略會讓微信側表現為「AI 失蹤」。虛擬化 VPS 雖能常線上，但對 macOS 原生工具鏈、磁碟 IO 與 OpenClaw Node 能力的貼合度往往不如裸金屬 Mac mini。把 Gateway 與 openclaw-weixin-cli 放在獨占 Apple Silicon 上，再配合日誌輪替與小號綁定，才能把官方外掛的風險控制在「產品規則」層面，而不是「筆電斷電」層面。
若你需要在六地節點中選延遲與租期組合，或從 M4 升級到 M4 Pro 以承載多 Agent 與更重 Skills，可在 NOVAKVM 租用價格頁 對照梯度，在 訂購頁 拉起試驗機跑滿兩個迭代週期。對要把微信入口與 iOS CI、OpenClaw 自動化放在同一維運邊界的工作室而言，NOVAKVM 的 Mac Mini 雲端裸金屬租用通常比湊合家用電腦或不穩定協定方案更適合承接生產形 ClawBot。更多遠端連線策略見 說明中心；頻道與反向代理進階見 OpenClaw 頻道與 Gateway 排障。