2026 年騰訊微信 ClawBot 官方接入指南：
一條命令安裝、版本門檻與 8 條避坑清單

大陸與港台使用者最常見的訴求不是「再開一個 Telegram」，而是在每天必用的微信裡完成輕量指令：查資料、改文案、觸發 Skills、讓後台 Agent 跑一小段自動化。過去非官方方案的問題集中在三類：

• 合規與帳號風險：模擬用戶端、協議逆向與企業個人號混用，一旦被風控，主號連帶業務群都會受影響。
• 維運不可預測：上游改協議、驗證碼策略或登入態失效，往往需要半夜改腳本，且很難用官方文件定界責任。
• 體驗與產品邊界錯位：把 Telegram 式多 Bot 多開硬套進微信，會話路由與群聊能力容易與產品形態衝突，反而增加狀態錯亂。

官方 ClawBot 走的是微信正規外掛體系：你在微信「設定 → 外掛」裡看到入口，在已執行 OpenClaw 的電腦上執行騰訊發布的 CLI，用手機掃碼完成授權。訊息仍經騰訊側安全鏈路，這意味著穩定性與可預期性顯著提升，但也意味著你必須接受內容審核、單聊形態與部分能力限制——這些不是 Bug，而是產品邊界，下文會逐條拆開。

把 ClawBot 當成「官方通道外掛」，而不是「又一個 IM SDK」：安裝簡單，但權限、審核與微信版本才是上線前真正的驗收項。

評審會上建議用一張表把「誰能用、要不要伺服器、會不會封號」講清楚，避免把個人微信方案與企業微信方案混在同一個專案裡。

個人開發者優先選 ClawBot；需要多人共用、稽核與組織內分發時，再評估企業微信官方外掛，兩條鏈路不要混裝在同一 Gateway 的「試驗設定」裡，以免 Token 與路由規則互相污染。

ClawBot 連接的是你自己的 OpenClaw 實例，不是微信內建的通用大模型。因此上線前必須確認 Gateway 已健康、模型與 Skills 已按你的策略設定完成。下列硬性條件來自騰訊公開教學與社群實測（發版後請以外掛頁說明為準）：

• 微信用戶端：iOS 建議 8.0.70 及以上；Android 版本要求以外掛頁為準，部分地區仍處灰度，看不到入口時不要強行降級協議方案。
• 終端裝置：僅支援手機微信掃碼授權，電腦版微信不能完成綁定流程。
• OpenClaw 執行位置：install 命令在正在執行 Gateway 的 macOS 終端執行（可與 Gateway 同機，或透過 SSH 登入到遠端裸金屬 Mac 的 shell）。
• 網路：手機與執行 CLI 的機器需能完成掃碼回呼；Gateway 若在海外節點，注意模型 API 出站與微信側延遲分別評估，必要時檢視頻寬與路由是否穩定。

典型拓撲有兩種：① 單機——個人 Mac 本機 Gateway + 本機執行 CLI + 手機掃碼；② 遠端 Gateway——在 CALMVPS 裸金屬 Mac 上常駐 Gateway（launchd），你透過 SSH 登入該節點執行 install，手機同樣掃終端輸出的 QR Code。第二種更適合希望微信入口 7×24 線上、而本地筆電經常合蓋的團隊。

官方安裝包透過 npm 分發，命令形如：

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

該包由騰訊微信團隊維護，執行前請在 npm 頁面核對版本與 README；若上游更新命令參數，以外掛詳情頁複製的命令為準。

1. 升級微信：打開「我 → 設定 → 關於微信」，確認版本滿足外掛頁要求（iOS 常見為 8.0.70+），必要時先完成 App Store 更新。
2. 打開外掛入口：返回「設定 → 外掛」，找到「微信 ClawBot」，進入詳情頁複製安裝命令（與上文 npx 命令一致）。
3. 確認 Gateway 線上：在目標 Mac 上執行 openclaw gateway status 或等價健康檢查，確保 Web 控制面與通道服務已啟動；遠端節點請先 SSH 登入再操作。
4. 執行 CLI：在 Gateway 所在環境的終端貼上並執行 npx -y @tencent-weixin/openclaw-weixin-cli@latest install，等待終端輸出 QR Code 或授權連結。
5. 手機掃碼綁定：用手機微信掃描 QR Code，按提示確認授權；綁定的是目前 Gateway 實例，而非某個雲端廠商的共享模型。
6. 驗收通道：在 OpenClaw 控制面檢查 WeChat/微信通道是否在線；若列表無微信項，使用控制面「一鍵更新」並強制重新整理瀏覽器（Mac：Cmd+Shift+R），必要時重啟 Gateway 後再掃一次碼。

綁定成功後，微信會出現「微信 ClawBot」對話視窗。你傳送的文字會進入你已設定的 Agent 路由：外掛入站會走 OpenClaw 的 resolveAgentRoute，按 channel、accountId 與 peer 匹配，而不是寫死單一 main agent。對大多數個人使用者，更穩妥的做法是單一微信號 + 主 Agent 內部調度，由主助手決定呼叫哪個子 Agent，避免在同一對話裡頻繁切換導致會話狀態錯亂。

官方通道的「坑」多半來自產品邊界與安全策略，提前寫入維運手冊可減少誤判為安裝失敗。

• 僅支援單聊：不要在群裡 @ ClawBot；團隊廣播應走企業微信外掛或其它已支援通道。
• 內容審核：訊息經騰訊伺服器安全審核，涉及 DeFi、錢包、crypto 等敏感表述可能被過濾或拒答，這與模型供應商無關。
• 建議小號綁定：OpenClaw 具備系統級能力時，用備用微信號綁定可降低主號社交與支付風險。
• 工作目錄與權限：嚴格限制 Agent 可寫路徑與 system.run 策略，避免把整碟使用者目錄暴露給遠端指令。
• 會話時效：長時間無對話可能觸發通道閒置策略，需在微信裡重新發起一輪對話喚醒。
• Android 灰度：看不到外掛入口時，先確認版本與地區灰度，勿用非官方協議頂替生產流量。
• 檔案回傳限制：部分場景無法透過微信直接傳送處理後的檔案，需要改用郵件、雲端硬碟或其它通道交付產物。
• 控制台通道缺失：優先「一鍵更新」與硬重新整理；仍失敗時對齊 Gateway 與 CLI 版本並查看 Gateway 日誌。

延伸閱讀：騰訊開發者社群關於微信官方 ClawBot 與 OpenClaw 接入的說明文章，便於核對外掛發布時間線與截圖步驟（入庫後請再次打開連結核對是否更新）。

微信官方出手了：一條命令，OpenClaw 直接接入微信

若你希望「微信裡隨時能叫動 Agent」，但本地 Mac 經常睡眠、合蓋或出差斷網，把Gateway 遷到 CALMVPS 裸金屬 Apple Silicon 節點通常比把 CLI 綁在家庭 NAS 上更穩：獨占實體機、launchd 常駐、18789 控制面可稽核，手機 ClawBot 只負責入口，算力與 Skills 在遠端執行。

• 微信 ClawBot 外掛門檻（iOS）：公開教學常見為微信 8.0.70+；外掛入口在「設定 → 外掛」。
• 官方 CLI 套件名稱：@tencent-weixin/openclaw-weixin-cli（透過 npx -y … install 呼叫，版本以 npm 為準）。
• OpenClaw Gateway 預設控制連接埠：18789（與遠端雙機、SSH 隧道文件一致，便於統一排錯）。
• 推薦遠端檔位：多通道 + Cron + 微信入口並存時，Gateway 宿主建議 M4 24GB 起；本地模型或重 Skills 試裝選 M4 Pro；日誌與快取增長快時優先 1TB/2TB 擴容而非盲目升 CPU。

把 Gateway 留在個人筆電上，短板是睡眠打斷、Token 混用與無法 7×24 驗收微信通道；把 OpenClaw 塞進通用 Linux VPS 又缺少 macOS 工具鏈與 TCC 相關能力。對需要穩定 Gateway、官方微信入口與可重現排錯的團隊，CALMVPS 多區域裸金屬 Mac更適合作為 ClawBot 背後的宿主：獨占 Apple Silicon、約 120 秒交付，配合日/週租並聯資源可在不升檔的前提下吸收建置尖峰。機型與價格見 CALMVPS 定價頁。