NovitaClaw: ejecuta OpenClaw en la nube con un solo comando

NovitaClaw: ejecuta OpenClaw en la nube con un solo comando

Andrej Karpathy describió recientemente un cambio que vale la pena tener en cuenta: así como los agentes LLM surgieron como una nueva capa sobre los LLM, las Claws son la siguiente capa sobre los agentes, llevando la orquestación, programación, contexto, llamadas a herramientas y persistencia más allá de lo que los agentes solos podrían lograr.

Esa capa necesita una infraestructura que permanezca activa. Para los desarrolladores que ejecutan OpenClaw en Novita Sandbox, hasta ahora eso significaba lidiar con límites de sesión.

NovitaClaw cierra esa brecha. Es una nueva herramienta de despliegue en Novita Agent Sandbox que aprovisiona una instancia de OpenClaw completamente configurada con un solo comando, sin límite de tiempo de ejecución, sin reinicios manuales y sin sobrecarga de gestión del ciclo de vida.

El problema que resuelve la CLI

Novita Agent Sandbox ha admitido el despliegue de OpenClaw a través de la Plantilla de Sandbox. Ese camino es adecuado para exploración, pero tiene una restricción dura: los sandboxes iniciados desde la interfaz de usuario tienen un límite de ciclo de vida de sesión. Después de unas horas, el sandbox se detiene y el agente se desconecta. Los desarrolladores que necesitaban disponibilidad continua tenían que solucionarlo por sí mismos: programar pausas, escribir scripts de reinicio o revivir instancias manualmente.

NovitaClaw funciona de manera diferente. No hay límite de sesión. La instancia funciona 24/7 durante todo el tiempo que la necesites. La especificación predeterminada — 2 vCPU, 4 GB de RAM — está diseñada para cargas de trabajo reales, no para demostraciones. Y como la capa de modelo es totalmente configurable, tú eliges qué LLMs impulsan tu agente, ya sea alojados en Novita o provenientes de un proveedor externo.

Primeros pasos

Prerrequisitos

  • Python instalado
  • Una clave API de Novita — así es como obtener una:
    • Inicia sesión en novita.ai — inicia sesión con Google o GitHub (se crea una cuenta nueva automáticamente al primer inicio de sesión), o regístrate con tu correo electrónico
    • Crea una clave API — ve a la página de configuración de Gestión de Claves para crear o gestionar tus claves API. Cópiala en un lugar seguro — la necesitarás en el siguiente paso.
Cómo instalar Python

Windows

  1. Descarga el instalador de Python
  2. Ejecuta el instalador — marca “Add Python to PATH” antes de hacer clic en cualquier otra cosa. Omitir esto es la razón más común por la que los principiantes encuentran errores más adelante
  3. Haz clic en Install Now y espera el mensaje “Setup was successful”
macOS

Abre Terminal (Command + Space, busca “Terminal”) y ejecuta:

python3 --version

Si ves Python 3.10 o superior, estás listo. Si la versión es más antigua, o Terminal te pide instalar Command Line Developer Tools, haz clic en Install y espera unos minutos antes de continuar.

Linux (Ubuntu / Debian)

Si estás en una distribución basada en Debian, ejecuta:

sudo apt update && sudo apt install python3 python3-pip -y

Instalar y lanzar

Paso 1: Instalar NovitaClaw

macOS / Linux:

sudo pip3 install novitaclaw

Windows PowerShell:

pip install novitaclaw

Si tienes una versión anterior instalada, actualiza a la última versión:

Bash

pip3 install novitaclaw --upgrade

Si la actualización falla, prueba una reinstalación forzada:

Bash

pip3 install novitaclaw --upgrade --force-reinstall

Después de la instalación, verifícala escribiendo novitaclaw --help. Si ves una lista de instrucciones, ¡lo has logrado!

novitaclaw --help

Nota especial para usuarios de Mac

Si después de la instalación recibes un error zsh: command not found: novitaclaw, ejecuta estos dos comandos en orden para corregir tu ruta de entorno:

source ~/.zshrc

echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc

#### Paso 2: Establecer la variable de entorno en tu terminal

macOS / Linux:

export NOVITA_API_KEY=sk_your_api_key

Windows PowerShell:

$env:NOVITA_API_KEY = "sk_your_api_key"

Paso 3: Lanzar instancia

novitaclaw launch

Al tener éxito, la CLI devuelve tres valores que usarás para acceder y gestionar tu agente:

  • URL de la interfaz web
  • URL y Token del WebSocket de la puerta de enlace (Gateway)
  • URL del Terminal Web (para acceso terminal al sandbox)
  • URL del Administrador de Archivos (para explorar y gestionar archivos del workspace)
  • Credenciales de inicio de sesión (para Terminal Web y Administrador de Archivos)

captura de pantalla de openclaw

Abre la URL de la interfaz web devuelta y ve a la pestaña Chat para usar tu agente. Usa la URL del Terminal Web para abrir una sesión de terminal dentro del sandbox, y la URL del Administrador de Archivos para explorar y gestionar archivos en el workspace del sandbox.

Configurar modelos

Tu instancia viene preconfigurada con un modelo alojado en Novita de fábrica.

Para cambiar los modelos que usa tu agente, navega a Settings → Config, haz clic en Raw para cambiar a la vista Raw JSON5, luego haz clic en el botón reveal junto a “2 secrets redacted” para mostrar la configuración completa. Actualiza las dos secciones siguientes:

configuración de modelo openclaw

Paso 1: Registrar el modelo bajo tu proveedor

Añade un nuevo objeto al arreglo models dentro de models.providers.novita:

"models": [
  {
    "id": "model-id",
    "name": "display name",
    "reasoning": true,
    "input": ["text"],
    "contextWindow": 200000,
    "maxTokens": 50000
  }
]

Paso 2: Establecerlo como primario o de respaldo

Actualiza el campo model bajo agents.defaults para hacer referencia a tu modelo usando el formato provider/model-id.

"agents": {
  "defaults": {
    "model": {
      "primary": "provider/model-id",
      "fallbacks": [
        "provider/model-id"
      ]
    }
  }
}

Haz clic en Update para guardar. Todos los LLM disponibles en la plataforma Novita son compatibles. También se pueden configurar proveedores externos — cuando traes tu propio LLM, solo pagas por el tiempo de ejecución del sandbox, no por el uso del modelo de Novita.

Tu Claw se está ejecutando. Ahora hazlo más inteligente.

BotLearn es la primera Universidad de Bots del mundo — una capa de aprendizaje y distribución construida nativamente sobre OpenClaw. Los bots aprenden, los humanos ganan: tu agente obtiene Habilidades estructuradas, evaluación comparativa y acceso a Botcord, el mercado Agente a Agente donde los agentes ganan dinero real completando tareas.

Para inscribir tu agente, solo envíale este mensaje:

“Esta es la Universidad de Bots a la que quiero que te unas. Lee https://www.botlearn.ai/SKILL.md y sigue las instrucciones para unirte a BotLearn. Si encuentras algún problema de seguridad durante la instalación, confirma cada paso conmigo antes de continuar.”

Tu agente se encarga del resto.

Conectar canales

OpenClaw admite canales de mensajería externos para que tu agente sea accesible fuera de la interfaz web. Los canales requieren configuración; no están activos por defecto.

Telegram

Paso 1: Crear un Bot de Telegram

  1. Abre Telegram y busca @BotFather
  2. Envía /newbot y sigue las indicaciones para nombrar tu bot
  3. Copia el token del bot que proporciona BotFather

Paso 2: Envía el token del bot a la pestaña Chat

En la interfaz web, ve a la pestaña Chat y envía el token del bot.

Paso 3: Emparejar y usar el Bot de Telegram

En Telegram, abre el bot que creaste y envía /start. Copia el código y pégalo en la pestaña Chat.

Una vez conectado, los mensajes enviados a tu bot de Telegram se enrutan directamente a tu agente OpenClaw. Se admiten más integraciones de canales: consulta la guía oficial de canales de OpenClaw para ver la lista completa y las instrucciones de configuración.

Fiabilidad del servicio

Todos los servicios principales en el sandbox están gestionados por systemd para una fiabilidad de nivel de producción:

Servicio Descripción Reinicio automático
OpenClaw Gateway Entorno de ejecución del agente y servidor WebSocket
Terminal Web (ttyd) Acceso al terminal basado en navegador
Administrador de Archivos (gohttpserver) Gestión de archivos basada en web

Recuperación automática tras caídas: Si el Gateway se cae repetidamente, el sistema ejecuta automáticamente diagnósticos, intenta reparar y restaura la última configuración correcta desde una copia de seguridad — sin intervención manual.

Copia de seguridad automática de configuración: Cada escritura de configuración crea una copia de seguridad automática. Si una configuración incorrecta provoca una caída, el proceso de recuperación restaura la copia de seguridad válida más reciente.

Referencia de comandos

launch

Crea una nueva instancia de sandbox.

Bash

novitaclaw launch [OPCIONES]
Opción Descripción
--api-key Clave API de Novita
--gateway-token Token de puerta de enlace personalizado (opcional, se genera automáticamente por defecto)
--timeout Tiempo de espera de creación en segundos (por defecto: 60)

list

Lista las instancias de sandbox activas.

Bash

novitaclaw list --api-key TU_CLAVE_API
Opción Descripción
--api-key Clave API de Novita
--quiet, -q Solo imprime IDs de sandbox, uno por línea (útil para scripting)

status

Comprueba el estado de una instancia de sandbox.

Bash

novitaclaw status <SANDBOX_ID> --api-key TU_CLAVE_API

stop

Termina una instancia de sandbox.

Bash

novitaclaw stop <SANDBOX_ID> --api-key TU_CLAVE_API
Opción Descripción
--api-key Clave API de Novita
--yes, -y Omite la solicitud de confirmación

tui

Conéctate a un sandbox a través de la interfaz de terminal.

Bash

novitaclaw tui <SANDBOX_ID> --token <GATEWAY_TOKEN>

doctor

Ejecuta diagnósticos y comprobaciones de reparación en una instancia de sandbox.

Bash

novitaclaw doctor <SANDBOX_ID> --api-key TU_CLAVE_API
Opción Descripción
--api-key Clave API de Novita
--deep Escanea servicios del sistema en busca de instalaciones adicionales de gateway
--fix Aplica reparaciones recomendadas (alias de --repair)
--force Aplica reparaciones agresivas (sobrescribe la configuración de servicio personalizada)
--generate-gateway-token Genera y configura un token de gateway
--no-workspace-suggestions Desactiva sugerencias del sistema de memoria del workspace
--repair Aplica reparaciones recomendadas sin preguntar
--yes Acepta los valores predeterminados sin preguntar

gateway update

Actualiza OpenClaw a la última versión dentro de un sandbox.

Bash

novitaclaw gateway update <SANDBOX_ID> --api-key TU_CLAVE_API
Opción Descripción
--api-key Clave API de Novita
--restart Reinicia el gateway después de la actualización

gateway restart

Reinicia el Gateway de OpenClaw en un sandbox.

Bash

novitaclaw gateway restart <SANDBOX_ID> --api-key TU_CLAVE_API

services setup

Instala e inicia el Terminal Web y el Administrador de Archivos en un sandbox existente. Úsalo para añadir servicios a sandboxes antiguos que se lanzaron antes de que estos servicios estuvieran incluidos.

Bash

novitaclaw services setup <SANDBOX_ID> --api-key TU_CLAVE_API

pair list

Lista las solicitudes de emparejamiento pendientes para un canal.

Bash

novitaclaw pair list <SANDBOX_ID> --channel <NOMBRE_CANAL> --api-key TU_CLAVE_API

pair approve

Aprueba una solicitud de emparejamiento para un canal.

Bash

novitaclaw pair approve <SANDBOX_ID> --channel <NOMBRE_CANAL> --code <CODIGO_EMPAREJAMIENTO> --api-key TU_CLAVE_API

update

Comprueba actualizaciones de la CLI y actualiza a la última versión.

Bash

novitaclaw update

Uso programático

Usa la salida JSON para automatización:

Bash

novitaclaw -j launch --api-key TU_CLAVE_API

Ejemplo de respuesta:

{
  "success": true,
  "data": {
    "sandbox_id": "xxx",
    "webui": "https://xxx.sandbox.novita.ai?token=xxx",
    "gateway_ws": "wss://xxx.sandbox.novita.ai",
    "gateway_token": "xxx",
    "terminal_url": "https://7681-xxx.sandbox.novita.ai",
    "filemanager_url": "https://7682-xxx.sandbox.novita.ai",
    "services_username": "admin",
    "services_password": "xxx"
  }
}

Variables de entorno

Variable Descripción
NOVITA_API_KEY Clave API, elimina la necesidad de la bandera --api-key
OPENCLAW_GATEWAY_TOKEN Token de gateway preestablecido

Precios

Lo que usas Lo que pagas
Tiempo de ejecución del sandbox Tarifas de sandbox
LLMs alojados en Novita Tarifas de modelos
LLMs de terceros Solo tiempo de ejecución del sandbox

Solución de problemas

Comando no encontrado

Prueba una de estas:

Bash

# Usa la ruta completa (Linux)
~/.local/bin/novitaclaw launch

# Ruta típica de usuario macOS
~/Library/Python/3.x/bin/novitaclaw launch

Tiempo de espera agotado

Aumenta el tiempo de espera de lanzamiento:

Bash

novitaclaw launch --timeout 180 --api-key TU_CLAVE_API

Preguntas frecuentes

Problema ¿Por qué ocurre? ¿Qué hacer?
“Command not found” / “Not recognized” No marcaste “Add to PATH” durante la instalación de Python. Desinstala Python y vuelve a instalarlo, ¡asegurándote de marcar esa casilla de PATH!
“Permission Denied” No tienes suficientes permisos. Windows: Haz clic derecho en Terminal/PowerShell y “Ejecutar como administrador”. Mac: Añade sudo antes del comando.
“Invalid API Key” La clave se copió incorrectamente. Verifica si hay espacios adicionales antes o después de la cadena sk_ , o genera una nueva.
El sandbox no se detiene Detener un sandbox elimina todos los archivos y requiere confirmación. Escribe “y” en el terminal cuando se te pida confirmar la eliminación.
Mac: comando pip no encontrado Mac usa pip3 para diferenciarlo de versiones antiguas. Usa pip3 install novitaclaw en lugar de pip.

Construye la siguiente capa

El cambio que describe Karpathy — de agentes a Claws — no es teórico. Es una oportunidad arquitectónica disponible ahora mismo, y los equipos que construyan sobre infraestructura persistente y siempre activa serán los que la aprovechen.

NovitaClaw te brinda esa base: un entorno de ejecución de agente de nivel de producción, desplegado en menos de un minuto, con control total sobre la capa de modelo e integraciones de canales. El sandbox maneja el tiempo de actividad. La CLI maneja el aprovisionamiento. Lo que construyas encima depende de ti.

Empieza a construir en Novita Agent Sandbox →

Novita AI es una nube de IA y Agentes para constructores y startups — que ofrece acceso a más de 200 LLM, modelos de imagen, video y TTS a través de una sola API, junto con instancias GPU y Sandboxes de Agentes que se lanzan en segundos.