型号
“openclaw models”的 CLI 参考(状态/列表/设置/扫描、别名、后备、身份验证)
常用命令
openclaw models status openclaw models list openclaw models set <model-or-alias> openclaw models scan
''openclaw models status'' 显示已解决的默认/后备以及身份验证概述。
当提供程序使用情况快照可用时,OAuth/令牌状态部分包括
提供者使用标头。
添加 ''--probe'' 以针对每个配置的提供程序配置文件运行实时身份验证探测。
探测是真实的请求(可能会消耗令牌并触发速率限制)。
使用 ''--agent <id>'' to check model/auth status for configured agent. When omitted,
如果设置了该命令,则使用 ''OPENCLAW_AGENT_DIR''/''PI_CODING_AGENT_DIR'',否则
配置的默认代理。
注意事项:
- ''models set <model-or-alias>'' accepts ''provider/model'' or alias.
- 模型引用通过在''第一个'' ''/'' 上拆分来解析。如果模型 ID 包含 ''/'' (OpenRouter 样式),请包含提供程序前缀(例如:''openrouter/moonshotai/kimi-k2'')。
- 如果省略提供程序,OpenClaw 会将输入视为''默认提供程序''的别名或模型(仅当模型 ID 中没有 ''/'' 时才有效)。
`models status`
选项:
- ''--json''
- ''--plain''
- ''--check''(退出 1=过期/丢失,2=过期)
- ''--probe''(已配置的身份验证配置文件的实时探测)
- ''--probe-provider <name>'' (probe one provider)
- ''--probe-profile <id>'' (repeat or comma-separated profile IDs)
- ''--probe-timeout <ms>''
- ''--probe-concurrency <n>''
- ''--probe-max-tokens <n>''
别名 + 后备
openclaw models aliases list openclaw models fallbacks list
身份验证配置文件
openclaw models auth add openclaw models auth login --provider <id> openclaw models auth setup-token openclaw models auth paste-token
''models auth login'' 运行提供程序插件的身份验证流程(OAuth/API 密钥)。使用
''openclaw plugins list'' 查看安装了哪些提供程序。
注意事项:
- ''setup-token'' 提示输入设置令牌值(在任何计算机上使用 ''claude setup-token'' 生成它)。
- ''paste-token'' 接受其他地方或自动生成的令牌字符串。