> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# NovitaClaw

Implementa un agente OpenClaw persistente en [Novita Agent Sandbox](https://novita.ai/sandbox) con un solo comando y luego gestiónalo desde la CLI, la interfaz web o scripts de automatización. Sin límite de sesión: tu instancia se ejecuta 24/7 durante todo el tiempo que la necesites.

## Novedades en v1.6.0

* **Exportación / Importación de configuración de Gateway** — Haz copias de seguridad, restaura y migra tu configuración de OpenClaw entre sandboxes. Exporta a stdout o a un archivo, importa con validación automática de JSON y reinicio de Gateway. Compatible con flujos de trabajo de migración entre sandboxes.

```bash Bash icon="terminal" theme={"system"}
# Export config
novitaclaw gateway config export <sandbox_id> -o config.json
# Import into another sandbox
novitaclaw gateway config import <target_id> config.json
```

* **Instalación de habilidades de ClawHub** — Instala habilidades de extensión de OpenClaw desde ClawHub directamente en un sandbox. Las habilidades están disponibles de inmediato sin necesidad de reiniciar Gateway.

```bash Bash icon="terminal" theme={"system"}
novitaclaw skill install <sandbox_id> sonoscli
```

### Versiones anteriores

* **Canal de Telegram (CLI)** — Modos Polling y Webhook para conectar tu agente a Telegram. [Guía de configuración](/docs/es/guides/novitaclaw-configuration#telegram)
* **Canal de Slack** — Modos Socket y HTTP para conectar tu agente a Slack. [Guía de configuración](/docs/es/guides/novitaclaw-configuration#slack)
* **Mejoras del script de instalación** — El directorio de instalación cambió a `~/.novitaclaw-cli`, comando `update` mejorado con compatibilidad con PEP 668 y recuperación de symlinks
* **Modo On-Demand** — El sandbox se pausa automáticamente tras estar inactivo y se reanuda al acceder. Facturación cero mientras está pausado. [Más información](/docs/es/guides/novitaclaw-configuration#on-demand-mode)
* **Canal de Feishu** — Conecta tu agente a Feishu (Lark) mediante el modo Webhook o Event. [Guía de configuración](/docs/es/guides/novitaclaw-configuration#feishu)
* **Web Terminal** — Acceso a terminal basado en navegador para tu sandbox, sin necesidad de SSH
* **File Manager** — Explora y administra archivos del workspace directamente desde el navegador
* **Gestión de servicios con systemd** — Gateway, Web Terminal y File Manager están completamente gestionados por systemd con reinicio automático en caso de fallo
* **Recuperación automática ante fallos** — Diagnóstico, reparación y restauración de servicios automáticos ante fallos repetidos
* **Copia de seguridad automática de configuración** — Cada escritura de configuración crea una copia de seguridad automática; la recuperación ante fallos restaura desde la última copia válida conocida

<Tip>
  Para usar las nuevas funciones, actualiza tu CLI:

  ```bash macOS / Linux theme={"system"}
  curl -fsSL https://novitaclaw.novita.ai/install.sh | bash
  ```

  ```bash Windows (PowerShell) theme={"system"}
  irm https://novitaclaw.novita.ai/install.ps1 | iex
  ```
</Tip>

## Primeros pasos

### Requisitos previos

* Python instalado
* Una clave de API de Novita (crea claves /manage en [Key Management](https://novita.ai/docs/guides/quickstart#2-manage-api-key))

<Accordion title="Cómo instalar Python">
  **Windows**

  [Descarga el instalador de Python](https://www.python.org/downloads/) y ejecútalo. **Marca "Add Python to PATH"** antes de hacer clic en Install Now; omitir esto es la razón más común por la que los principiantes encuentran errores más adelante.

  **macOS**

  Abre Terminal y ejecuta:

  ```bash Bash icon="terminal" theme={"system"}
  python3 --version
  ```

  Si ves Python 3.10 o superior, todo está listo. Si Terminal te pide instalar Command Line Developer Tools, haz clic en Install y espera unos minutos.

  **Linux (Ubuntu / Debian)**

  ```bash Bash icon="terminal" theme={"system"}
  sudo apt update && sudo apt install python3 python3-pip -y
  ```
</Accordion>

### Paso 1: Instala NovitaClaw

<CodeGroup>
  ```bash macOS / Linux theme={"system"}
  sudo pip3 install novitaclaw
  ```

  ```bash Windows PowerShell theme={"system"}
  pip install novitaclaw
  ```
</CodeGroup>

Después de la instalación, verifica ejecutando `novitaclaw --help`. Si ves una lista de comandos, todo está listo.

<Warning>
  **Usuarios de Mac:** Si obtienes `zsh: command not found: novitaclaw` después de la instalación, ejecuta:

  ```bash Bash icon="terminal" theme={"system"}
  echo 'export PATH="'$(python3 -m site --user-base)'/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```
</Warning>

### Paso 2: Configura tu clave de API

<CodeGroup>
  ```bash macOS / Linux theme={"system"}
  export NOVITA_API_KEY=sk_your_api_key
  ```

  ```powershell Windows PowerShell theme={"system"}
  $env:NOVITA_API_KEY = "sk_your_api_key"
  ```
</CodeGroup>

### Paso 3: Inicia tu instancia

```bash Bash icon="terminal" theme={"system"}
novitaclaw launch
```

Si se completa correctamente, la CLI devuelve:

* **URL de la interfaz web** — Chatea con tu agente
* **URL WebSocket y token de Gateway** — Para acceso programático
* **URL de Web Terminal** — Acceso a terminal al sandbox en tu navegador
* **URL de File Manager** — Explora y administra archivos del workspace
* **Credenciales de inicio de sesión** — Nombre de usuario y contraseña para Web Terminal y File Manager

<Frame>
  <img src="https://mintcdn.com/novitaai/QcGDqn4gh3xIo9UN/es/guides/images/openclaw-cli/launch-result.png?fit=max&auto=format&n=QcGDqn4gh3xIo9UN&q=85&s=be3f91706a5504c462925e0fb08e8976" alt="Resultado de lanzamiento de NovitaClaw" width="1486" height="289" data-path="es/guides/images/openclaw-cli/launch-result.png" />
</Frame>

Abre la **URL de la interfaz web** devuelta y ve a la pestaña `Chat` para empezar a usar tu agente.

### Web Terminal

Web Terminal proporciona acceso a terminal basado en navegador a tu entorno de sandbox. Abre la **URL de Web Terminal** devuelta por el comando de lanzamiento e inicia sesión con las credenciales proporcionadas. Esto te da una sesión de shell completa: instala paquetes, inspecciona logs o depura tu agente directamente.

### File Manager

File Manager te permite explorar, subir, descargar y administrar archivos en el workspace del sandbox mediante una interfaz web. Abre la **URL de File Manager** e inicia sesión con las mismas credenciales. Úsalo para ver archivos del workspace del agente, editar configuraciones o transferir archivos sin necesidad de acceso por CLI.

<Note>
  Para sandboxes existentes iniciados antes de que estos servicios estuvieran disponibles, puedes agregarlos de forma retroactiva:

  ```bash Bash icon="terminal" theme={"system"}
  novitaclaw services setup <SANDBOX_ID> --api-key YOUR_API_KEY
  ```
</Note>

## Precios

| Lo que usas                     | Lo que pagas                                              |
| ------------------------------- | --------------------------------------------------------- |
| Tiempo de ejecución del sandbox | [Tarifas de sandbox](https://novita.ai/pricing?sandbox=1) |
| LLMs alojados por Novita        | [Tarifas de modelos](https://novita.ai/pricing)           |
| LLMs de terceros                | Solo tiempo de ejecución del sandbox                      |