跳到主要内容

clawdbot models

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

相关内容：

常用命令​

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

clawdbot models status 显示解析后的默认/回退模型以及身份验证概览。 当提供商使用情况快照可用时，OAuth/令牌状态部分会包含提供商使用情况标头。 添加 --probe 可对每个配置的提供商配置文件运行实时身份验证探测。 探测是真实的请求（可能会消耗令牌并触发速率限制）。

注意事项：

  • models set <model-or-alias> 接受 provider/model 或别名。
  • 模型引用通过在 第一个 / 处拆分来解析。如果模型 ID 本身包含 /（OpenRouter 风格），请包含提供商前缀（例如：openrouter/moonshotai/kimi-k2）。
  • 如果省略提供商，Clawdbot 将输入视为 默认提供商 的别名或模型（仅当模型 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>

别名 + 回退 (Aliases + fallbacks)​

clawdbot models aliases list
clawdbot models fallbacks list

身份验证配置文件 (Auth profiles)​

clawdbot models auth add
clawdbot models auth login --provider <id>
clawdbot models auth setup-token
clawdbot models auth paste-token

models auth login 运行提供商插件的身份验证流程（OAuth/API 密钥）。使用 clawdbot plugins list 查看已安装的提供商。

注意事项：

  • setup-token 在当前机器上运行 claude setup-token（需要 Claude Code CLI）。
  • paste-token 接受在其他地方生成的令牌字符串。