openclaw models

模型发现、扫描和配置（默认模型、备用模型、认证配置）。

相关文档：

常用命令

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

openclaw models status 会显示已解析的默认模型/备用模型以及认证概览。 当 Provider 使用快照可用时，OAuth/Token 状态部分会包含 Provider 使用情况的头部信息。 添加 --probe 参数可以对每个已配置的 Provider 配置进行实时认证探测。 探测是真实请求（可能会消耗 Token 并触发速率限制）。 使用 --agent <id> 可以检查已配置 Agent 的模型/认证状态。如果省略此参数， 命令会使用 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR 环境变量（如果已设置），否则使用 已配置的默认 Agent。

注意事项：

  • models set <model-or-alias> 接受 provider/model 格式或别名。
  • 模型引用通过第一个 / 分割解析。如果模型 ID 包含 /（OpenRouter 风格），需要包含 Provider 前缀（例如：openrouter/moonshotai/kimi-k2）。
  • 如果省略 Provider，OpenClaw 会将输入视为别名或默认 Provider 的模型（仅在模型 ID 中没有 / 时有效）。

models status

选项：

  • --json
  • --plain
  • --check（退出码 1=已过期/缺失，2=即将过期）
  • --probe（对已配置的认证配置进行实时探测）
  • --probe-provider <name>（探测单个 Provider）
  • --probe-profile <id>（可重复或用逗号分隔的配置 ID）
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
  • --agent <id>（已配置的 Agent ID；覆盖 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR）

别名和备用模型

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 会运行 Provider Plugin 的认证流程（OAuth/API 密钥）。使用 openclaw plugins list 查看已安装的 Provider。

注意事项：

  • setup-token 会提示输入 setup-token 值（在任何机器上用 claude setup-token 生成）。
  • paste-token 接受从其他地方生成的或来自自动化的 Token 字符串。