models
模型管理命令。
用法
bash
openclaw models [子命令] [选项]openclaw models 是 models status 的别名。
子命令
models list
列出可用模型。
bash
openclaw models list [选项]选项：
--all: 显示所有模型--local: 仅本地模型--provider <name>: 按 provider 过滤--json: JSON 输出--plain: 纯文本输出
models status
显示模型状态和认证信息。
bash
openclaw models status [选项]选项：
--json: JSON 输出--plain: 纯文本输出--check: 检查模式（退出码：1=过期/缺失，2=即将过期）--probe: 实时探测配置的认证配置文件--probe-provider <name>: 探测指定 provider--probe-profile <id>: 探测指定配置文件--probe-timeout <ms>: 探测超时--probe-concurrency <n>: 并发数--probe-max-tokens <n>: 最大 token 数
models set
设置默认模型。
bash
openclaw models set <model>设置 agents.defaults.model.primary。
models set-image
设置默认图像模型。
bash
openclaw models set-image <model>设置 agents.defaults.imageModel.primary。
models aliases
管理模型别名。
bash
openclaw models aliases list [--json] [--plain]
openclaw models aliases add <alias> <model>
openclaw models aliases remove <alias>models fallbacks
管理故障转移模型。
bash
openclaw models fallbacks list [--json] [--plain]
openclaw models fallbacks add <model>
openclaw models fallbacks remove <model>
openclaw models fallbacks clearmodels image-fallbacks
管理图像模型故障转移。
bash
openclaw models image-fallbacks list [--json] [--plain]
openclaw models image-fallbacks add <model>
openclaw models image-fallbacks remove <model>
openclaw models image-fallbacks clearmodels scan
扫描可用模型。
bash
openclaw models scan [选项]选项：
--min-params <b>: 最小参数量--max-age-days <days>: 最大天数--provider <name>: Provider 名称--max-candidates <n>: 最大候选数--timeout <ms>: 超时--concurrency <n>: 并发数--no-probe: 不探测--yes: 自动确认--no-input: 无输入--set-default: 设为默认--set-image: 设为图像模型--json: JSON 输出
models auth
管理认证。
bash
# 交互式添加认证
openclaw models auth add
# 使用 setup-token（推荐用于 Anthropic）
openclaw models auth setup-token --provider anthropic
# 粘贴 token
openclaw models auth paste-token --provider <name> --profile-id <id> --expires-in <duration>models auth order
管理认证顺序。
bash
openclaw models auth order get [--provider <name>] [--agent <id>] [--json]
openclaw models auth order set --provider <name> [--agent <id>] <profileIds...>
openclaw models auth order clear [--provider <name>] [--agent <id>]示例
bash
# 查看模型状态
openclaw models status
# 设置默认模型
openclaw models set anthropic/claude-sonnet-4-20250514
# 添加故障转移模型
openclaw models fallbacks add openai/gpt-4o
# 添加 Anthropic 认证
openclaw models auth setup-token --provider anthropic
# 扫描可用模型
openclaw models scan --set-default