2026OpenClawchannels429pluginscredentialsdoctor

2026 年 OpenClaw「通道在線但不回覆」:429/額度、channels 與 plugins.entries 雙開關、credentials 與模型前綴的分層排查

程序在、channels status --probe 綠燈,但 Telegram/Slack 沒回覆:多半是模型 429/前綴channelsplugins.entries 雙開關只改一邊。本文拆四層、給矩陣與工單;併讀 配對4.14 稽核;收束 SFTPMAC 遠端 Mac。

OpenClawchannels429plugins.entriescredentialsdoctor
2026 OpenClaw 通道無回覆 channels probe 429 doctor 遠端 Mac

痛點拆解:把「綠燈」譯成可驗收的狀態機

痛點一:把綠燈當成「已經在推理」。偵測只說明註冊與回撥大致可連;若上游是 429402 或路由失敗,通道層仍可能正常。工單要同附 ACK 與模型 HTTP,勿單一訊號定案。

痛點二:雙開關只改一邊。channels.*.enabledplugins.entries.*.enabled 遷移時易各走各的;常見是 Webhook 仍綠、事件沒進主迴路。兩處截圖寫變更單,並對 4.x 通道文

痛點三:credentials「有資料夾沒有檔案」。空目錄當佔位時,維運易誤以為金鑰已落盤。明訂誰啟動閘道就誰的家目錄解 ~/.openclaw,並在 launchdsystemd 寫死 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.*.enabledfalse 時,事件在邊界丟棄,像有連線沒大腦;常被誤歸在模型。

第三層 模型與政策。providermodelIdfinishReason429 時抄 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 與日誌路徑一致、憑證與交貨邊界清楚,能壓低回歸成本;細節見首頁與服務說明。

下一次合併升級前,先跑通「版號+通道 probe+models statusdoctor」四行基線,再併讀 4.x 穩定化文安裝常駐文