配置模板

提供三个典型场景的 openclaw.json 配置模板，可直接复制使用。

个人使用极简配置

适合个人用户、入门体验，最低成本运行。

{
  "llm": {
    "provider": "anthropic",
    "model": "claude-3-5-haiku-20241022",
    "apiKey": "${ANTHROPIC_API_KEY}",
    "maxTokens": 4096
  },
  "costControl": {
    "enabled": true,
    "limits": { "daily": 5.0, "monthly": 50.0 }
  },
  "server": {
    "port": 8080,
    "host": "localhost"
  }
}

特点：

• 单模型配置，无 Fallback
• 成本上限：每日 $5，每月 $50
• 仅本地访问

小团队推荐配置

适合 2-10 人小团队，支持多模型切换和基本权限控制。

{
  "llm": {
    "fallbackChain": [
      {
        "provider": "anthropic",
        "model": "claude-sonnet-4-6",
        "apiKey": "${ANTHROPIC_API_KEY}",
        "priority": 1
      },
      {
        "provider": "anthropic",
        "model": "claude-3-5-haiku-20241022",
        "apiKey": "${ANTHROPIC_API_KEY}",
        "priority": 2,
        "conditions": "on_rate_limit"
      }
    ]
  },
  "costControl": {
    "enabled": true,
    "limits": { "daily": 30.0, "monthly": 500.0 },
    "alertWebhook": "${SLACK_WEBHOOK}"
  },
  "auth": {
    "enabled": true,
    "provider": "basic",
    "users": [
      { "username": "admin", "password": "${ADMIN_PASSWORD}", "role": "admin" },
      { "username": "user1", "password": "${USER1_PASSWORD}", "role": "user" }
    ]
  },
  "logging": {
    "level": "info",
    "maxFileSize": "100MB",
    "maxFiles": 10
  }
}

特点：

• Fallback 链：Claude Sonnet → Haiku（限流时自动降级）
• 成本告警：超限时通过 Slack Webhook 通知
• 基本身份认证
• 结构化日志

生产环境高可用配置

适合企业生产部署，完整的安全、监控、成本控制。

{
  "llm": {
    "fallbackChain": [
      {
        "provider": "anthropic",
        "model": "claude-sonnet-4-6",
        "apiKey": "${ANTHROPIC_API_KEY}",
        "priority": 1
      },
      {
        "provider": "openai",
        "model": "gpt-5.4",
        "apiKey": "${OPENAI_API_KEY}",
        "priority": 2,
        "conditions": "on_error|on_rate_limit"
      },
      {
        "provider": "deepseek",
        "model": "deepseek-chat",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "baseUrl": "https://api.deepseek.com",
        "priority": 3,
        "conditions": "on_error|cost_limit_exceeded"
      }
    ],
    "fallbackConfig": {
      "maxRetries": 3,
      "retryDelay": 1000,
      "alertOnFallback": true
    }
  },
  "costControl": {
    "enabled": true,
    "limits": {
      "perRequest": 0.1,
      "hourly": 20.0,
      "daily": 100.0,
      "monthly": 2000.0
    },
    "alertWebhook": "${ALERT_WEBHOOK}"
  },
  "security": {
    "inputSanitization": { "enabled": true },
    "rateLimit": {
      "windowMs": 60000,
      "maxRequests": 100
    }
  },
  "server": {
    "port": 8080,
    "host": "0.0.0.0",
    "ssl": {
      "enabled": true,
      "certFile": "/etc/ssl/certs/openclaw.crt",
      "keyFile": "/etc/ssl/private/openclaw.key"
    }
  },
  "monitoring": {
    "healthCheck": {
      "enabled": true,
      "interval": 30
    },
    "metrics": {
      "enabled": true,
      "endpoint": "/metrics"
    }
  }
}

特点：

• 三级 Fallback 链：Claude Sonnet → GPT-5.4 → DeepSeek
• 四层成本控制：单次请求 / 每小时 / 每日 / 每月
• 输入消毒和速率限制
• SSL/TLS 加密
• 健康检查和指标端点
• Fallback 触发时自动告警

配置建议

环境变量管理

所有敏感信息（API Key、密码）应通过环境变量注入，不要硬编码在配置文件中：

# .env 文件（不要提交到 Git）
ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-proj-xxx
DEEPSEEK_API_KEY=sk-xxx
ADMIN_PASSWORD=your-secure-password
ALERT_WEBHOOK=https://hooks.slack.com/services/xxx

如何选择模板

场景	推荐模板	月均成本
个人日常使用	个人极简配置	$5-50
创业团队 / 小公司	小团队配置	$50-500
企业生产环境	生产高可用配置	$500-2,000+

从模板开始定制

1. 复制对应模板到 openclaw.json
2. 设置环境变量
3. 运行 openclaw config validate 验证
4. 根据实际需求调整参数