`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 的认证输出中可能会显示 marker(<value>)，用于非敏感的占位符（比如 OPENAI_API_KEY、secretref-managed、minimax-oauth、qwen-oauth、ollama-local），而不是把它们当作密钥遮掩。

`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 插件的认证流程（OAuth / API key）。用 openclaw plugins list 查看已安装的 provider。

注意事项：

setup-token 会提示输入 setup-token 值（在任意机器上用 claude setup-token 生成）。
paste-token 接受从其他地方或自动化流程生成的 token 字符串。
Anthropic 政策说明：setup-token 支持属于技术兼容性。Anthropic 过去曾阻止过部分在 Claude Code 之外的订阅使用，使用前请确认当前条款。