Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Ejecuta un Gateway de OpenClaw persistente en un Droplet de DigitalOcean (~$6/mes para el plan Basic de 1 GB). DigitalOcean es la ruta VPS de pago más sencilla. Si prefieres opciones más económicas o gratuitas:
  • Hetzner — 3,79 €/mes, más núcleos/RAM por dólar.
  • Oracle Cloud — ARM Always Free (hasta 4 OCPU, 24 GB de RAM), pero el registro puede ser delicado y es solo ARM.

​
Requisitos previos

  • Cuenta de DigitalOcean (registro)
  • Par de claves SSH (o disposición a usar autenticación con contraseña)
  • Unos 20 minutos

​
Configuración

1

Crear un Droplet

Usa una imagen base limpia (Ubuntu 24.04 LTS). Evita imágenes de terceros de Marketplace con instalación en 1 clic salvo que hayas revisado sus scripts de inicio y valores predeterminados de firewall.
  1. Inicia sesión en DigitalOcean.
  2. Haz clic en Create > Droplets.
  3. Elige:
    • Región: La más cercana a ti
    • Imagen: Ubuntu 24.04 LTS
    • Tamaño: Basic, Regular, 1 vCPU / 1 GB de RAM / SSD de 25 GB
    • Autenticación: Clave SSH (recomendado) o contraseña
  4. Haz clic en Create Droplet y anota la dirección IP.
2

Conectar e instalar

ssh root@YOUR_DROPLET_IP

apt update && apt upgrade -y

# Install Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# Install OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# Create the non-root user that will own OpenClaw state and services.
adduser openclaw
usermod -aG sudo openclaw
loginctl enable-linger openclaw

su - openclaw
openclaw --version
Usa la shell root solo para el arranque inicial del sistema. Ejecuta los comandos de OpenClaw como el usuario no root openclaw para que el estado resida en /home/openclaw/.openclaw/ y el Gateway se instale como servicio systemd de ese usuario.
3

Ejecutar la incorporación

openclaw onboard --install-daemon
El asistente te guía por la autenticación del modelo, la configuración del canal, la generación del token del Gateway y la instalación del daemon (systemd).
4

Agregar swap (recomendado para Droplets de 1 GB)

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
5

Verificar el gateway

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
6

Acceder a la interfaz de control

El gateway se enlaza a loopback de forma predeterminada. Elige una de estas opciones.Opción A: túnel SSH (la más sencilla)
# From your local machine
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP
Luego abre http://localhost:18789.Opción B: Tailscale Serve
curl -fsSL https://tailscale.com/install.sh | sudo sh
sudo tailscale up
openclaw config set gateway.tailscale.mode serve
openclaw gateway restart
Luego abre https://<magicdns>/ desde cualquier dispositivo de tu tailnet.Tailscale Serve autentica el tráfico de la interfaz de control y WebSocket mediante encabezados de identidad de tailnet, lo que presupone que el propio host del gateway es de confianza. Los endpoints de la API HTTP siguen el modo normal de autenticación del gateway (token/contraseña) de todos modos. Para exigir credenciales explícitas de secreto compartido sobre Serve, establece gateway.auth.allowTailscale: false y usa gateway.auth.mode: "token" o "password".Opción C: enlace a tailnet (sin Serve)
openclaw config set gateway.bind tailnet
openclaw gateway restart
Luego abre http://<tailscale-ip>:18789 (requiere token).

​
Persistencia y copias de seguridad

El estado de OpenClaw reside en:
  • ~/.openclaw/ — openclaw.json, auth-profiles.json por agente, estado de canales/proveedores y datos de sesión.
  • ~/.openclaw/workspace/ — el espacio de trabajo del agente (SOUL.md, memoria, artefactos).
Estos sobreviven a los reinicios del Droplet. Para crear una instantánea portable: 
openclaw backup create
Las instantáneas de DigitalOcean respaldan todo el Droplet; openclaw backup create es portable entre hosts.

​
Consejos para 1 GB de RAM

El Droplet de $6 solo tiene 1 GB de RAM. Para que todo funcione con fluidez:
  • Asegúrate de que el paso de swap anterior esté en /etc/fstab para que sobreviva a los reinicios.
  • Prefiere modelos basados en API (Claude, GPT) frente a modelos locales: la inferencia local de LLM no cabe en 1 GB.
  • Establece agents.defaults.model.primary en un modelo más pequeño si encuentras errores OOM con prompts grandes.
  • Monitoriza con free -h y htop.

​
Solución de problemas

El Gateway no arranca — Ejecuta openclaw doctor --non-interactive y revisa los registros con journalctl --user -u openclaw-gateway.service -n 50. El puerto ya está en uso — Ejecuta lsof -i :18789 para encontrar el proceso y luego detenlo. Sin memoria — Verifica que el swap esté activo con free -h. Si sigues encontrando OOM, usa modelos basados en API (Claude, GPT) en lugar de modelos locales, o actualiza a un Droplet de 2 GB.

​
Próximos pasos

​
Relacionado