Cómo Instalar OpenClaw: Tutorial Completo Paso a Paso

1. Node.js versión 22 o superior (obligatorio)

OpenClaw requiere Node ≥ 22. Verifica tu versión actual:

node --version
# Debe mostrar v22.x.x o superior

Si necesitas instalar o actualizar Node, la forma recomendada es con nvm:

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reinicia la terminal, luego:
nvm install 22
nvm use 22
nvm alias default 22

2. npm, pnpm o bun — npm viene incluido con Node.

3. Cuenta en Anthropic o OpenAI — OpenClaw necesita un modelo de lenguaje. Se recomienda Claude Pro o Max.

4. Sistema operativo compatible: macOS (soporte nativo completo), Linux (soporte completo, recomendado para servidores), Windows (via WSL2).

Paso 1: Instalar el paquete global

# Con npm:
npm install -g openclaw@latest

# Con pnpm:
pnpm add -g openclaw@latest

# Verificar:
openclaw --version

Paso 2: Ejecutar el wizard de onboarding

openclaw onboard --install-daemon

El flag --install-daemon instala OpenClaw como servicio del sistema. El wizard te pedirá: credenciales del modelo, configuración del workspace, canal inicial, y políticas de acceso.

Paso 3: Arrancar el Gateway

openclaw gateway --port 18789 --verbose

El Gateway corre en ws://127.0.0.1:18789 por defecto.

openclaw doctor

Este comando verifica: versión de Node correcta, Gateway corriendo y accesible, credenciales del modelo válidas, configuración de canales, y políticas de DM.

Si ves todo en verde, estás listo. Si hay errores, el propio doctor te dice qué corregir.

macOS: Además de la instalación básica, tienes acceso a la app de barra de menú (OpenClaw.app) con Voice Wake, Talk Mode e integración con iMessage.

Linux: El setup ideal para correr OpenClaw como servidor 24/7. El daemon usa systemd.

systemctl --user status openclaw

Windows (WSL2): Windows nativo no está soportado. El camino recomendado es WSL2:

# En PowerShell como administrador
wsl --install
# Reinicia, luego abre WSL2 y sigue el proceso de Linux

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build
pnpm build

pnpm openclaw onboard --install-daemon

# Loop de desarrollo con auto-reload
pnpm gateway:watch

# Enviar un mensaje de prueba
openclaw message send --to TU_NUMERO --message "Hola desde OpenClaw"

# O ejecutar el agente directamente
openclaw agent --message "¿Qué día es hoy?" --thinking high

Si el asistente responde, felicidades — tienes OpenClaw funcionando.

"command not found: openclaw" después de instalar: El directorio global de npm no está en tu PATH.

npm root -g
# Añade el directorio padre a tu PATH en ~/.zshrc o ~/.bashrc

El Gateway no arranca: Corre openclaw doctor. El error más común es que el puerto 18789 está ocupado.

"Cannot find module" al arrancar: Reinstala: npm uninstall -g openclaw && npm install -g openclaw@latest

Errores de autenticación con Anthropic: Verifica credenciales con openclaw onboard.