設定指南

OpenClaw 的所有設定都集中在一個設定檔裡。讓我們來了解如何自訂它。

📄 設定檔位置

OpenClaw 的主設定檔位於：

~/.openclaw/openclaw.json

這裡的 ~ 代表你的使用者主目錄。比如在 macOS 上，完整路徑通常是 /Users/你的使用者名稱/.openclaw/openclaw.json。

💡 小提示：.openclaw 是一個隱藏資料夾（名稱以點號開頭的資料夾在預設情況下是看不到的）。在 macOS Finder 中按 Command + Shift + . 可以顯示隱藏檔案。在 Linux 中用 ls -a 指令可以看到。

⚙️ 關鍵設定項

下面介紹設定檔中最常用的設定項：

AI 模型選擇

設定預設使用的 AI 模型：

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

你可以把 provider 改為 "openai"、"deepseek" 或 "google"，然後配上對應的模型名稱和 API 金鑰。

工作階段管理

控制 AI 對話的行為：

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "你是一個有用的AI助手..."
  }
}

max_history — 每次對話最多保留多少條訊息紀錄
timeout_minutes — 多少分鐘沒有互動後，自動開始新的對話
system_prompt — AI 的「角色設定」，你可以自訂 AI 的人格

頻道設定

設定各個聊天平台的連線資訊：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 熱重載

OpenClaw 支援熱重載（Hot Reload），意思是你修改設定檔後，不需要重新啟動 OpenClaw，它會自動偵測到變更並套用新的設定。

簡單來說：你只需要編輯儲存設定檔，OpenClaw 就會自動用新的設定來執行，非常方便！

ℹ️ 注意：某些核心設定（如連接埠號）的變更可能仍然需要手動重新啟動。但大部分設定（如模型切換、頻道設定）都可以熱重載。