2026 OpenClaw 官方快速排查階梯：gateway probe、channels 探測、長上下文 429 與 openclaw.extensions
自架 OpenClaw 閘道時，症狀常像「助理蒸發」。請依維護者快速階梯：先鎖行程身分與 RPC，再以 openclaw doctor 收斂設定，最後才探測訊息通道。2026 常見兩坑是長上下文觸發 HTTP 429，以及 package.json 缺少 openclaw.extensions。本文整理順序、憑證與分裂後設／Docker／遠端設定的對齊方式，避免空轉在反向代理。
文件與子命令拼字會隨小版本調整；旗標以 --help 核對，但順序不變：先證明閘道與 RPC，再談訊息介面。把每階輸出貼進工單，缺少可重播憑證的變更較易被拒絕，rollback 也更清楚。
目錄（TOC）
1. 跳過階梯為何燒掉排查預算
OpenClaw 跨多行程與多層設定；「已連線」也可能是過期權杖或分裂視角，貿然改 TLS／防火牆會毁掉對照實驗。並行修改（設定、金鑰、通道同動）讓二分法失效；429／逾時若未記錄 HTTP 會被誤判成頻道故障；extensions 缺口則讓載入器問題像網路不穩。
- 並行修改會抹除因果敘事並抬高回滾成本。
- 節流沉默若未記錄模型 HTTP，會躲在健康探測背後。
- 宣告缺口讓外掛問題偽裝成網路不穩。
2. 六十秒階梯與必要憑證
工單開頭寫死三件事：服務使用者、HOME、CLI／閘道版本或雜湊；與維運認知不符就先對齊分裂後設資料。
依文件跑 gateway probe，留存延遲、TLS 與 RPC 錯誤分類；再抓 gateway status（監聽、驗證預期、控制通道是否權威）與 openclaw doctor。RPC 仍拒絕時不必堆頻道截圖。
上游合理後才做 channels 探測；doctor 若指遠端 URL／權杖不符，先調遠端矩陣再動訊息權杖。Docker 另記權杖／埠／WS 關閉碼；本機成功、公開端失敗先查 compose／發佈路徑。meta.lastTouchedVersion 跨機不一致先走分裂升級矩陣；探測綠仍幽靈流量再查雙開關與 plugins.entries。階梯輸出進變更票據，缺憑證 patch 宜拒絕。
3. 決策矩陣：症狀對應第一份證據
下列矩陣作為路由函式；未取得閘道與通道憑證前，罕見 MCP 邊角可先略過。
| 主要症狀 | 應先留存的第一份證據 | 較可能的層級 | 下一步動作 |
|---|---|---|---|
| CLI 無法連到閘道 | 探測 stderr、連線逾時 | RPC／監聽／驗證權杖 | 先修 probe 失敗，再碰頻道 |
| Doctor 回報設定漂移 | 已脫敏的 doctor 摘要 | 檔案系統權限或 JSON 合併 | 一次只修一類問題 |
| 探測綠燈、聊天無聲 | 雙開關、plugins.entries | 准入政策 | 依頻道深度文繼續下行 |
| 立即出現 HTTP 429 爆量 | 模型 ID、標頭、並行度 | 供應商配額／方案層級 | 退避、拆分金鑰、縮短上下文 |
| 安裝後外掛消失 | package.json 的 extensions 欄位 | 載入器宣告 | 修套件或加薄包裝層 |
4. 外掛安裝與 openclaw.extensions 契約
載入器仰賴 openclaw.extensions 對應表；缺塊時 npm 仍可成功但執行期像「沒有處理器」。請核對鍵與主版本相容，回報附路徑、semver 與宣告段校驗。
本地修補宜用組織命名空間薄包裝重新匯出上游並補宣告，勿在正式機直接改 node_modules。
# 直接檢視已發佈宣告，避免猜測
jq '.openclaw.extensions // "MISSING"' node_modules/<pkg>/package.json5. 長上下文層級與可執行的 429 緩解
超長上下文常伴隨突發節流；巨大對話、厚重工具輸出或平行扇出會先以附重試提示的 429 現形。請記錄權杖估算、限制並行工具呼叫、分離預備／正式金鑰，重播前裁附件，並核對長上下文模型 ID 與路由是否對應購買權益。
向產品方說明長上下文會拉高尾延遲；退避需搭配可見狀態，避免被誤判離線。
6. 七個有序步驟，保留回滾清晰度
- 凍結範圍，快照 CLI、閘道與容器映像版本（若適用）。
- 執行 gateway probe；失敗時附上完整 stderr 與耗時。
- 收集 gateway status 與環境事實（公開網址、權杖是否存在等）。
- 執行 doctor；先修結構問題再動聊天介接。
- 依介面逐一探測頻道，記錄註冊識別資訊。
- 稽核外掛 的
openclaw.extensions完整性與 semver 對齊。 - 僅在以上完成後 才追配對權杖、反向代理或文件載明的遠端閘道覆寫。
步驟二到四之間若二進位對設定時間戳不一致，先查分裂指標以免幽靈 RPC。
7. 每次值得記錄的數字
建議固定記錄：每週探測延遲分位數、doctor 警告趨勢、模型 429（金鑰／模型 ID／工作區）、外掛安裝對探索成功落差。
8. FAQ 與邊界
問：gateway probe 與健康檢查端點是否重複？答：健康檢查常省略需驗證的 RPC 路徑；探測走 CLI 實際使用的程式通道。
問：是否該在 CI 自動跑 doctor？答：應該；對設定快照回歸設門檻，doctor 在標準組態上退步就擋發佈。
問：舊外掛可否忽略 extensions？硬體升級能否治節流？答：2026 小版本驗證趨嚴；硬體頂多改善並行裕度，配額仍在。
9. 託管遠端 Mac 如何讓階梯更穩
官方階梯把事故變成證據鏈，但筆電休眠、VPN 跳動或凌亂 HOME 仍會插入雜訊；互動使用者與 launchd 服務帳號不一致時，分裂症狀也會回來。
租賃為長連線調校的 Apple Silicon 託管 Mac可固定行程身分與網路，使 probe／doctor／channels 憑證跨日可比；不免除配額或 extensions 契約，但能把救火縮成約二十分鐘例行節奏；評估時看 SSH 身分、權杖輪替與交付銜接。
把閘道放在上行與 Mac 工具鏈旁，見 SFTPMAC 遠端 Mac 租賃。