Integraciones

OpenClaw

OpenClaw es una plataforma de agente IA de código abierto compatible con Telegram, Discord, Slack, Signal y otros canales de mensajería. Apunta su proveedor compatible con OpenAI al endpoint de la plataforma para usar todos los modelos HypersHub con facturación unificada.

¿Por qué usar OpenClaw a través de la plataforma?

Cobertura multicanal

Una configuración conecta simultáneamente Telegram, Discord, Slack y otras plataformas—todos los agentes IA gestionados centralizadamente.

Facturación unificada

Comparte una clave API para todas las llamadas. Consulta uso y facturación en una consola—sin cambiar de cuenta.

Acceso estable

Conectividad directa con baja latencia y sin interrupciones—sin configuración de red adicional.

Requisitos previos

Node.js 22 LTS o superior instalado
Clave API de plataforma generada en la consola
ID de modelo objetivo confirmado como disponible en la consola

Pasos de configuración

Instalar OpenClaw CLI

Instala la última versión de OpenClaw globalmente mediante npm:

Terminal

npm install -g openclaw@latest

Escribir archivo de configuración

Edita ~/.openclaw/openclaw.json y apunta baseUrl del proveedor OpenAI al endpoint de la plataforma:

~/.openclaw/openclaw.json

{
  "env": {
    "OPENAI_API_KEY": "hy-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "providers": {
      "openai": {
        "baseUrl": "https://apiclaw.cc/v1",
        "apiKey": "${OPENAI_API_KEY}"
      }
    }
  }
}

Reemplaza hy-... con tu clave API de plataforma. OpenClaw usa el formato openai/* para referenciar modelos—los IDs de modelo se mapean directamente a los nombres de modelo de la plataforma.

Completar inicialización

Ejecuta el asistente de configuración para instalar el servicio en segundo plano:

Terminal

openclaw onboard --install-daemon

Iniciar y verificar

Abre el panel de control y envía un mensaje para confirmar que la respuesta funciona:

Terminal

openclaw dashboard

También puedes conectar canales como Telegram y verificar enviando un mensaje desde tu teléfono.

IDs de modelo

Cuando models.providers.openai.baseUrl apunta a la plataforma, todas las solicitudes openai/* se enrutan a través de la plataforma. El formato de ID es openai/<ID del modelo>:

ID de modelo en openclaw.json	Proveedor
openai/claude-sonnet-4-6	Anthropic
openai/claude-haiku-4-5	Anthropic
openai/claude-opus-4-6	Anthropic
openai/gpt-5.4	OpenAI
openai/gpt-5.4-mini	OpenAI
openai/deepseek-v4-pro	DeepSeek

Para la lista completa de modelos consulta Modelos y precios.

Fallback multi-modelo

OpenClaw admite fallback automático cuando el modelo principal no está disponible. Combinado con el enrutamiento de alta disponibilidad de la plataforma, la fiabilidad mejora aún más:

~/.openclaw/openclaw.json (fragmento de agents)

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/claude-sonnet-4-6",
        "fallbacks": [
          "openai/claude-haiku-4-5"
        ]
      }
    }
  }
}

Configuración de modelo por canal

Puedes asignar diferentes modelos a distintos canales de mensajería (ej. Telegram, Discord) para equilibrar costo y capacidad:

~/.openclaw/openclaw.json

{
  "telegram": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "openai/claude-haiku-4-5"
        }
      }
    }
  },
  "discord": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "openai/claude-sonnet-4-6"
        }
      }
    }
  }
}

Consejos de uso

Monitoreo de uso

Todas las solicitudes hechas a través de OpenClaw se registran en la página "Uso" de la consola—filtrables por modelo y período, con alertas de presupuesto.

Ver modelos disponibles

Ejecuta openclaw models list --provider openai para listar los modelos disponibles y confirmar que el endpoint de la plataforma está correctamente conectado.

Ejecución multicanal simultánea

Un solo proceso openclaw gateway run puede escuchar en múltiples canales simultáneamente—todos compartiendo una clave API y cuenta de facturación.

Solución de problemas

Error de autenticación 401 / 403

Confirma que OPENAI_API_KEY esté configurada con tu clave API de plataforma (empieza con hy-), y verifica que la clave sea válida con saldo suficiente en la página "API Keys" de la consola.

Modelo no encontrado o inaccesible

Verifica que el ID de modelo use el formato openai/<ID de modelo de plataforma>, ej. openai/claude-sonnet-4-6, y que el ID esté disponible en la lista de modelos de la consola.

Las solicitudes siguen yendo a OpenAI después de configurar baseUrl

Revisa que models.providers.openai.baseUrl esté escrito correctamente y asegúrate de que openclaw.json esté guardado antes de reiniciar el Gateway (openclaw gateway run).