Ejecutar OpenClaw sin límites con Claude

OpenClaw es un gateway de IA multicanal que conecta Claude con más de 50 canales de mensajería mediante una arquitectura de núcleo y radios. Cada canal es un endpoint de inferencia independiente: los bots de Telegram, los servidores de Discord, los espacios de trabajo de Slack, los widgets web y las integraciones personalizadas se conectan a través de un gateway central que se ejecuta en tu infraestructura. Con habilidades inyectadas en los prompts del sistema y canales que nunca se cierran, OpenClaw supone un consumo de API continuo y permanente que crece de forma lineal con el número de canales y usuarios activos.

La arquitectura siempre activa de OpenClaw

OpenClaw funciona como un gateway con arquitectura de núcleo y radios. El núcleo es un proceso central (que normalmente se ejecuta en un VPS en el puerto 18789) que gestiona la configuración de los modelos, la inyección de habilidades y el enrutamiento de solicitudes. Los radios son conectores de canales: cada uno mantiene una conexión persistente con una plataforma de mensajería y reenvía los mensajes entrantes al núcleo para realizar la inferencia.

Cada canal es un grifo de inferencia abierto. Cuando un usuario envía un mensaje en cualquier plataforma conectada, el conector del canal lo reenvía al núcleo, que construye el prompt completo (prompt del sistema + habilidades + historial de conversación + mensaje del usuario), lo envía a Claude y transmite la respuesta al canal en streaming. No hay colas ni procesamiento por lotes: cada mensaje recibe una inferencia inmediata.

El gateway nunca duerme. Mientras el proceso esté en ejecución, los más de 50 canales permanecen activos y cualquier mensaje entrante desencadena una llamada a la API de Claude. A diferencia de las herramientas interactivas, que solo consumen tokens cuando un desarrollador está trabajando, OpenClaw consume tokens cada vez que cualquier usuario envía un mensaje en cualquier canal, lo que en despliegues activos supone cientos o miles de llamadas al día. Esto hace que el acceso ilimitado no solo sea cómodo, sino también económicamente necesario para despliegues de envergadura.

Configuración del proveedor en openclaw.json

La configuración de modelos de OpenClaw se encuentra en ~/.openclaw/openclaw.json, dentro del bloque models.providers. Cada entrada de proveedor requiere un nombre, el campo api (que MUST establecerse explícitamente en 'anthropic-messages' para Claude; no se asigna de forma predeterminada), baseUrl apuntando a tu gateway y apiKey para la autenticación. El campo api controla el formato de solicitud que utiliza OpenClaw.

Establece baseUrl en https://aiprimetech.io (host raíz, sin /v1; el controlador de anthropic-messages añade la ruta correcta). Para apiKey, puedes usar valores directos o interpolación de variables de entorno con la sintaxis ${ENV_VAR}. La interpolación resulta útil para mantener los secretos fuera del archivo de configuración: establece apiKey en '${UNLIMITED_API_KEY}' y exporta la variable en tu shell o unidad de systemd.

También puedes especificar cabeceras personalizadas en la configuración del proveedor. Usa el campo headers para pasar indicadores anthropic-beta o cabeceras de enrutamiento personalizadas. Por ejemplo, headers: {'anthropic-beta': 'max-tokens-3-5-sonnet-2024-07-15'} habilita una salida ampliada para los modelos compatibles. En el gateway ilimitado, las cabeceras estándar funcionan sin modificaciones.

Entradas de modelos y requisito del campo api

Un detalle crítico en la configuración de OpenClaw: el campo api de cada entrada de modelo MUST establecerse explícitamente en 'anthropic-messages'. Si se omite, OpenClaw usa de forma predeterminada un formato genérico de completado que es incompatible con Claude. Esto provoca errores crípticos que parecen fallos de conexión, pero que en realidad se deben a incompatibilidades de formato. Incluye siempre api: 'anthropic-messages' en cada entrada de modelo de Claude.

Define las entradas de modelos en models.models dentro de openclaw.json. Cada entrada hace referencia a un proveedor por su nombre y especifica el ID del modelo. Crea entradas para cada variante de Claude: claude-sonnet-4-5 como opción predeterminada para la mayoría de los canales, claude-opus-4-6 para los canales que necesitan un razonamiento más profundo y claude-haiku-4-5 para los canales de gran volumen donde la velocidad importa más que la profundidad.

Asigna modelos a los canales en la configuración de canales. Cada canal puede usar un modelo diferente: un canal de atención al cliente podría usar Sonnet para obtener respuestas equilibradas, un canal técnico podría usar Opus para explicaciones complejas y un canal de notificaciones podría usar Haiku para confirmaciones rápidas. Con el acceso ilimitado, asigna los modelos según las necesidades de calidad sin tener en cuenta el coste.

Gateway con arquitectura de núcleo y radios en el puerto 18789

El gateway de OpenClaw suele ejecutarse en el puerto 18789 (configurable en openclaw.json, en server.port). Expone una API REST que los conectores de canales utilizan para enviar mensajes y recibir respuestas. El gateway gestiona internamente la construcción de prompts, la selección de modelos, la gestión del historial de conversación y la transmisión de respuestas en streaming.

Despliega el gateway en un VPS con alta disponibilidad: debe estar en ejecución 24/7 para que los canales sigan respondiendo. Usa systemd o Docker para garantizar el reinicio automático en caso de fallo. El proceso consume pocos recursos de CPU y memoria; el cuello de botella siempre es la latencia de las llamadas a la API ascendente, más que el procesamiento local. Un VPS pequeño (1 CPU, 1 GB de RAM) gestiona decenas de canales simultáneos sin problemas.

El gateway mantiene los historiales de conversación en memoria (con persistencia configurable en disco o Redis). Cada conversación activa en todos los canales tiene su propio contexto creciente. Con 50 canales y varios usuarios activos por canal, el gateway puede mantener cientos de estados de conversación simultáneos. Esta gestión del contexto es automática: las conversaciones antiguas se eliminan según los ajustes de TTL configurables.

Inyección de habilidades y gestión del prompt del sistema

El sistema de habilidades de OpenClaw inyecta instrucciones específicas para cada capacidad en el prompt del sistema de cada solicitud. Las habilidades se definen como archivos de texto en el directorio skills y pueden asignarse a canales específicos o aplicarse globalmente. Cada habilidad añade contexto que ayuda a Claude a responder de forma adecuada al propósito del canal: tono de atención al cliente, estilo de documentación técnica o conocimientos específicos de un ámbito.

Cada habilidad añade tokens a cada solicitud de cada canal al que está asignada. Un canal con cinco habilidades activas podría añadir 2,000-5,000 tokens al prompt del sistema de cada solicitud antes de incluir cualquier historial de conversación. En cincuenta canales con distintas configuraciones de habilidades, la sobrecarga total diaria debida a las habilidades es considerable. Con el acceso ilimitado, esto no supone un problema: escribe habilidades completas sin preocuparte por el coste de cada solicitud.

Las habilidades pueden incluir contenido dinámico mediante variables de plantilla. OpenClaw permite inyectar información del usuario, contexto del canal, hora del día y variables personalizadas en el texto de las habilidades. Esta inyección dinámica se realiza en el momento de la solicitud, lo que garantiza que las habilidades siempre contengan información actualizada. Esta flexibilidad permite comportamientos sofisticados para cada canal sin una lógica de enrutamiento compleja.

Configuración y escalado de canales

Cada canal de OpenClaw se configura en la sección channels de openclaw.json o en archivos de configuración de canales independientes. Una entrada de canal especifica el tipo de plataforma (telegram, discord, slack, web, custom), las credenciales de autenticación de esa plataforma, el modelo que se utilizará, las habilidades asignadas y los ajustes de gestión de conversaciones (longitud del historial, TTL, personalidad).

El escalado es lineal: cada nuevo canal añade un endpoint de inferencia abierto más. Añadir un bot de Telegram añade un canal. Añadir un servidor de Discord con varios canales supervisados puede añadir diez. Cada canal de Discord supervisado es un flujo de conversación independiente con su propio contexto. Un despliegue grande de OpenClaw con Discord, Telegram, Slack y widgets web puede tener fácilmente 50-100 endpoints de inferencia activos.

Con la facturación por token, ampliar el número de canales implica aumentar los costes directamente. Cada nuevo canal añade un gasto proporcional de API según su volumen de mensajes. Con un plan ilimitado, puedes ampliar los canales libremente hasta los límites de solicitudes de uso razonable. Añade nuevas plataformas, nuevos bots y nuevos widgets: la tarifa plana los cubre todos. La única restricción es el límite de solicitudes por minuto, lo suficientemente amplio para la mayoría de los despliegues multicanal.

Resolución de problemas en despliegues de OpenClaw

El error de configuración más frecuente es olvidar api: 'anthropic-messages' en las entradas de los modelos. Sin este campo, OpenClaw envía solicitudes en un formato incorrecto y recibe errores incomprensibles de la API. Si ves fallos al analizar las respuestas o errores 400 inesperados, comprueba primero el campo api. Debe establecerse explícitamente: no hay un valor predeterminado correcto para los modelos Claude.

Si algunos canales fallan mientras otros funcionan, el problema suele estar en la asignación del modelo a nivel de canal, que apunta a una entrada de modelo inexistente o con un error tipográfico. OpenClaw no valida las referencias a modelos al iniciarse: falla al realizar la solicitud cuando el canal intenta utilizar el modelo mal configurado. Comprueba que la referencia al modelo de cada canal coincida exactamente con el nombre de una entrada existente en models.models.

Si se producen errores de límite de solicitudes con una carga multicanal elevada, recuerda que todos los canales comparten la misma clave de API y los mismos límites de solicitudes. Si cincuenta canales están activos simultáneamente durante las horas punta, la tasa combinada de solicitudes podría superar los límites de uso razonable. La pasarela gestiona las respuestas 429 poniendo las solicitudes en cola y reintentándolas, lo que añade latencia pero no pierde mensajes. Para despliegues con un volumen muy elevado, contacta con AI Prime Tech para solicitar límites de solicitudes más altos.

// ~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "unlimited": {
        "api": "anthropic-messages",
        "baseUrl": "https://aiprimetech.io",
        "apiKey": "${UNLIMITED_API_KEY}"
      }
    },
    "models": {
      "sonnet": { "provider": "unlimited", "model": "claude-sonnet-4-5" },
      "opus":   { "provider": "unlimited", "model": "claude-opus-4-6" },
      "haiku":  { "provider": "unlimited", "model": "claude-haiku-4-5" }
    }
  },
  "server": { "port": 18789 }
}

# IMPORTANT: api: "anthropic-messages" is REQUIRED
# Without it, OpenClaw uses wrong request format

Preguntas frecuentes

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.