2026 年騰訊微信 ClawBot 安裝與注意事項： 官方 CLI 綁定、外掛開啟與 OpenClaw 後端部署選型

ClawBot 是騰訊微信團隊為 OpenClaw 提供的官方外掛通道：在執行 OpenClaw Gateway 的機器上執行 @tencent-weixin/openclaw-weixin-cli，終端機產生 QR Code，手機微信掃碼後即可在聯絡人裡與你的 AI 助手對話。與早年「網頁版協定 / 非官方機器人」相比，官方路徑的核心價值是降低封號風險、減少逆向維護成本。

ClawBot 只解決「微信 ↔ Gateway」這一段；模型金鑰、Skills、launchd、TCC 仍須依 OpenClaw 既有流程完成。許多團隊在 QR Code 掃描成功後才發現上游 Gateway 從未 7×24 在線。

在評審或個人試用時，這五類痛點最容易被低估：

• 後端不在線：ClawBot 只解決「微信 ↔ Gateway」這一段；若 OpenClaw 裝在家用 Mac 上且夜間睡眠，掃碼成功也會表現為「發訊息無回覆」。
• 版本門檻：iOS 需 8.0.70+、Android 需 8.0.69+，且必須在「設定 → 功能 → 外掛」中手動開啟 ClawBot，舊版用戶端根本沒有入口。
• 權限與資料路徑：對話內容經微信境內基礎設施處理；OpenClaw 本身又可能具備檔案系統與自動化權限，主號綁定的合規與隱私風險顯著高於小號試用。
• 功能邊界誤判：截至 2026 年 Q2 公開資料，暫不支援群聊、檔案多為「只進不出」、長時間未互動可能影響 AI 主動推送，產品演示前必須對齊預期。
• 與通用安裝文混淆：ClawBot 綁定發生在 Gateway 已健康之後；若跳過 Node 22 + onboard，會在綁定階段浪費大量排障時間。

記憶口訣：「先讓 OpenClaw 7×24 在線，再開微信外掛，最後在 Gateway 機器上跑 weixin-cli」。順序顛倒時，QR Code 與日誌都會指向錯誤方向。

ClawBot 不替代 OpenClaw 部署，只增加 IM 通道。你需要先有一處持續連網、可執行 CLI 的執行面。

綁定指令必須在 Gateway 監聽的同一台主機執行。常見錯誤是從筆電 SSH 跳板後在本機跑 npx install，掃碼成功但訊息路由不到執行個體。

若團隊已在 JEXCLOUD 租用 Mac 跑 OpenClaw，weixin-cli 必須在同一台 Gateway 可達的機器上執行，不要在僅作 SSH 跳板的本機產生 QR Code——否則掃碼成功但訊息路由不到執行個體。

手機端與伺服器端需同時滿足條件，再執行綁定指令。

手機端（微信 ClawBot 外掛）：

1. 將微信更新至 iOS 8.0.70+ 或 Android 8.0.69+（以微信內關於頁為準）。
2. 打開「我」→「設定」→「功能」→「外掛」，找到 ClawBot 並開啟。
3. 建議準備小號用於首次綁定，避免工作主號承擔自動化實驗風險。

伺服器端（OpenClaw Gateway）：

• 確認 openclaw doctor 或健康檢查顯示 Gateway 監聽 127.0.0.1:18789（或你設定的連接埠）。
• Node 執行環境滿足 OpenClaw 要求（見 Node 22 安裝文）。
• 機器可存取 npm registry，以便拉取騰訊官方套件。

npx -y @tencent-weixin/openclaw-weixin-cli@latest install
openclaw doctor
lsof -nP -iTCP:18789 -sTCP:LISTEN

請在與 Gateway 相同的機器上執行 install 指令。終端機顯示 QR Code 後，用微信「掃一掃」並在約 60 秒內確認綁定；過期則重新執行上一行。該 CLI 發佈在 npm 的 @tencent-weixin 作用域下，與社群整理的 騰訊雲開發者社群 ClawBot 教程 一致。綁定成功後，微信聯絡人列表會出現你的 OpenClaw 助手會話。

1. 選定後端：按 §2 矩陣在 Lighthouse、JEXCLOUD 雲端 Mac 或本地 Mac 中選定一種，並完成 OpenClaw 基礎安裝與 Gateway 常駐。
2. 健康檢查：執行 openclaw doctor，確認無 token 缺失、連接埠占用或 launchd 未載入類錯誤。
3. 升級微信並開外掛：滿足版本門檻，在外掛頁開啟 ClawBot。
4. SSH 登入後端機：雲端 Mac 用戶使用控制台 SSH；勿在跳板機上跑綁定 CLI。
5. 執行 weixin-cli：執行 npx -y @tencent-weixin/openclaw-weixin-cli@latest install，用手機微信掃描終端機 QR Code 並在 60 秒內確認。
6. 驗收首條對話：向助手發送純文字「ping」，應在數秒內收到模型回覆；若失敗，先查 Gateway 日誌與執行個體是否仍在執行，再查 QR Code 是否過期重綁。

綁定後可在微信中使用 OpenClaw 的多輪上下文、ClawHub Skills，以及部分部署支援的 /model 切換指令；具體以你執行個體的設定為準。

• 微信用戶端版本門檻：iOS ≥ 8.0.70、Android ≥ 8.0.69（2026 年 3 月前後公開要求，升級後需重啟微信）。
• 官方綁定指令：npx -y @tencent-weixin/openclaw-weixin-cli@latest install，套件作用域 @tencent-weixin，需在 Gateway 同機執行。
• 互動時效：多家社群文件提到，若用戶與助手超過約 24 小時 無互動，AI 主動推送的訊息可能被微信側丟棄；營運類定時提醒需設計為「用戶先開口」或接受遺失。
• 會話形態：公開資料普遍標明僅單聊、暫不支援群聊；企業場景的多人協作仍需企業微信或其他 IM 通道。
• 檔案與媒體：常見描述為可接收圖片/檔案/語音，但處理結果檔案無法經微信回傳（「只進不出」）；交付物應改走郵件、雲端硬碟或內部系統。
• 帳號關係：社群教程提到「一個微信號對應一隻龍蝦」，單執行個體可服務多個綁定微信號；擴容時應在設定層區分會話隔離。

安全注意事項（務必寫入團隊規範）：勿在主號上試執行未審計 Skill；對 OpenClaw 工作區做最小權限；境內傳輸需按公司業務合規評估；若使用 Docker 隔離，仍需保證 Gateway 與 weixin-cli 網路可達。

把 ClawBot 綁在會睡眠的家用 Mac上，微信側看起來「已新增助手」，但訊息會在半夜靜默失敗；綁在超賣、無 SLA 的雜牌 VPS上，則缺少 macOS 通道與可預期的 Apple 自動化路徑。對需要7×24 Gateway、掃碼後長期穩定回覆、並可能與 Xcode / 本地腳本協同的團隊，在 JEXCLOUD 多區域裸機雲端 Mac 上先完成 OpenClaw 安裝再跑 weixin-cli，通常比「本地筆電 + 臨時隧道」更省心：獨占 Apple Silicon、可按專案升級 M4 Pro 與儲存。方案見 JEXCLOUD 定價頁。