models status
像看现在主力是谁、替补是谁、他们的工牌是不是还有效。
Cli 导读
用 openclaw models 管理模型发现、认证与回退
先跑 `openclaw models status` 看当前默认模型、回退列表和认证状态，`--probe` 会发真实请求测试认证。设置模型时如果模型 ID 包含斜杠（如 OpenRouter 风格），必须带上 provider 前缀，否则按第一个斜杠拆分会出错。认证配置用 `models auth add` 交互式引导，或 `models auth login --provider <id>` 走 OAuth/API key 流程。
先讲这一页到底在解决什么
用 openclaw models 管理模型发现、认证与回退
先跑 `openclaw models status` 看当前默认模型、回退列表和认证状态，`--probe` 会发真实请求测试认证。设置模型时如果模型 ID 包含斜杠（如 OpenRouter 风格），必须带上 provider 前缀，否则按第一个斜杠拆分会出错。认证配置用 `models auth add` 交互式引导，或 `models auth login --provider <id>` 走 OAuth/API key 流程。
第一站
🎛️ 先记 4 个最常用按钮：看状态、看名单、换主力、扫货架
官方一开头给的四条命令，就是这页的主干。
models list
像翻模型货架名册，看看仓库里都有哪些队员可选。
models set <model-or-alias>
像把某个队员拎出来，贴上“今天你首发”的纸条。
models scan
像拿手电筒去扫仓库，看还有哪些新模型已经上架。
第二站
🪪 status 为什么重要？因为不是每个队员都真的带着能上场的工牌
官方把 auth overview、usage snapshots、probe 都塞进 status，不是在堆功能，而是在回答一个最实际的问题：这个模型今天真的能打吗？
openclaw models status像教练看阵容板：主力是谁、替补是谁、每个人工牌是不是还有效。
--probe像不只看名单，还真的吹哨让队员跑两步。官方提醒这是真请求，可能花 token，也可能撞限流。
--agent <id>像别看全队总名单，只检查某个工位自己那套模型阵容。
marker(...)有时候你看到的不是被掩码的秘密，而是像“OPENAI_API_KEY”“secretref-managed”这种提示牌，意思是系统在告诉你钥匙类型，不是在泄露钥匙本身。
第三站
🏷️ set、alias、fallbacks，像“首发名字、外号和替补顺序”
官方专门讲 provider/model、alias、first slash parsing，是因为模型名字这件事真的很容易写歪。
provider/model
像把球员全名写完整，最不容易认错人。
alias
像给常用队员起外号，喊起来更快。
fallbacks
像主力临时上不了时，替补从谁开始顶上。
按第一个 / 分
官方提醒你只按第一个斜杠切开。像名字里后面还能带小队名，但开头那个斜杠才是“哪家俱乐部”。
第四站
🔐 Auth profiles 这段，其实是在说“给不同模型队员办不同入场证”
登录、setup-token、paste-token 这些动作，都是在管“这位队员凭什么能上场”。
models auth add像新建一个工牌档案夹，准备给某类 provider 放证件。
models auth login --provider ...像按 provider 的规矩去办正式入场证，有的是 OAuth，有的是 API key，有的是复用本地 CLI 登录。
setup-token / paste-token像把别处办好的票据拿过来贴进档案夹，一个是现场引导填，一个是直接把现成票据贴进去。
Anthropic 那条注释
官方特地提醒 setup-token 的兼容性和条款风险，意思像“技术上刷得过门禁，不代表这张票在所有场馆都永远允许这样用”。
第五站
🧪 --check、--probe-provider、--probe-profile 这些，是“体检全队”还是“点名抽查某几个人”
这组参数很多，但全在说探测范围和探测力度。
--check
像给全队做健康检查，并用退出码告诉你是完全没问题、快过期，还是已经不能上场。
--probe-provider <name>
像今天只点名检查某一家 provider 的队员，不查全场。
--probe-profile <id>
像在同一家 provider 里，再精确点到某几张工牌来验。
timeout / concurrency / max-tokens
像给体检队伍安排队列：查多久、几个人同时查、每次测试花多少预算。
最后总结
🎈 把 openclaw models 压成一句话
openclaw models 就像模型仓库的排兵布阵台：挑谁当主力、谁做替补、名字该怎么写、工牌有没有过期，还能真的吹哨测试他们今天能不能上场。