跳转到主要内容

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