首屏摘要:三類誤判與你要先對齊的前提
誤判 1:把「模型不回消息」當成「spawn 工具丟了」。若提供方返回 401/429 或模型標識寫錯,網關可能根本不會進入工具協商階段;此時應先跑 openclaw models status 與最小對話探針,再查工具白名單。
誤判 2:把 allowAgents 寫在 agents.defaults 頂層。社區 issue 類問題裡常見症狀是日誌顯示 allowed: none:子代理列表未被讀取。修正方式是把策略掛到正確的 subagents 節點下,保存後重啟網關進程讓配置熱區生效。
誤判 3:選用不支持 function calling 的模型。部分擴散/非對話式端點不會暴露工具接口;此時列表裡看不到 sessions_spawn 是能力邊界而非配置筆誤。換用明確支持工具調用的模型做對照實驗。
分層順序與《網關運維》一致:先進程與端口,再外連 API,再通道;本文把工具註冊嵌進同一套節奏,避免在反向代理層和 JSON 層之間來回空轉。
痛點拆解:spawn、allowAgents 與模型能力如何串起來
痛點 1:升級後 schema 遷移未完成。大版本可能調整 openclaw.json 字段位置;若你合併分支時只改了鏡像 tag,舊字段會被靜默忽略。應對:對照發行說明做配置 diff,並在預發用同一份 JSON 跑一遍 doctor。
痛點 2:HTTPS 終止在 Nginx/Caddy 後工具正常但事件偶發斷。WebSocket 與長輪詢路徑若未按《反向代理》放通,會在用戶側表現為「有時能 spawn 有時不能」;需在邊緣日誌與網關日誌間做 request id 對齊。
痛點 3:生產加固與最小權限收緊過頭。《生產加固》中的出站與 Webhook 策略若與內網工具回調衝突,會在 doctor 全綠的情況下仍攔截子會話創建;要單獨為工具 HTTP 回調建立允許列表與審計字段。
痛點 4:安裝路徑混用導致 CLI 與網關版本不一致。同一臺遠程 Mac上既有全局 npm 又有 Docker Compose 時,容易 which openclaw 指向 A、systemd 跑的是 B。先按《安裝路徑對比》統一入口,再談 spawn。
痛點 5:缺少結構化日誌字段。排障應記錄:配置哈希、模型名、工具枚舉結果、拒絕原因碼;否則覆盤只能依賴截圖。
決策矩陣:症狀到動作
| 症狀 | 優先檢查 | 動作 | 站內延伸 |
|---|---|---|---|
| 工具列表無 sessions_spawn | 模型是否支持 tools | 換對照模型;讀 models status | 網關運維 |
| allowed: none | allowAgents 嵌套 | 移到 subagents;重啟網關 | 安裝路徑 JSON 備份 |
| doctor 報錯配置 | JSON 與權限 | 修路徑、chmod、快照回滾 | 安裝對比 |
| 僅公網失敗 | 反代與 CORS | 對齊 allowedOrigins 與 WS 頭 | 反向代理 |
| 出站工具 HTTP 被拒 | SSRF 策略 | 加顯式允許與審計 | 生產加固 |
矩陣強調:工具可見性是模型與策略的交集,不是單一開關。
實操步驟:最小可復現排查(How-to)
在預發執行;修改生產 openclaw.json 前先快照(見安裝文)。
# 1) 網關與 CLI 是否同源
openclaw status
openclaw models status
# 2) 配置與 doctor
openclaw doctor
# 3) 對照:用已知支持 tools 的模型跑一條需 spawn 的任務
# 4) 若仍無工具:檢查 agents.list[].subagents 下 allowAgents 片段
# 5) 查看日誌中工具枚舉與拒因(勿粘貼密鑰)
openclaw logs --follow
Docker 路徑下注意卷掛載是否指向你編輯的那份 JSON;裸機路徑注意 launchd/systemd 工作目錄。
基線與可觀測:寫進值班手冊的三行
(1)每次變更記錄 openclaw.json 的 sha256 與鏡像 tag。(2)告警區分「鑑權失敗」「工具未註冊」「通道無回包」三類,對應不同值班級別。(3)與《2026.3 多通道生產》並聯時,為 PDF/Teams 與 spawn 分流線程池,避免互相餓死。
在團隊同時維護構建產物 SFTP與AI 網關時,把遠程 Mac當作統一宿主可降低上下文切換成本;但若自建多實例,值班手冊與配置漂移成本會快速上升。
FAQ、內鏈與為何考慮託管遠程 Mac
能否完全禁用子代理只保留主會話?
可以,但需評估工作流是否仍滿足自動化範圍;禁用後相關工具應從白名單移除以免誤報。
多租戶共享一臺網關時如何隔離 allowAgents?
按實例拆分配置與 Unix 用戶,結合加固文中的令牌與出站策略;避免混用同一份 openclaw.json。
總結:sessions_spawn 消失優先查模型工具能力與 allowAgents 嵌套;用 status、models status、doctor、logs 順序壓縮排障時間。
侷限:自建多環境網關要持續跟進 schema 與安全基線;SFTPMAC 託管遠程 Mac可把長駐網關與文件投遞入口打包,讓你專注模型與工作流而非深夜比對 JSON diff。
若要在穩定遠程 Mac 上統一跑 OpenClaw 網關與 SFTP 交付,可瞭解 SFTPMAC 套餐與節點區域。
