> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 推广活动

# `openclaw promos`

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

相关内容：

* 默认模型和回退模型：[模型](/zh-CN/cli/models)
* 提供商身份验证设置：[入门指南](/zh-CN/start/getting-started)

## 命令

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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. 如果你已有提供商凭据，则会复用这些凭据。否则，它会引导你完成提供商的常规身份验证流程（首先输出促销优惠的注册链接，以获取免费密钥）。`--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 重新验证，因此，即使缓存副本仍显示某项优惠，提前撤回的优惠也会被拒绝。