openclaw promos¶

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

相关文档：

• 默认模型与回退：模型
• 提供商认证设置：入门指南

命令¶

openclaw promos list
openclaw 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. 如果你已有提供商凭据，则会直接复用。否则，它会走提供商的正常认证流程（首先打印促销活动的注册 URL 以获取免费密钥）。--api-key <key> 无需提示即可完成 API 密钥认证，与 openclaw onboard 的非交互式标志一致；为避免密钥出现在命令行中，可以改为导出提供商的环境变量（例如 OPENROUTER_API_KEY）——现有的环境凭据会被自动检测到，无需任何标志。
4. 注册促销活动的模型及其别名。现有别名永远不会被覆盖。
5. 会询问你是否要将促销活动建议的模型设置为你的默认模型——--set-default 可跳过该询问；否则不会更改任何默认设置。

当促销活动的时间窗口结束后，提供商将停止提供免费模型；你的配置和凭据不受影响。随时可以通过 openclaw models set <model> 切换回来。

模型清单与优惠¶

运行 openclaw promos list 可查看当前的优惠及其领取命令。普通的 openclaw models list 读取模型目录时，不会刷新促销信息流、添加促销通知或更改通知状态。已有的已领取模型配置和凭据仍然可用。

领取时会通过 ClawHub 实时 API 重新验证优惠，因此即使旧的缓存副本仍然显示该优惠，已下架的优惠也会被拒绝。

相关文档¶

• CLI 参考
• openclaw models —— 这些促销活动所适用的模型