4.21 models命令

openclaw models 命令用于管理模型发现、配置和身份验证。主要功能包括设置默认模型、查看回退模型以及管理提供商认证配置。

核心命令

状态与发现

# 显示已解析的默认/回退模型及认证概览
openclaw models status

# 显示可用模型
openclaw models list

# 配置默认模型
openclaw models set <model-or-alias>

# 发现模型
openclaw models scan

状态命令选项

选项	说明
--json, --plain	输出格式化
--check	验证认证状态（退出码：1=过期/缺失，2=即将过期）
--probe	实时探测已配置的认证配置文件
--probe-provider <name>	探测特定提供商
--probe-profile <id>	探测特定配置文件
--probe-timeout <ms>	探测超时时间（毫秒）
--probe-concurrency <n>	探测并发数
--probe-max-tokens <n>	探测最大 token 数
--agent <id>	检查已配置代理的状态

别名与回退

查看已配置的别名和回退模型：

# 列出别名
openclaw models aliases list

# 列出回退模型
openclaw models fallbacks list

身份验证管理

认证命令

# 添加新的认证配置
openclaw models auth add

# OAuth/API 密钥登录流程
openclaw models auth login --provider <id>

# 基于令牌的身份验证
openclaw models auth setup-token

# 手动输入令牌
openclaw models auth paste-token

重要说明

模型引用使用第一个正斜杠进行解析；省略提供商时，输入将被视为别名或默认提供商模型（当 ID 中没有 / 时）。