当你的模型不在默认列表，或者你有自己的网关服务时，就需要配置自定义 provider。

1. 自定义提供商的最小结构

在 models.providers 下新增一个键（名字可自定义）：

"models": {
  "mode": "merge",
  "providers": {
    "myprovider": {
      "baseUrl": "https://your-provider.example.com/v1",
      "apiKey": "YOUR_KEY",
      "auth": "api-key",
      "api": "openai-responses",
      "models": [
        {
          "id": "your-model-id",
          "name": "your-model-id",
          "reasoning": true,
          "contextWindow": 200000,
          "maxTokens": 16384
        }
      ]
    }
  }
},

2. 绑定默认模型

在 agents.defaults.model.primary 指向你的模型标识，例如：

"myprovider/your-model-id"

3. 典型场景

  • openclaw配置自己的模型：使用企业内部模型网关
  • openclaw 使用自定义模型：替换默认 OpenAI provider
  • openclaw 添加自定义模型：同一 provider 下新增多个模型

4. 验证流程

openclaw config validate
openclaw gateway restart

聊天内验证：

/model status