openclaw/docs/zh-CN/cli/models.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
你想更改默认模型或查看提供商认证状态 你想扫描可用的模型/提供商并调试认证配置	`openclaw models` 的 CLI 参考（status/list/set/scan、别名、回退、认证）	models	generated_at model provider source_hash source_path workflow 2026-02-01T20:21:16Z claude-opus-4-5 pi 923b6ffc7de382ba25bc6e699f0515607e74877b39f2136ccdba2d99e1b1e9c3 cli/models.md 14

openclaw models

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

相关内容：

• 提供商 + 模型：模型
• 提供商认证设置：快速开始

常用命令

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 不包含 / 时有效）。

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