Instalar OpenClaw en Ubuntu Server paso a paso

2026-09-25 · actualizado 2026-09-25

📌 Guía en revisión activa. Está escrita sobre la documentación oficial (Node 24.16+ o 26.1+, con Node 26 recomendado). La versión final llega cuando termine la instalación en el laboratorio. Los comandos pueden cambiar con las versiones — verifica siempre la guía oficial.

Lo que vas a montar

Un Gateway de OpenClaw corriendo en tu máquina: el proceso que conecta tus canales de chat (WhatsApp, Telegram, Discord…) con el modelo de IA que elijas.

1. Requisitos

Node.js 24.16+ o 26.1+ (recomendado: Node 26). En Ubuntu 24.04:

# vía nvm (recomendado para no pelearse con apt)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 26
node -v   # debe decir v26.x

2 GB de RAM libres como mínimo práctico.
Un terminal. Eso es todo.

2. Instalación

npm install -g openclaw

3. Onboarding

openclaw

El onboarding te guía en ~5 minutos: elegimos modelo (con API key del proveedor, o un modelo local), canal principal y permisos. Al terminar tendremos:

Gateway corriendo,
auth configurada,
una sesión de chat lista.

4. Primera prueba

Desde el canal que configuraste (o desde el chat del propio CLI), manda un mensaje de prueba. Si responde, ya tienes tu asistente personal.

5. Siguientes pasos

Exponer el Gateway de forma segura → guía “Gateway tras reverse proxy” (próximamente).
Conectar WhatsApp/Telegram con seguridad → guía dedicada (próximamente).
Presupuesto de costes por modelo → página de datos.

Errores típicos

Síntoma	Causa habitual	Solución
`openclaw: command not found`	Node viejo o PATH sin el bin de npm	`nvm install 26 && nvm use 26` y reinstalar
El Gateway no arranca tras reboot	No hay servicio/systemd configurado	Crear unidad systemd o dejarlo bajo Docker
“No authentication” al abrir canal	Onboarding incompleto	Re-run `openclaw` y completar auth

Fuente: getting-started.md — docs.openclaw.ai (la doc oficial exporta Markdown añadiendo .md a la URL). Verificación en laboratorio en curso.