模型

​

openclaw models

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

相关：

• 提供商 + 模型：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 可能会在身份验证输出中针对非机密占位符显示 marker(<value>)（例如 OPENAI_API_KEY、secretref-managed、minimax-oauth、qwen-oauth、ollama-local），而不是将其作为机密进行掩码处理。

​

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 提示输入设置令牌值 (在任意机器上使用 claude setup-token 生成)。
• paste-token 接受在其他地方或通过自动化生成的令牌字符串。
• Anthropic 政策说明：对 setup-token 的支持属于技术兼容性。Anthropic 过去曾阻止部分订阅在 Claude Code 之外的使用，因此在广泛使用前请核实当前的条款。

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。