文档
CLI 命令参考
`moltbot models`

`moltbot models`

适用范围

使用本页面当：

  • 需要更改默认模型或查看提供商鉴权状态
  • 需要扫描可用模型/提供商并调试鉴权配置文件

模型发现、扫描和配置（默认模型、回退、鉴权配置文件）。

相关：

常用命令 

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

moltbot models status 显示解析的默认/回退以及鉴权概览。 当提供商使用快照可用时，OAuth/token 状态部分包括 提供商使用标头。 添加 --probe 对每个配置的提供商配置文件运行实时鉴权探测。 探测是真实的请求（可能会消耗 token 并触发速率限制）。

说明：

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

别名 + 回退 

moltbot models aliases list
moltbot models fallbacks list

鉴权配置文件 

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

models auth login 运行提供商插件的鉴权流程（OAuth/API 密钥）。使用 moltbot plugins list 查看安装了哪些提供商。

说明：

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