ℹ️

Última actualización

Contenido revisado el 24 de septiembre de 2026 con la guía de instalación de OpenClaw.

📦 Opción rápida (recomendada)

En Linux, macOS o WSL2, el instalador oficial se encarga de todo, incluido Node:

Instalador oficial para Linux/macOS

$curl -fsSL https://openclaw.ai/install.sh | bash

En Windows PowerShell:

Instalador oficial para Windows

$iwr -useb https://openclaw.ai/install.ps1 | iex

📦 Opción manual con npm

Si ya tienes Node 24.16+ (o 26.1+) y prefieres controlar cada paso:

Instalar y configurar OpenClaw

$npm install -g openclaw@latest --allow-scripts=openclaw openclaw onboard --install-daemon

El onboarding te guía para elegir proveedor de IA, conectar tu cuenta o API key y dejar el gateway (el proceso que mantiene vivo a tu agente) instalado como servicio en segundo plano.

✅ Paso 2: Verificar

Verificar la instalación

$openclaw --version openclaw doctor openclaw gateway status

✅

Verificación

Si openclaw doctor no muestra errores bloqueantes y openclaw gateway status dice que el gateway está corriendo, la instalación quedó lista.

⚙️ Paso 3: Entender lo que creó

Todo vive en ~/.openclaw/:

Estructura de archivos

📁~/.openclaw/

├── 📄openclaw.json # configuración técnica (JSON5)← importante

└── 📁workspace/

├── 📄AGENTS.md # instrucciones de trabajo

├── 📄SOUL.md # personalidad y tono← importante

├── 📄IDENTITY.md # nombre y estilo

├── 📄MEMORY.md # memoria de largo plazo (solo tu sesión privada)

├── 📄memory/ # notas diarias

└── 📁skills/

💡

Consejo

SOUL.md define cómo habla tu agente. openclaw.json es la configuración técnica: canales, modelo, permisos. Los personalizamos en las siguientes lecciones.

🔑 Paso 4: Revisar tu proveedor y modelo

El onboarding ya dejó un proveedor y un modelo configurados. No necesitas editar nada a mano. Si quieres cambiarlos después, vuelve a correr el onboarding:

Cambiar proveedor o modelo

$openclaw onboard

⚠️

Importante

Nunca compartas tu API key ni la subas a GitHub. Si alguien la tiene, gasta tu crédito.

🚀 Paso 5: Abrir el dashboard y probar

Abrir el dashboard

$openclaw dashboard

El comando abre el panel de control en tu navegador (por defecto en http://127.0.0.1:18789/). Escríbele algo en el chat, por ejemplo «Hola, ¿quién eres?».

✅

🎉 ¡Tu agente está vivo!

Si te responde, ya tienes un agente de IA funcionando.

🔧 Problemas comunes

Problema	Solución
`command not found: openclaw`	Cierra y abre la terminal. Si sigue, revisa el `PATH` o reinstala con el instalador oficial.
Error de versión de Node	Instala Node 24.16+ o 26 (lección 2) y vuelve a correr `openclaw onboard --install-daemon`.
`API key invalid`	Verifica que copiaste la key completa sin espacios. Si hace falta, genera una nueva y corre `openclaw onboard`.
El gateway no está corriendo	`openclaw gateway restart` y después `openclaw logs --follow` para ver el error.

🧠Verifica tu conocimiento

¿En qué archivo defines la personalidad de tu agente?

Instalación — OpenClaw con onboarding