故障排查速查表

排障順序固定為：服務狀態 -> 金鑰權限 -> 網路可達性 -> 重啟驗證。

1) Bot 不回覆

openclaw status
openclaw health

再檢查：

1. Bot Token 是否完整
2. allowlist 是否有你的使用者 ID
3. 設定修改後是否重啟 Gateway

2) API 401

常見原因：

• Key 類型錯誤
• API Key 過期或複製不完整
• 模型無權限

3) API 429 或 timeout

建議動作：

1. 降低並發
2. 暫時改用較輕量模型
3. 啟用 fallback 模型

4) 搜尋失效

npm run build:search

部署前必須確認 public/pagefind/ 存在。

5) 常用診斷指令

openclaw status
openclaw health
openclaw gateway restart
npm run build:search

若要看完整繁中流程，可從 /zh-tw/docs/quickstart/ 開始。