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
- Descarga el instalador de Python
- 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
- 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!

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
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)

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:

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
- Abre Telegram y busca @BotFather
- Envía
/newboty sigue las indicaciones para nombrar tu bot - 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.
