openclaw promos

Descubra e resgate ofertas promocionais de modelos publicadas no ClawHub. Resgatar uma promoção configura o provedor (autenticação e Plugin, quando necessário) e registra os modelos da promoção — sem executar novamente a integração inicial e sem alterar seu modelo padrão, a menos que você solicite.

Relacionado:

• Modelo padrão e fallbacks: Modelos
• Configuração da autenticação do provedor: Primeiros passos

Comandos

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

openclaw promos list

Lista as promoções disponíveis no momento, com seus modelos, a opção padrão sugerida, o tempo restante e o comando exato para resgate. --json imprime o payload bruto.

openclaw promos claim <slug>

Resgata uma promoção disponível:

1. Obtém a promoção no ClawHub e verifica se ela está dentro do período de validade.
2. Valida o provedor, a opção de autenticação e os pacotes de Plugin declarados pela promoção em relação à sua versão instalada do OpenClaw. IDs desconhecidos ou incompatibilidades de pacotes são recusados — uma promoção nunca pode fazer a CLI executar algo que ela ainda não saiba executar.
3. Reutiliza suas credenciais existentes do provedor, caso você as tenha. Caso contrário, conduz você pelo fluxo normal de autenticação do provedor (primeiro exibindo a URL de cadastro da promoção para obter uma chave gratuita). --api-key <key> conclui a autenticação por chave de API sem solicitações, de forma compatível com as opções não interativas de openclaw onboard; para não expor a chave na linha de comando, exporte a variável de ambiente do provedor (por exemplo, OPENROUTER_API_KEY) — as credenciais existentes no ambiente são detectadas automaticamente, sem necessidade de nenhuma opção.
4. Registra os modelos da promoção com seus aliases. Aliases existentes nunca são sobrescritos.
5. Oferece a opção de definir o modelo sugerido pela promoção como seu padrão — --set-default ignora a pergunta; caso contrário, nenhuma configuração padrão será alterada.

Quando o período da promoção termina, o provedor deixa de disponibilizar os modelos gratuitos; sua configuração e suas credenciais permanecem inalteradas. Volte para outro modelo a qualquer momento com openclaw models set <model>.

Descoberta passiva em models list

openclaw models list também exibe promoções sem que você consulte diretamente o ClawHub:

• Ofertas disponíveis cujos modelos você ainda não configurou aparecem em um grupo "Disponíveis via promoção" abaixo da tabela, cada uma com seu comando de resgate.
• Os modelos registrados por meio de promos claim recebem uma tag promo, que muda para promo encerrada quando o período da oferta termina.
• Na primeira vez que uma nova oferta é detectada, um aviso único indica openclaw promos list. Ofertas que você já listou ou resgatou nunca são anunciadas novamente.

Esse recurso lê uma cópia armazenada em cache local do feed de promoções hospedado pelo ClawHub (normalmente atualizada uma vez por dia por meio de uma solicitação condicional, ou antes disso quando o snapshot em cache expira; falhas de atualização são ignoradas silenciosamente). Uma atualização de dados obsoletos aguarda no máximo 2,5 segundos e nunca interrompe a listagem. As saídas de --json e --plain permanecem adequadas para processamento por máquina: sem seções ou avisos de promoções. O resgate sempre faz uma nova validação com a API ativa do ClawHub; portanto, uma oferta retirada antecipadamente é recusada, mesmo que uma cópia em cache ainda a exiba.