配置文件详解

OpenClaw 使用模块化配置系统，所有配置文件都位于 config/ 目录下。

主要配置包括系统设置、模型配置、通道配置、安全设置等。

主配置文件 config/main.json 包含系统的基本设置：

{
  "server": {
    "port": 3000,
    "host": "0.0.0.0",
    "ssl": false,
    "rateLimit": {
      "windowMs": 15 * 60 * 1000,
      "max": 100
    }
  },
  "models": {
    "default": "gpt-4-turbo",
    "temperature": 0.7,
    "maxTokens": 2048
  },
  "database": {
    "type": "sqlite",
    "path": "./data/openclaw.db"
  },
  "logging": {
    "level": "info",
    "file": "./logs/app.log"
  }
}

通过 .env 文件配置敏感信息和环境特定设置：

# API Keys
OPENAI_API_KEY=your_openai_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here

# Server Settings
PORT=3000
HOST=0.0.0.0

# Database
DATABASE_URL=sqlite://./data/openclaw.db

# Security
ENCRYPTION_KEY=your_encryption_key_here
SESSION_SECRET=your_session_secret_here

# Features
ENABLE_TELEMETRY=false
DEBUG_MODE=false

配置验证

启动时系统会自动验证配置的有效性，无效配置将导致启动失败并显示错误信息。

配置重载

某些配置项支持运行时热更新，无需重启服务即可生效。

配置备份

建议定期备份配置文件，以防意外修改或丢失。