openclaw models

模型发现、扫描和配置（默认模型、回退、认证配置文件）。

相关：

• 提供者 + 模型：模型
• 提供者认证设置：入门指南

常用命令

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

openclaw models status 显示已解析的默认/回退以及认证概览。 当提供者使用快照可用时，OAuth/令牌状态部分包括提供者使用头部。 添加 --probe 以对每个配置的认证配置文件运行实时认证探测。 探测是真实请求（可能消耗令牌并触发速率限制）。

注意事项：

• models set <model-or-alias> 接受 provider/model 或别名。
• 模型引用通过拆分第一个 / 来解析。如果模型 ID 包含 /（OpenRouter 风格），请包含提供者前缀（示例：openrouter/moonshotai/kimi-k2）。
• 如果省略提供者，openclaw 将输入视为别名或默认提供者的模型（仅当模型 ID 中没有 / 时有效）。

models status

选项：

• --json
• --plain
• --check（退出 1=过期/缺失，2=即将过期）
• --probe（对配置的认证配置文件进行实时探测）
• --probe-provider <name>（探测一个提供者）
• --probe-profile <id>（重复或逗号分隔的配置文件 ID）
• --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 提示输入 setup-token 值（在任何机器上使用 claude setup-token 生成）。
• paste-token 接受在其他地方或从自动化生成的令牌字符串。