Skip to main content

​
openclaw promos

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

​
命令

​
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 重新验证，因此，即使缓存副本仍显示某项优惠，提前撤回的优惠也会被拒绝。