模型发现、扫描和配置 (默认模型, 回退, 认证配置文件)。

相关:

• 提供商 + 模型: Models
• 提供商认证设置: Getting started

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

openclaw models status 显示解析的默认/回退加上认证概述。 当提供商使用快照可用时，OAuth/令牌状态部分包括提供商使用头。 添加 --probe 以针对每个配置的提供商配置文件运行实时认证探测。 探测是真实请求 (可能会消耗代币并触发速率限制)。 使用 --agent <id> 检查配置的代理的模型/认证状态。如果省略，命令使用 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR (如果设置)，否则使用配置的默认代理。

注意:

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

选项:

• --json
• --plain
• --check (退出 1=过期/丢失, 2=即将过期)
• --probe (配置的认证配置文件的实时探测)
• --probe-provider <name> (探测一个提供商)
• --probe-profile <id> (重复或逗号分隔的配置文件 ID)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (配置的代理 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 运行提供商插件的认证流程 (OAuth/API 密钥)。使用 openclaw plugins list 查看已安装哪些提供商。

注意:

• setup-token 提示输入 setup-token 值 (在任何机器上使用 claude setup-token 生成它)。
• paste-token 接受在其他地方或通过自动化生成的令牌字符串。