OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Promos

openclaw promos

Discover and claim promotional model offers published on ClawHub. Claiming a promotion configures the provider (auth and plugin, when needed) and registers the promotion's models — without re-running onboarding and without changing your default model unless you say so.

Related:

Commands

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

openclaw promos list

Lists promotions that are currently live, with their models, the suggested default, time remaining, and the exact claim command. --json prints the raw payload.

openclaw promos claim <slug>

Claims a live promotion:

  1. Fetches the promotion from ClawHub and verifies it is inside its window.
  2. Validates the promotion's provider, auth choice, and declared plugin packages against your installed OpenClaw version. Unknown ids or package mismatches are refused — a promotion can never make the CLI run anything it does not already know how to do.
  3. Reuses your existing provider credentials when you have them. Otherwise it walks the provider's normal auth flow (printing the promotion's signup URL for a free key first). --api-key <key> completes API-key auth without prompts, matching the openclaw onboard non-interactive flags; to keep the key off the command line, export the provider's environment variable instead (for example OPENROUTER_API_KEY) — existing env credentials are detected automatically and no flag is needed.
  4. Registers the promotion's models with their aliases. Existing aliases are never overwritten.
  5. Offers to set the promotion's suggested model as your default — --set-default skips the question; otherwise nothing about your defaults changes.

When the promotion's window ends, the provider stops serving the free models; your configuration and credentials are untouched. Switch back anytime with openclaw models set <model>.

Model inventory and offers

Run openclaw promos list to discover current offers and their claim commands. Ordinary openclaw models list reads the model catalog without refreshing the promotions feed, adding promotion notices, or changing notification state. Existing claimed-model configuration and credentials remain available.

Claiming revalidates the offer against the live ClawHub API, so a withdrawn offer is refused even when an older cached copy still shows it.

Was this useful?
On this page

On this page