openclaw promos

发现并领取发布在 ClawHub 上的模型促销优惠。领取促销优惠会配置提供商（需要时包括身份验证和插件）并注册促销优惠中的模型——无需重新运行新手引导，也不会更改你的默认模型，除非你明确要求。

相关内容：

• 默认模型和回退模型：Models
• 提供商身份验证设置：入门指南

命令

openclaw promos listopenclaw promos claim <slug>openclaw promos claim <slug> --api-key <key> --set-default

openclaw promos list

列出当前有效的促销优惠，包括其中的模型、建议的默认模型、剩余时间和确切的领取命令。--json 输出原始数据。

openclaw promos claim <slug>

领取有效的促销优惠：

1. 从 ClawHub 获取促销优惠，并验证其处于有效期内。
2. 根据你安装的 OpenClaw 版本，验证促销优惠的提供商、身份验证选项和声明的插件包。未知 ID 或包不匹配的情况会被拒绝——促销优惠绝不会让 CLI 运行任何它尚不知如何执行的内容。
3. 如果你已有提供商凭据，则复用这些凭据。否则，它会引导你完成提供商的常规身份验证流程（首先输出用于获取免费密钥的促销优惠注册网址）。--api-key <key> 可无提示地完成 API 密钥身份验证，与 openclaw onboard 的非交互式标志保持一致；若要避免在命令行中提供密钥，请改为导出该提供商的环境变量（例如 OPENROUTER_API_KEY）——系统会自动检测现有的环境变量凭据，无需使用标志。
4. 注册促销优惠中的模型及其别名。绝不会覆盖现有别名。
5. 询问是否将促销优惠建议的模型设为默认模型——--set-default 会跳过此询问；否则，你的默认设置不会发生任何变化。

促销优惠的有效期结束后，提供商将停止提供免费模型；你的配置和凭据不会受到影响。你可以随时使用 openclaw models set <model> 切换回其他模型。

models list 中的被动发现

openclaw models list 也会显示促销优惠，无需你直接查询 ClawHub：

• 如果有效优惠中的模型尚未配置，它们会显示在表格下方的“可通过促销优惠使用”分组中，每项均附有对应的领取命令。
• 通过 promos claim 注册的模型会带有 promo 标签；优惠有效期结束后，该标签会变为 promo ended。
• 首次发现新优惠时，会显示一次性通知，指向 openclaw promos list。已经列出或领取过的优惠不会再次通知。

此功能读取 ClawHub 托管促销优惠源在本地缓存的副本（通常每天通过条件请求刷新一次；如果缓存快照提前过期，则会更早刷新；刷新失败会被静默跳过）。过期缓存的刷新最多等待 2.5 秒，且绝不会导致列表功能中断。--json 和 --plain 的输出会保持适合机器处理的纯净格式：不包含促销优惠分区或通知。领取时始终会通过实时 ClawHub API 重新验证，因此，即使缓存副本仍显示某项提前撤回的优惠，领取请求也会被拒绝。