Saltar al contenido principal

​
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 y sin cambiar tu modelo predeterminado, a menos que así lo indiques. Relacionado:
  • Modelo predeterminado y alternativas: Modelos
  • Configuración de la autenticación del proveedor: Primeros pasos

​
Comandos

​
openclaw promos list

Enumera las promociones activas actualmente, junto 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 validez.
  2. Valida el proveedor de la promoción, la opción de autenticación y los paquetes de plugins declarados con respecto a la versión de OpenClaw instalada. Los identificadores desconocidos o las discrepancias entre paquetes se rechazan: una promoción nunca puede hacer que la CLI ejecute algo que aún no sepa ejecutar.
  3. Reutiliza las credenciales existentes del proveedor si las tienes. De lo contrario, te guía por el flujo de autenticación habitual 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 forma equivalente a 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 por la promoción como predeterminado. --set-default omite la pregunta; de lo contrario, no se modifica ninguna configuración predeterminada.
Cuando finaliza el período de la promoción, el proveedor deja de ofrecer los modelos gratuitos; tu configuración y tus credenciales no se modifican. Puedes cambiar de modelo en cualquier momento con openclaw models set <model>.

​
Descubrimiento pasivo en models list

openclaw models list también muestra promociones sin que consultes ClawHub directamente:
  • Las ofertas activas cuyos modelos no hayas configurado aparecen en un grupo «Disponible mediante promoción» debajo de la tabla, cada una con su comando para reclamarla.
  • Los modelos que registraste 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 nueva oferta, un aviso único señala openclaw promos list. Las ofertas que ya hayas enumerado o reclamado no vuelven a anunciarse.
Esto lee una copia almacenada en caché localmente del canal de promociones alojado en ClawHub (que normalmente se actualiza una vez al día mediante una solicitud condicional, o antes si vence la instantánea almacenada en caché; los errores de actualización se omiten silenciosamente). La actualización de una copia obsoleta espera como máximo 2,5 segundos y nunca interrumpe el listado. La salida de --json y --plain se mantiene apta para el procesamiento automático: no incluye secciones ni avisos de promociones. Al reclamar una oferta, siempre se vuelve a validar con 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é.