配置文件详解：config.json 核心参数完全指南

前言

OpenClaw 的核心配置文件 config.json 是整个系统的”大脑中枢”，掌握它的配置方法意味着你可以完全掌控 AI 助手的行为模式。本文将深入解析每个核心参数，帮助你从入门到精通。

一、配置文件位置

OpenClaw 的配置文件位于以下路径：

Windows: %USERPROFILE%\.qclaw\config\config.json
macOS/Linux: ~/.qclaw/config/config.json

首次运行 OpenClaw 时会自动生成默认配置。你可以通过以下命令查看配置路径：

openclaw config path

二、核心参数详解

2.1 模型配置 (models)

模型配置决定了 AI 助手的”智力水平”，是最重要的配置之一：

{
  "models": {
    "default": "gpt-4o-mini",
    "fallbacks": ["gpt-4o", "claude-3-sonnet"],
    "providers": {
      "openai": {
        "apiKey": "sk-xxx",
        "baseUrl": "https://api.openai.com/v1"
      }
    }
  }
}

参数说明：

• default：默认使用的模型 ID
• fallbacks：备用模型列表，当主模型不可用时自动切换
• providers：各模型提供商的 API 配置

2.2 监听端口 (port)

Gateway 服务的监听端口，默认为 3000：

{
  "port": 3000
}

如果端口冲突，可以修改为其他可用端口。修改后需重启 Gateway。

2.3 外部访问 (externalUrl)

当需要从外网访问 OpenClaw 时，配置公网地址：

{
  "externalUrl": "https://your-domain.com"
}

这对于 Webhook 回调、Telegram Bot 等功能至关重要。

2.4 插件配置 (plugins)

插件系统是 OpenClaw 的扩展核心：

{
  "plugins": {
    "entries": [
      {
        "name": "telegram",
        "enabled": true,
        "config": {
          "botToken": "YOUR_BOT_TOKEN"
        }
      }
    ]
  }
}

三、高级配置

3.1 安全设置

{
  "security": {
    "allowedOrigins": ["https://your-domain.com"],
    "rateLimit": {
      "windowMs": 60000,
      "maxRequests": 100
    }
  }
}

3.2 日志级别

{
  "logging": {
    "level": "info",
    "file": "~/.qclaw/logs/gateway.log"
  }
}

四、配置验证

修改配置后，使用以下命令验证：

openclaw config validate

如果配置有误，系统会给出详细的错误提示。

五、常见问题

Q1: 修改配置后不生效？

确保重启 Gateway 服务：

openclaw gateway restart

Q2: 如何查看当前配置？

openclaw config get

Q3: 配置文件损坏怎么办？

备份当前配置后重新生成：

openclaw config reset

结语

掌握 config.json 的配置是使用 OpenClaw 的基础技能。建议在实践中逐步调整参数，找到最适合你使用场景的配置组合。记住：每次修改配置后都要重启 Gateway 才能生效！