Instala OpenClaw en Linux: Guía rápida para tu VPS

Configurar servicios en servidores Linux a veces se siente como una batalla contra la terminal, especialmente cuando solo quieres que las cosas funcionen y se mantengan estables. Si has tenido problemas gestionando procesos en segundo plano o configurando accesos remotos, esta guía te ayudará a dejar todo listo en pocos minutos.

El Gateway es totalmente compatible con Linux. Node.js es el runtime recomendado. No se recomienda Bun para el Gateway (debido a errores con WhatsApp/Telegram).

Se planean aplicaciones nativas para Linux. Las contribuciones son bienvenidas si quieres ayudar a construir una.

Ruta rápida para principiantes (VPS)

1. Instala Node 24 (recomendado; Node 22 LTS, actualmente 22.14+, todavía funciona por compatibilidad)
2. npm i -g openclaw@latest
3. openclaw onboard --install-daemon
4. Desde tu laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. Abre http://127.0.0.1:18789/ y pega tu token

Guía completa del servidor Linux: Linux Server. Ejemplo paso a paso de VPS: exe.dev

Instalación

• Primeros pasos
• Instalación y actualizaciones
• Flujos opcionales: Bun (experimental), Nix, Docker
• Asistente de configuración

Gateway

• Guía de ejecución del Gateway
• Configuración

Instalación del servicio Gateway (CLI)

Usa uno de estos:

openclaw onboard --install-daemon

O:

openclaw gateway install

O:

openclaw configure

Selecciona Gateway service cuando se te solicite.

Reparar/migrar:

openclaw doctor

Control del sistema (unidad de usuario systemd)

OpenClaw instala un servicio de usuario de systemd por defecto. Usa un servicio de sistema para servidores compartidos o que deban estar siempre encendidos. El ejemplo completo de la unidad y la guía están en la guía de ejecución del Gateway.

Configuración mínima:

Crea ~/.config/systemd/user/openclaw-gateway[-<profile>].service:

[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Actívalo:

systemctl --user enable --now openclaw-gateway[-<profile>].service

Siguientes pasos

• Guía de ejecución del Gateway
• Configuración

AI Setup Assistant