openclaw

关注公众号 jb51net

关闭
AI > openclaw >

配置OpenClaw的模型参数的两种方法

yangzhihua

配置 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 "你好，请介绍一下你自己"

💡 小贴士

到此这篇关于配置OpenClaw的模型参数的两种方法的文章就介绍到这了,更多相关OpenClaw配置模型参数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！