通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》有关认证配置文件轮换、冷却时间以及它们如何与备用模型交互的说明请参阅 https://blog.csdn.net/hy592070616/article/details/81707766。快速了解提供商及其示例https://blog.csdn.net/hy592070616/article/details/81707766。模型选择的工作原理OpenClaw 按以下顺序选择模型主模型agents.defaults.model.primary或agents.defaults.model。agents.defaults.model.fallbacks中的备用模型按顺序。在切换到下一个模型之前会在提供商内部进行提供商认证故障转移。相关说明agents.defaults.models是 OpenClaw 可使用的模型白名单/目录包括别名。agents.defaults.imageModel仅在主模型无法接受图像时使用。通过agents.list[].model及绑定每个代理的默认设置可以覆盖agents.defaults.model参见 https://blog.csdn.net/hy592070616/article/details/81707766。快速模型策略将主模型设置为您可用的最强最新一代模型。对于成本/延迟敏感的任务和低风险聊天使用备用模型。对于支持工具的代理或不可信输入避免使用较旧/较弱的模型层级。设置向导推荐如果您不想手动编辑配置可以运行入门向导openclaw onboard它可以为常见提供商设置模型和认证包括OpenAI Code (Codex) 订阅OAuth和AnthropicAPI 密钥或claude setup-token。配置键概览agents.defaults.model.primary和agents.defaults.model.fallbacksagents.defaults.imageModel.primary和agents.defaults.imageModel.fallbacksagents.defaults.models白名单 别名 提供商参数models.providers写入models.json的自定义提供商模型引用会被规范化为小写。像z.ai/*这样的提供商别名会规范化为zai/*。提供商配置示例包括 OpenCode位于 https://blog.csdn.net/hy592070616/article/details/81707766。“模型未被允许”以及回复停止的原因如果设置了agents.defaults.models它将成为/model和会话覆盖的白名单。当用户选择不在该白名单中的模型时OpenClaw 会返回Model provider/model is not allowed. Use /model to list available models.这发生在生成正常回复之前因此消息可能感觉像是“没有响应”。解决方法是将模型添加到agents.defaults.models或清除白名单移除agents.defaults.models或从/model list中选择一个模型。白名单配置示例{ agent: { model: { primary: anthropic/claude-sonnet-4-5 }, models: { anthropic/claude-sonnet-4-5: { alias: Sonnet }, anthropic/claude-opus-4-6: { alias: Opus }, }, }, }在聊天中切换模型/model您可以为当前会话切换模型而无需重启/model /model list /model 3 /model openai/gpt-5.2 /model status注意事项/model和/model list是一个紧凑的编号选择器模型系列 可用提供商。在 Discord 上/model和/models会打开一个交互式选择器包含提供商和模型下拉菜单以及提交步骤。/model #从该选择器中选择。/model status是详细视图认证候选者以及配置的提供商端点baseUrlapi模式。模型引用通过在第一个/处分割进行解析。使用/model时请使用provider/model。如果模型 ID 本身包含/OpenRouter 风格您必须包含提供商前缀例如/model openrouter/moonshotai/kimi-k2。如果省略提供商OpenClaw 会将输入视为别名或默认提供商的模型仅在模型 ID 中没有/时有效。完整命令行为/配置https://blog.csdn.net/hy592070616/article/details/81707766。CLI 命令openclaw models list openclaw models status openclaw modelssetopenclaw models set-image openclaw models aliases list openclaw models aliasesaddopenclaw models aliases remove openclaw models fallbacks list openclaw models fallbacksaddopenclaw models fallbacks remove openclaw models fallbacksclearopenclaw models image-fallbacks list openclaw models image-fallbacksaddopenclaw models image-fallbacks remove openclaw models image-fallbacksclearopenclaw models无子命令是models status的快捷方式。models list默认显示已配置的模型。有用的标志--all完整目录--local仅本地提供商--provider按提供商过滤--plain每行一个模型--json机器可读输出models status显示解析后的主模型、备用模型、图像模型以及已配置提供商的认证概览。它还会显示在认证存储中找到的 OAuth 到期状态默认在 24 小时内发出警告。--plain仅打印解析后的主模型。OAuth 状态始终显示并包含在--json输出中。如果已配置的提供商没有凭据models status会打印一个Missing auth部分。JSON 包含auth.oauth警告窗口 配置文件和auth.providers每个提供商的有效认证。使用--check进行自动化缺少/过期时退出代码为1即将过期时为2。认证选择取决于提供商/账户。对于始终在线的网关主机API 密钥通常是最可预测的也支持订阅令牌流程。示例Anthropic setup-tokenclaude setup-token openclaw models status扫描OpenRouter 免费模型openclaw models scan检查 OpenRouter 的免费模型目录并可以选择探测模型的工具和图像支持。关键标志--no-probe跳过实时探测仅元数据--min-params **最小参数规模十亿--max-age-days跳过较旧的模型--provider提供商前缀过滤器--max-candidates备用列表大小--set-default将agents.defaults.model.primary设置为第一个选择--set-image将agents.defaults.imageModel.primary设置为第一个图像选择探测需要 OpenRouter API 密钥来自认证配置文件或OPENROUTER_API_KEY。没有密钥时使用--no-probe仅列出候选模型。扫描结果按以下顺序排序图像支持工具延迟上下文大小参数数量输入OpenRouter/models列表过滤:free需要来自认证配置文件或OPENROUTER_API_KEY的 OpenRouter API 密钥参见 https://blog.csdn.net/hy592070616/article/details/81707766可选过滤器--max-age-days、--min-params、--provider、--max-candidates探测控制--timeout、--concurrency在 TTY 中运行时您可以交互式选择备用模型。在非交互模式下传递--yes接受默认值。模型注册表models.jsonmodels.providers中的自定义提供商会写入代理目录下的models.json默认为~/.openclaw/agents//agent/models.json。除非将models.mode设置为replace否则此文件默认会被合并。匹配提供商 ID 的合并模式优先级代理models.json中已存在的非空baseUrl优先。代理models.json中的非空apiKey仅在当前配置/认证配置文件上下文中该提供商未由 SecretRef 管理时才优先。SecretRef 管理的提供商apiKey值会从源标记刷新环境引用的ENV_VAR_NAME文件/执行引用的secretref-managed而不是持久化已解析的密钥。SecretRef 管理的提供商头值会从源标记刷新环境引用的secretref-env:ENV_VAR_NAME文件/执行引用的secretref-managed。代理中为空或缺失的apiKey/baseUrl回退到配置中的models.providers。其他提供商字段从配置和规范化目录数据中刷新。标记持久化以源为权威OpenClaw 从活动源配置快照解析前写入标记而不是从已解析的运行时密钥值写入。这适用于 OpenClaw 重新生成models.json的任何情况包括openclaw agent等命令驱动的路径。