系統跑歪了怎麼辦？進階設定與除錯心法大全
4 min read
走到這一篇，代表你已經把 OpenClaw 從零搭到有了。恭喜！
最後這篇整理一些讓系統跑得更穩、更好維護的心法。
本篇學習目標
- 知道設定檔在哪，以及兩種編輯方式
- 看懂最小可用設定的結構
- 學會用環境變數安全保管 API key
- 掌握除錯的萬能工具和常見錯誤對照表
- 了解版本選擇的原則
設定檔在哪裡？
~/.openclaw/openclaw.json
格式是 JSON5（可以加註解、行尾逗號，比一般 JSON 友善）。
你可以：
- 在 Control UI 的 Config 頁用表單模式編輯（新手友善）
- 切到 Raw JSON 模式直接改（精準快速）
兩種模式改的是同一份檔案，儲存後都會寫入上面那個路徑。
最小可用設定長什麼樣？
{
"agents": {
"list": [
{ "id": "main", "workspace": "~/.openclaw/workspace-main", "default": true }
]
},
"channels": {
"telegram": {
"enabled": true,
"botToken": "你的 Bot Token"
}
},
"bindings": [
{ "agentId": "main", "match": { "channel": "telegram" } }
]
}能跑起來先，之後再慢慢加功能。
API Key 的正確保存方式
不要把 API key 直接寫在 config 裡（雖然可以，但不好習慣）。
用環境變數更安全：
# 在 .env 或系統環境變數裡設定
ANTHROPIC_API_KEY=sk-ant-xxxxx⚠️ 如果用系統服務（systemd 等）啟動 Gateway，要確認服務有載入
.env，不然助理可能因為找不到 API key 而無法運作（會看到「Shell env off」之類的錯誤）。
除錯的萬能工具
有問題先跑這個：
openclaw logs --follow即時看 log，90% 的問題答案都在裡面。
常見錯誤對照表：
| 錯誤訊息 | 可能原因 |
|---|---|
HTTP 429 |
打 API 太頻繁，觸發 rate limit |
unauthorized |
Token 沒設好，或 gateway.bind 設定問題 |
content tool_use input field required |
模型版本相容性問題，查官方文件 |
| Context 過長被截斷 | 開新 session，或依文件做 compact |
版本選擇：要用哪一個？
| 版本 | 適合誰 |
|---|---|
| Stable（穩定版） | 日常使用，優先選這個 |
| Beta | 想嘗鮮新功能，接受偶爾有 bug |
| Dev | 開發者，想看最新動態 |
💡 重大版本升級前，先備份
~/.openclaw，萬一出問題還能回去。
系列完結！你學到了什麼？
走過這十篇，你已經知道怎麼：
- 認識 OpenClaw 的核心概念
- 安裝並第一次啟動
- 搞定儀表板認證
- 接上 Telegram 等通道
- 用 Skills 讓助理更強
- 管理記憶與工作區
- 多個助理各司其職
- 把 Gateway 部署到 VPS
- 設定排程讓助理自動工作
- 進階設定與除錯（就是本篇）
更多細節，永遠以 docs.openclaw.ai 的官方文件為準。
你的 AI 助理已經準備好了——去讓他為你工作吧！