如何配置OpenClaw的模型参数？

配置 OpenClaw 的模型参数主要分为两个部分：接入模型提供商（配置 API Key 和地址）和调整模型运行参数（如温度、上下文窗口等）

yangzhihua

1156人浏览 · 2026-03-21 16:51:50

yangzhihua · 2026-03-21 16:51:50 发布

配置 OpenClaw 的模型参数主要分为两个部分：接入模型提供商（配置 API Key 和地址）和调整模型运行参数（如温度、上下文窗口等）。

你可以选择命令行配置（推荐，简单快捷）或直接编辑配置文件（适合高级用户）。

🛠️ 方法一：使用命令行配置（推荐新手）

这是最安全的方式，系统会自动处理格式，避免 JSON 语法错误。

1. 接入新模型提供商

假设你要配置通义千问（Qwen）或 MiniMax：

# 1. 设置提供商的 Base URL (以通义千问为例)
openclaw config set models.providers.qwen.baseUrl "https://dashscope.aliyuncs.com/compatible-mode/v1"

# 2. 设置 API Key
openclaw config set models.providers.qwen.apiKey "sk-你的API密钥"

# 3. 设置默认模型 (格式为 提供商ID/模型ID)
openclaw models set qwen/qwen-turbo

2. 修改模型运行参数

你可以直接通过命令行修改具体模型的参数（如温度、最大输出长度）：

# 示例：设置特定模型的温度为 0.7
openclaw config set agents.defaults.models."qwen/qwen-turbo".params.temperature 0.7

# 示例：设置最大输出 Token 数为 4096
openclaw config set agents.defaults.models."qwen/qwen-turbo".params.maxTokens 4096

📝 方法二：直接编辑配置文件（高级）

如果你需要批量配置或进行更细致的调整，可以直接编辑 ~/.openclaw/openclaw.json 文件（Windows 下在 %USERPROFILE%\.openclaw\）。

OpenClaw 支持 JSON5 格式，允许使用注释和尾随逗号。

1. 配置提供商凭证

在 models 节点下添加或修改提供商信息：

{
  "models": {
    "providers": {
      "qwen": { // 提供商标识
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-你的API密钥",
        "models": [
          {
            "id": "qwen-turbo", // 模型ID
            "name": "Qwen Turbo",
            "contextWindow": 32000, // 上下文窗口大小
            "maxTokens": 8192,      // 最大输出长度
            "cost": { "input": 0, "output": 0 } // 计费信息（仅供参考）
          }
        ]
      }
    }
  }
}

2. 配置模型具体参数

在 agents 节点下，你可以针对特定模型设置运行参数（如 Temperature, Top-P 等）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "qwen/qwen-turbo" // 设置默认主模型
      },
      "models": {
        "qwen/qwen-turbo": {
          "alias": "my-ai", // 别名
          "params": {
            "temperature": 0.7,    // 温度 (0-2，越高越随机)
            "maxTokens": 4096,     // 最大输出 Token
            "topP": 0.9,           // 核采样参数
            "topK": 40             // Top-k 采样
          }
        }
      }
    }
  }
}

⚙️ 常用参数详解

参数名	说明	推荐值
temperature	控制随机性。值越低输出越确定，值越高越有创意。	0.7 (通用), 0.2 (代码)
maxTokens	单次回复的最大长度。	4096 或 8192
contextWindow	模型能记住的上下文总量。	根据模型实际能力填写 (如 32000)
topP	另一种控制随机性的方法，通常与 temperature 二选一。	0.9

✅ 验证与生效

保存文件：如果是手动编辑，请确保 JSON 格式正确（无报错）。
重启服务：
虽然 OpenClaw 支持部分热重载，但修改模型配置后，最稳妥的方式是重启网关：
```
openclaw gateway restart
```

测试连接：
运行以下命令测试模型是否配置成功：

openclaw models status --probe
# 或者发送一条测试消息
openclaw agent --message "你好，请介绍一下你自己"

💡 小贴士

国内用户推荐：优先配置 通义千问 (Qwen)、MiniMax 或 Kimi (Moonshot)，连接更稳定且无需特殊网络设置。
免费额度：配置阿里云 Qwen 模型时，注意在控制台开启“免费额度用完即停”开关，避免意外扣费。
多模态：如果需要图片理解能力，请确保选择的模型支持 image 输入，并在配置中正确声明。