Instalación — OpenClaw con onboarding

ℹ️

Última actualización

Contenido revisado el 2 de junio de 2026. La ruta recomendada de OpenClaw usa openclaw@latest y openclaw onboard --install-daemon.

📦 Opción rápida

En Linux o macOS puedes usar el instalador oficial:

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 prefieres controlar cada paso:

Instalar y configurar OpenClaw

$npm install -g openclaw@latest openclaw onboard --install-daemon

OpenClaw onboarding completed

Verifica la instalación:

Verificar

$openclaw --version openclaw doctor openclaw status

OpenClaw OK

✅

Verificación

Si doctor no muestra errores bloqueantes y status responde, la instalación quedó lista.

⚙️ Paso 2: Entender lo que creó

El onboarding configura autenticación, Gateway, canales opcionales y el daemon para que OpenClaw siga corriendo en segundo plano. La configuración vive normalmente en ~/.openclaw/.

Esto crea esta estructura:

Estructura de archivos

📁~/.openclaw/

├── ⚙️config.yaml← importante

├── 📝SOUL.md← importante

├── 📝MEMORY.md

├── 📁logs/

└── 📁skills/

💡

Consejo

SOUL.md es donde defines cómo habla tu agente. config.yaml es la configuración técnica. Los personalizamos en la siguiente lección.

🔑 Paso 3: Agregar o revisar tu API key

El onboarding puede pedir proveedor y key. Si necesitas revisarlo manualmente, abre config.yaml:

# config.yaml
model:
  provider: anthropic          # o "openai", "google", "openrouter"
  model: claude-sonnet-4-20250514

secrets:
  # Mejor usar variables de entorno o el flujo del onboarding.
  # No subas llaves a GitHub.

⚠️

Importante

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

🚀 Paso 4: Abrir dashboard

Abrir dashboard

$openclaw dashboard

Dashboard listening on http://localhost:3000

🧪 Paso 5: Probar

Abre http://localhost:3000 en tu navegador. Escríbele algo:

Mi Agente

Chat web — localhost:3000

✈️ Telegram

Hola, ¿quién eres?

12:01

¡Hola! 👋 Soy tu agente de IA personal. Estoy listo para ayudarte. ¿Qué necesitas?

12:01

Escribe un mensaje...

✅

🎉 ¡Tu agente está vivo!

Si te responde, felicidades. 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 `npm install -g openclaw@latest`
`Node.js version too old`	Instala Node.js 22 o 24 y vuelve a correr `openclaw onboard --install-daemon`
`API key invalid`	Verifica que copiaste la key completa sin espacios. Genera una nueva si es necesario
`Port 3000 already in use`	Cambia el puerto en `config.yaml` con `server.port: 3001`

🧠Verifica tu conocimiento

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