痛點拆解:把「綠燈」譯成可驗收的狀態機
痛點一:把綠燈當成「已經在推理」。偵測只說明註冊與回撥大致可連;若上游是 429、402 或路由失敗,通道層仍可能正常。工單要同附 ACK 與模型 HTTP,勿單一訊號定案。
痛點二:雙開關只改一邊。channels.*.enabled 與 plugins.entries.*.enabled 遷移時易各走各的;常見是 Webhook 仍綠、事件沒進主迴路。兩處截圖寫變更單,並對 4.x 通道文。
痛點三:credentials「有資料夾沒有檔案」。空目錄當佔位時,維運易誤以為金鑰已落盤。明訂誰啟動閘道就誰的家目錄解 ~/.openclaw,並在 launchd/systemd 寫死 HOME。
痛點四:模型字串少彙整前綴。走 OpenRouter 等中繼層時,openai/、anthropic/ 前綴差一字就接錯轉接器。務必把路由表截圖與 openclaw models status 輸出併存。
痛點五:配對誤當通道不說話。CLI 與閘道版號漂移或需重綁時,可「回一則後靜音」。先跑 配對文 階梯,再回本文;併讀 4.14 稽核與閘道入口 以免把政策拒絕當模型壞了。
四層訊號:閘道、通道、外掛條目、模型 HTTP
第零層 程序與埠。監聽位址須與反代一致;經 nginx 終止 TLS 時先讀 TLS/WebSocket 生產文,Host 與前綴錯一個,探針可能仍很「健康」。
第一層 通道與 probe。channels status --probe 綠色不保證已入佇。記 probe 與 TLS 節點,分流邊緣抖動。併用工具整合時一併看 MCP 子程序 是否需冷重啟閘道。
第二層 外掛 entries。通道開著、plugins.entries.*.enabled 為 false 時,事件在邊界丟棄,像有連線沒大腦;常被誤歸在模型。
第三層 模型與政策。讀 provider、modelId、finishReason;429 時抄 Retry-After(若有)。敘事對齊 閘道運維與 doctor 分層文。工單四行:版號、probe、雙開關圖、模型 HTTP。
決策矩陣:症狀到首選證據到下一步
| 症狀 | 首選證據 | 高機率根因 | 下一步 |
|---|---|---|---|
| probe 綠、完全無回覆 | 模型日誌沒有請求 | 外掛 entries 關閉或事件沒有入佇 | 核對雙開關與路由前綴 |
| 偶爾只回第一句 | 429 尖峰與佇列丟棄 | 額度或速率限制 | 換金鑰、降併行或走企業合約額度 |
| 一升版就靜音 | 版號在 CLI 與閘道不一致 | 二進位漂移或遷移只搬一半 | 對齊安裝通途與配對流程 |
| 僅單一通道靜音 | 該通道 credentials 的 mtime 很舊 | 憑證沒有刷新或目錄掛在錯的使用者下 | 以執行中使用者重寫入並調整 chmod |
實作步驟:可複製的工單順序
# 0) 把版本寫進工單(範例)
# openclaw --version
# openclaw gateway --version # 以官方文件為準
# 1) 通道與偵測(以官方 CLI 為準)
# openclaw channels status
# openclaw channels status --probe
# 2) 模型與路由(以官方子命令為準)
# openclaw models status
# 3) 結構化體檢
# openclaw doctor
步驟一:凍結變因。記 openclaw.json 相關片段雜湊;勿同時隨手改反代,否則 RCA 難以收斂。
步驟二:驗證雙開關。各通道兩圖:channels.* 與 plugins.entries.*。必要時併讀 閘道安裝常駐。
步驟三:檢查 credentials。列 inode 與檔數;空目錄與 000 權限分欄註明。
步驟四:對前綴與政策。彙整前綴寫成唯一真源表;config.patch 行為併讀 4.14 生產手冊。
步驟五:解 429。抄 retry-after;無則指數退避,勿在尖峰自造重試風暴。
步驟六:重現。短訊重測;存 doctor 摘要(可打碼)與成功 message id。子程序異常則 MCP 文 查洩漏與重啟。
閱讀順序、內部連結與遠端 Mac 的維運價值
建議路線:配對文 → 閘道分層 → 本文 → 反代 TLS;可再補 4.x 文、安裝常駐。跳層易把憑證路徑誤當模型故障。
遠端 Mac:釘 HOME、日誌與 credentials 同邊界,可減睡眠半初始化;與 SFTP/rsync 同機更明顯。4.14 之後動 openclaw.json 前先對 安全稽核與閘道入口;MCP 依 子程序文 清幽靈 stdio。
常見問答與託管結論
probe 綠色為什麼還是沒有回覆?
偵測驗的多半是連通與註冊;當模型呼叫失敗、政策拒答或外掛把事件丟棄時,通道層仍可能看起來沒事。
雙開關最常漏哪一邊?
遷移後只改 channels、沒有改 plugins.entries,或剛好反過來。兩邊都必須有截圖寫入工單,才算完成檢查。
遠端 Mac 能解掉所有 429 嗎?
沒有辦法;但能把 HOME 與日誌釘穩、降低睡眠與 VPN 的變因,讓根本原因更快收斂到真實的額度與路由議題,而不是在裝置狀態上打轉。
價值小結。四層拆開後,多數「不說話」最後都落在模型 HTTP 或雙開關;429 與前綴也是第一輪要對的兩件事。
限制。合約額度不足時必須降併行或做分流,光換硬體不會讓額度魔術變大。
SFTPMAC。長期上線的遠端 Mac、launchd 與日誌路徑一致、憑證與交貨邊界清楚,能壓低回歸成本;細節見首頁與服務說明。
