配置指南

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 就会自动用新的设置来运行，非常方便！

ℹ️ 注意：某些核心设置（如端口号）的更改可能仍然需要手动重启。但大部分设置（如模型切换、频道配置）都可以热重载。