OpenClaw en Raspberry Pi: Tu Gateway de IA siempre encendido

¿Te ha pasado que tienes un bot o un asistente de IA genial, pero solo funciona cuando tu laptop está abierta? Mantener servidores en la nube puede salir caro a largo plazo, y a veces solo quieres algo local, privado y que no sume otra suscripción mensual a tu cuenta bancaria.

Tener un hardware dedicado en casa que consuma poca energía es la mejor solución para que tus automatizaciones de Telegram o WhatsApp estén siempre disponibles. Aquí te explico cómo montar OpenClaw en una Raspberry Pi por un coste único de entre 35 y 80 dólares.

Requisitos previos

• Raspberry Pi 4 o 5 (2GB+ de RAM recomendado)
• Tarjeta MicroSD (16GB+) o USB SSD (mejor rendimiento)
• Fuente de alimentación oficial de Raspberry Pi
• Conexión a internet (Ethernet o WiFi)
• ~30 minutos de tu tiempo

Inicio rápido

1. Preparar el OS

Usa Raspberry Pi OS Lite (64-bit). No necesitas escritorio para un servidor que manejarás por terminal.

1. Descarga Raspberry Pi Imager.
2. Elige el OS: Raspberry Pi OS Lite (64-bit).
3. En el icono del engranaje (⚙️), configura el hostname como gateway-host, activa el SSH y configura tu usuario y WiFi.
4. Flashea la tarjeta y arranca tu Pi.

2. Conectar por SSH

Entra desde tu ordenador principal:

ssh user@gateway-host
# O usa la IP si no resuelve el nombre
ssh user@192.168.x.x

3. Configuración del sistema

Actualiza todo y ajusta la zona horaria para que tus recordatorios y cron jobs funcionen bien:

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential
sudo timedatectl set-timezone America/Chicago  # Cambia esto a tu zona

4. Instalar Node.js 22 (ARM64)

OpenClaw necesita una versión moderna de Node.js:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Verifica la instalación
node --version
npm --version

5. Configurar Swap (Vital para 2GB de RAM o menos)

El Swap evita que el sistema se cuelgue si te quedas sin memoria:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Hazlo permanente
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Optimiza para RAM baja
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

6. Instalar OpenClaw

Tienes dos opciones, te recomiendo la estándar si no vas a tocar el código:

Opción A: Instalación estándar

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

Opción B: Instalación para desarrollo

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

7. Configuración inicial (Onboarding)

Ejecuta el asistente para configurar el servicio:

openclaw onboard --install-daemon

Elige estas opciones:

• Gateway mode: Local
• Auth: API keys
• Channels: Telegram (es el más sencillo para empezar)
• Daemon: Yes (systemd)

8. Verificar que todo funciona

openclaw status
sudo systemctl status openclaw
journalctl -u openclaw -f

9. Acceder al Dashboard

Como la Pi no tiene pantalla, usa un túnel SSH desde tu laptop:

ssh -L 18789:localhost:18789 user@gateway-host

Luego abre http://localhost:18789 en tu navegador.

Rendimiento y optimización

Usa un USB SSD

Las tarjetas SD son lentas y se rompen con el tiempo. Un SSD por USB mejora muchísimo la velocidad de respuesta del Gateway.

Reduce el consumo de recursos

Si no usas monitor ni Bluetooth, desactívalos para ahorrar memoria:

# Desactiva memoria de GPU
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt

# Desactiva Bluetooth
sudo systemctl disable bluetooth

Nota sobre modelos de IA

La Raspberry Pi actúa como Gateway, no para ejecutar los modelos pesados. Te recomiendo configurar modelos basados en API:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514",
        "fallbacks": ["openai/gpt-4o-mini"]
      }
    }
  }
}

No intentes ejecutar LLMs locales en la Pi; son demasiado lentos. Deja que Claude o GPT hagan el trabajo pesado.

Solución de problemas

Error de memoria (Out of Memory)

• Revisa el uso con free -h.
• Asegúrate de haber creado el archivo Swap del paso 5.
• Reduce la cantidad de servicios activos.

El servicio no arranca

• Revisa los logs: journalctl -u openclaw --no-pager -n 100.
• Si usaste la instalación “hackable”, intenta reconstruir: npm run build.

Problemas con binarios ARM

Si un skill falla con “exec format error”:

1. Verifica si el binario tiene versión ARM64.
2. Intenta compilarlo desde la fuente en la propia Pi.
3. Usa un contenedor Docker con soporte ARM.

Caídas de WiFi

Si tu Pi pierde la conexión WiFi constantemente:

sudo iwconfig wlan0 power off

¿Necesitas ayuda con un paso específico? Prueba el AI Setup Assistant.

Próximos pasos

• Linux guide — Configuración general en Linux
• Tailscale — Acceso remoto seguro
• Nodes — Conecta tu laptop o teléfono al Gateway de la Pi
• DigitalOcean guide — Alternativa en la nube