openclaw models

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

相关文档：

• 提供者 + 模型：Models
• 提供者认证设置：Getting started

常用命令

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

openclaw models status 显示解析后的默认模型/回退列表以及认证概览。 当提供者使用量快照可用时，OAuth/Token 状态部分会包含提供者使用量标头。 添加 --probe 可对每个已配置的提供者配置文件运行实时认证探测。 探测是真实请求（可能消耗 token 并触发速率限制）。 使用 --agent <id> 可检查已配置 agent 的模型/认证状态。省略时，命令使用 OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR（如果已设置），否则使用配置的默认 agent。

注意事项：

• models set <model-or-alias> 接受 provider/model 或别名。
• 模型引用通过在第一个 / 处分割来解析。如果模型 ID 包含 /（OpenRouter 风格），请包含提供者前缀（示例：openrouter/moonshotai/kimi-k2）。
• 如果省略提供者，OpenClaw 将输入视为别名或默认提供者的模型（仅在模型 ID 中没有 / 时有效）。
• models status 可能在认证输出中为非密钥占位符（例如 OPENAI_API_KEY、secretref-managed、minimax-oauth、oauth:chutes、ollama-local）显示 marker(<value>)，而非将其遮蔽为密钥。

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>（已配置的 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 运行提供者插件的认证流程（OAuth/API 密钥）。使用 openclaw plugins list 查看已安装的提供者。

示例：

openclaw models auth login --provider anthropic --method cli --set-default
openclaw models auth login --provider openai-codex --set-default

注意事项：

• login --provider anthropic --method cli --set-default 复用本地 Claude CLI 登录，并将主要 Anthropic 默认模型路径重写为 claude-cli/...。
• setup-token 提示输入 setup-token 值（使用任意机器上的 claude setup-token 生成）。
• paste-token 接受在其他地方或自动化中生成的 token 字符串。
• Anthropic 政策说明：setup-token 支持是技术兼容性功能。Anthropic 过去曾在 Claude Code 之外阻止某些订阅使用，因此在广泛使用之前请验证当前条款。

小提示：刚养好龙虾后，别忘了跑一次 openclaw models status --probe，确认你的 API 密钥都正常联通——省得聊到一半发现模型认证挂了。