Primeros pasos

Objetivo: pasar de cero a un primer chat funcional con la mínima configuración.

Info: El camino más rápido al chat: abre la Control UI (no necesitas configurar ningún canal). Ejecuta openclaw dashboard y chatea desde el navegador, o abre http://127.0.0.1:18789/ en el host del gateway (la máquina donde corre el servicio del Gateway de OpenClaw). Documentación: Dashboard y Control UI.

Requisitos previos

• Node 24 recomendado (Node 22 LTS, actualmente 22.16+, sigue siendo compatible)

Consejo: Comprueba tu versión de Node con node --version si no estás seguro.

Configuración rápida (CLI)

Paso 1: Instalar OpenClaw (recomendado)

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



> **Nota:** Otros métodos de instalación y requisitos: [Instalación](/docs/install).

Paso 2: Ejecutar el asistente de onboarding

```bash
openclaw onboard --install-daemon
```

El asistente configura la autenticación, los ajustes del gateway y los canales opcionales.
Consulta [Asistente de onboarding](/docs/start/wizard) para más detalles.

Paso 3: Verificar el Gateway

Si instalaste el servicio, ya debería estar corriendo:

```bash
openclaw gateway status
```

Paso 4: Abrir la Control UI

```bash
openclaw dashboard
```

Verificación: Si la Control UI carga correctamente, tu Gateway está listo para usar.

Comprobaciones y extras opcionales

Útil para pruebas rápidas o para diagnosticar problemas.

```bash
openclaw gateway --port 18789
```

Requiere un canal configurado.

```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

Variables de entorno útiles

Si ejecutas OpenClaw como cuenta de servicio o quieres ubicaciones personalizadas para la configuración y el estado:

• OPENCLAW_HOME define el directorio base para la resolución interna de rutas.
• OPENCLAW_STATE_DIR sobrescribe el directorio de estado.
• OPENCLAW_CONFIG_PATH sobrescribe la ruta del archivo de configuración.

Referencia completa de variables de entorno: Variables de entorno.

Profundiza más

• Asistente de onboarding (detalles) — Referencia completa del asistente CLI y opciones avanzadas.
• Onboarding en la app de macOS — Flujo de primera ejecución en la app de macOS.

Lo que tendrás al terminar

• Un Gateway en funcionamiento
• Autenticación configurada
• Acceso a la Control UI o un canal conectado

Siguientes pasos

• Seguridad en DMs y aprobaciones: Emparejamiento
• Conectar más canales: Canales
• Flujos avanzados y ejecución desde el código fuente: Setup