moltbot models

作用： 列出已配置的模型和提供商。浏览并选择模型。模型发现、扫描与配置（默认模型、故障转移、认证配置）。

相关：模型提供商、快速入门。

常用命令

运行：

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

moltbot models status 显示解析后的默认/故障转移及认证概览。当有提供商用量快照时，OAuth/令牌状态部分会包含提供商用量标题。加 --probe 会对每个已配置的提供商配置执行实时认证探测。探测为真实请求（可能消耗令牌并触发限流）。说明：

• 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 key）。使用 moltbot plugins list 查看已安装的提供商。说明：

• setup-token 会提示输入 setup-token 值（可在任意机器上用 claude setup-token 生成）。
• paste-token 接受在其他地方或自动化中生成的令牌字符串。