ClawCN - OpenClaw 中文版

主题

openclaw models ​

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

相关内容:

常用命令 ​

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

openclaw models status 显示已解析的默认模型/回退模型以及认证概览。 当提供商使用快照可用时,OAuth/令牌状态部分会包含 提供商使用情况标头。 添加 --probe 可对每个已配置的提供商配置运行实时认证探测。 探测是真实请求(可能会消耗令牌并触发速率限制)。 使用 --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 ​

选项:

  • --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)

别名 + 回退 ​

bash
openclaw models aliases list
openclaw models fallbacks list

认证配置 ​

bash
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 接受从其他地方生成的令牌字符串或来自自动化的令牌。