OpenClaw 模型管理（官方指令简版）

本篇针对版本 openclaw V2026.3.11

常用查看

openclaw models list --plain
openclaw models status --plain
openclaw config file

新增模型

OpenClaw 目前没有 openclaw models add。
新增 provider 下的模型，官方做法是用 openclaw config set 改配置。

1. 查看当前 provider 模型列表

openclaw config get models.providers.dashscope.models --json

2. 写入新列表（示例）

openclaw config set models.providers.dashscope.models '[{"id":"qwen3.5-plus","name":"Qwen 3.5 Plus","input":["text"]},{"id":"qwen3-max","name":"Qwen 3 Max","input":["text"]}]' --strict-json

3. 设为默认模型（可选）

openclaw models set dashscope/qwen3-max

4. 加入备用模型（可选）

openclaw models fallbacks add dashscope/qwen3.5-plus

修改模型

1. 修改模型别名

openclaw models aliases add qwen35 dashscope/qwen3.5-plus

2. 修改模型字段（示例：改名称）

openclaw config set "models.providers.dashscope.models[0].name" "Qwen 3.5 Plus"

3. 修改默认/备用模型

openclaw models set dashscope/qwen3.5-plus
openclaw models fallbacks remove openai/gpt-4o-mini
openclaw models fallbacks add deepseek/deepseek-chat

删除模型

1. 删除备用模型

openclaw models fallbacks remove dashscope/qwen3-max

2. 删除模型别名

openclaw models aliases remove qwen35

3. 从 provider 模型列表删除项（按索引）

openclaw config unset "models.providers.dashscope.models[1]"

4. 清空全部备用模型（可选）

openclaw models fallbacks clear

模型鉴权（新增 provider 必做）

openclaw models auth login --provider <provider-id>
# 或
openclaw models auth paste-token --provider <provider-id>

部署流程（推荐）

1. 执行新增/删除/修改命令
2. 校验配置

openclaw config validate

3. 重启网关服务

openclaw gateway restart

4. 验证是否生效

openclaw models status --plain
openclaw models status --probe --plain
openclaw gateway status

--probe 会发起真实模型探测请求，可能产生 API 调用。