OpenClawSkills
GitHub
CLI 参考 • 5 分钟阅读

型号

“openclaw models”的 CLI 参考(状态/列表/设置/扫描、别名、后备、身份验证)

模型发现、扫描和配置(默认模型、后备、身份验证配置文件)。

相关:

- 提供商 + 模型:''模型''

- 提供商身份验证设置:''入门''

Tutorial.step

常用命令

Bash
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 中没有 ''/'' 时才有效)。

Tutorial.step

`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>''

Tutorial.step

别名 + 后备

Bash
openclaw models aliases list
openclaw models fallbacks list
Tutorial.step

身份验证配置文件

Bash
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'' 接受其他地方或自动生成的令牌字符串。