Skip to main content

​
openclaw promos

Descubre y reclama ofertas promocionales de modelos publicadas en ClawHub. Al reclamar una promoción, se configura el proveedor (la autenticación y el Plugin, cuando sea necesario) y se registran los modelos de la promoción, sin volver a ejecutar la incorporación ni cambiar el modelo predeterminado, a menos que así se indique. Relacionado:
  • Modelo predeterminado y alternativas: Modelos
  • Configuración de autenticación del proveedor: Primeros pasos

​
Comandos

​
openclaw promos list

Enumera las promociones activas actualmente, con sus modelos, el modelo predeterminado sugerido, el tiempo restante y el comando exacto para reclamarlas. --json imprime la carga útil sin procesar.

​
openclaw promos claim <slug>

Reclama una promoción activa:
  1. Obtiene la promoción de ClawHub y verifica que esté dentro de su período de vigencia.
  2. Valida el proveedor de la promoción, la opción de autenticación y los paquetes de Plugin declarados con respecto a la versión instalada de OpenClaw. Se rechazan los identificadores desconocidos o las discrepancias de paquetes: una promoción nunca puede hacer que la CLI ejecute algo que no sepa ejecutar de antemano.
  3. Reutiliza las credenciales existentes del proveedor cuando están disponibles. De lo contrario, recorre el flujo de autenticación normal del proveedor (primero muestra la URL de registro de la promoción para obtener una clave gratuita). --api-key <key> completa la autenticación mediante clave de API sin solicitudes interactivas, de acuerdo con las opciones no interactivas de openclaw onboard; para evitar incluir la clave en la línea de comandos, exporta en su lugar la variable de entorno del proveedor (por ejemplo, OPENROUTER_API_KEY). Las credenciales existentes en el entorno se detectan automáticamente y no se necesita ninguna opción.
  4. Registra los modelos de la promoción con sus alias. Los alias existentes nunca se sobrescriben.
  5. Ofrece establecer el modelo sugerido de la promoción como modelo predeterminado: --set-default omite la pregunta; de lo contrario, no se modifica nada de la configuración predeterminada.
Cuando finaliza el período de la promoción, el proveedor deja de ofrecer los modelos gratuitos; la configuración y las credenciales permanecen intactas. Se puede volver al modelo anterior en cualquier momento con openclaw models set <model>.

​
Descubrimiento pasivo en models list

openclaw models list también muestra promociones sin necesidad de consultar ClawHub directamente:
  • Las ofertas activas cuyos modelos no se hayan configurado aparecen en un grupo «Disponibles mediante promoción» debajo de la tabla, cada una con su comando para reclamarla.
  • Los modelos registrados mediante promos claim incluyen una etiqueta promo, que cambia a promo ended cuando finaliza el período de la oferta.
  • La primera vez que se detecta una oferta nueva, un aviso que solo se muestra una vez remite a openclaw promos list. Las ofertas que ya se hayan enumerado o reclamado no se vuelven a anunciar.
Esto lee una copia almacenada localmente en caché del canal de promociones alojado en ClawHub (que normalmente se actualiza una vez al día mediante una solicitud condicional, o antes cuando vence la instantánea almacenada en caché; los errores de actualización se omiten silenciosamente). Una actualización de datos obsoletos espera como máximo 2.5 segundos y nunca interrumpe el listado. La salida de --json y --plain se mantiene limpia para el procesamiento automático: no incluye secciones ni avisos de promociones. Al reclamar una oferta, siempre se vuelve a validar mediante la API activa de ClawHub, por lo que una oferta retirada antes de tiempo se rechaza aunque todavía aparezca en una copia almacenada en caché.