OpenClaw 模型白名单配置

在使用 OpenClaw 时，如果通过 providers 配置了多个模型来源，UI 的模型选择器会显示所有可用模型，这在实际使用中会变得非常混乱。其实 OpenClaw 支持通过 agents.defaults.models 设置白名单，只显示你允许的模型。

配置方法

在 OpenClaw 的 openclaw.json 中，找到 agents.defaults 节点，添加 models 字段：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cloud/MiniMax"
      },
      "models": {
        "cloud/MiniMax": {},
        "minimax/MiniMax-M2.7-highspeed": {},
        "loss/MiniMax": {},
        "api/GPT": {}
      }
    }
  }
}

其中 key 的格式为 <provider>/<model>，对应 models.json 中定义的 provider 名称和模型 ID。{} 可以为空，也可以填入模型的默认参数。

添加配置后重启 Gateway 即可生效：

1

openclaw gateway restart

效果

配置完成后，UI 模型选择器只会显示白名单中的 4 个模型，其他通过 providers 接入的模型不再出现在下拉列表中，界面清爽很多。

适用场景

• 通过 models.json 的 providers 接入多个 API 时
• 不希望用户随意切换到某些高成本或未配置好的模型时
• 简化普通用户的模型选择范围时

记录于 2026-04-13