Files

T

2026-09-10 16:51:14 +08:00

name, description

name	description
configure-models	查/切模型与供应商：openclaw models list 看全量清单、models set 切默认、把上游有本地没登记的模型 id 加进配置（不去戳供应商 /models 端点）。

模型 / 供应商配置

触发：用户说「换模型」「切成 xxx」「现在支持哪些模型」「这个模型不在列表里」，或要登记一个上游已有、本地未配置的模型 id。

1. 查清单用内部命令，别戳供应商端点

openclaw models — 默认模型、fallbacks、alias，加 Auth overview（哪个 provider、密钥来自哪个 profile、掩码值）。
openclaw models list — 全部已配置模型，带列 Model / Input / Ctx / Local / Auth / Tags（Tags 里 default、fallback#N、alias:X、configured 直接可读）。这是权威清单，不需要外部请求。
直接 curl https://<provider>/models 无 key 只会拿到 401（实测 DeepSeek：Authentication Fails (governor)），没有信息量。
密钥在 ~/.openclaw/state/openclaw.sqlite 的 auth profiles（如 deepseek:default，mode=api_key），不在 ~/.openclaw/.env；secrets list 报空是正常的，别据此判断「密钥丢了」。

openclaw models set <provider>/<model-id>      # 例：openclaw models set deepseek/deepseek-flash

输出 Updated config: ~/.openclaw/openclaw.json + Backup: ~/.openclaw/openclaw.json.bak + Default model: ... 即成功。下一轮才生效，当前正在跑的那轮不受影响。

供应商 /models 报的 id 可能和本地登记的不同（实测：上游报 deepseek-flash，本地配置里是 deepseek-v4-flash）。要用上游那个名字就把它登记进来：

读 models.providers.<provider>.models[]；顶层 models.mode 是 "merge"，新增项会合并进内置清单，不用重写全表。
照已有条目的形状加一项：id / name / api / reasoning / input / cost / contextWindow / maxTokens / compat.supportedReasoningEfforts（照抄同系列模型的数值）。
校验 JSON：python3 -c "import json;json.load(open('/root/.openclaw/openclaw.json'))"。
openclaw models set <provider>/<新 id>，再 openclaw models list 确认它带 default,configured。