Saltar al contenido principal
Ejecuta un Gateway de OpenClaw persistente y siempre activo en una Raspberry Pi. Como la Pi es solo el Gateway (los modelos se ejecutan en la nube mediante API), incluso una Pi modesta gestiona bien la carga de trabajo — el costo típico de hardware es de 35-80 USD una sola vez, sin cuotas mensuales.

​
Compatibilidad de hardware

Modelo de PiRAM¿Funciona?Notas
Pi 54/8 GBMejorLa más rápida, recomendada.
Pi 44 GBBienPunto ideal para la mayoría de usuarios.
Pi 42 GBAceptableAñade swap.
Pi 41 GBJustoPosible con swap, configuración mínima.
Pi 3B+1 GBLentaFunciona, pero con lentitud.
Pi Zero 2 W512 MBNoNo recomendada.
Mínimo: 1 GB de RAM, 1 núcleo, 500 MB de disco libre, sistema operativo de 64 bits. Recomendado: 2 GB o más de RAM, tarjeta SD de 16 GB o más (o SSD USB), Ethernet.

​
Requisitos previos

  • Raspberry Pi 4 o 5 con 2 GB o más de RAM (4 GB recomendado)
  • Tarjeta MicroSD (16 GB o más) o SSD USB (mejor rendimiento)
  • Fuente de alimentación oficial para Pi
  • Conexión de red (Ethernet o WiFi)
  • Raspberry Pi OS de 64 bits (obligatorio — no uses 32 bits)
  • Unos 30 minutos

​
Configuración

1

Graba el sistema operativo

Usa Raspberry Pi OS Lite (64-bit) — no hace falta escritorio para un servidor sin monitor.
  1. Descarga Raspberry Pi Imager.
  2. Elige el sistema operativo: Raspberry Pi OS Lite (64-bit).
  3. En el cuadro de configuración, preconfigura:
    • Nombre de host: gateway-host
    • Habilitar SSH
    • Establecer nombre de usuario y contraseña
    • Configurar WiFi (si no usas Ethernet)
  4. Graba en tu tarjeta SD o unidad USB, insértala y arranca la Pi.
2

Conéctate por SSH

ssh user@gateway-host
3

Actualiza el sistema

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Set timezone (important for cron and reminders)
sudo timedatectl set-timezone America/Chicago
4

Instala Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

Añade swap (importante para 2 GB o menos)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

Instala OpenClaw

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

Ejecuta la incorporación

openclaw onboard --install-daemon
Sigue el asistente. Las claves de API son preferibles a OAuth para dispositivos sin monitor. Telegram es el canal más fácil para empezar.
8

Verifica

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

Accede a la Control UI

En tu computadora, obtén una URL del panel desde la Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Luego crea un túnel SSH en otra terminal:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Abre la URL impresa en tu navegador local. Para acceso remoto siempre activo, consulta la integración con Tailscale.

​
Consejos de rendimiento

Usa un SSD USB — las tarjetas SD son lentas y se desgastan. Un SSD USB mejora drásticamente el rendimiento y resiste más ciclos de escritura; úsalo para OPENCLAW_STATE_DIR si mantienes el sistema operativo en la SD. Consulta la guía de arranque USB para Pi. Habilita la caché de compilación de módulos — acelera las invocaciones repetidas de la CLI en hosts Pi de menor potencia. OPENCLAW_NO_RESPAWN=1 mantiene los reinicios rutinarios del Gateway dentro del mismo proceso, lo que evita traspasos adicionales de procesos y mantiene simple el seguimiento de PID en hosts pequeños: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
Usa /var/tmp, no /tmp — algunas distribuciones limpian /tmp al arrancar, lo que elimina la caché preparada. Reduce el uso de memoria — para configuraciones sin monitor, libera memoria de GPU y desactiva servicios no usados: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
Drop-in de systemd para reinicios estables — si esta Pi ejecuta principalmente OpenClaw, añade un drop-in de servicio: 
systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
Luego ejecuta systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. En una Pi sin monitor, habilita también lingering una vez para que el servicio de usuario sobreviva al cierre de sesión: sudo loginctl enable-linger "$(whoami)".

​
Configuración de modelo recomendada

Como la Pi solo ejecuta el Gateway, usa modelos de API alojados en la nube — no ejecutes LLM locales en una Pi; incluso los modelos pequeños son demasiado lentos para resultar útiles: 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}

​
Notas sobre binarios ARM

La mayoría de las funciones de OpenClaw funcionan en ARM64 sin cambios (Node.js, Telegram, WhatsApp/Baileys, Chromium). Los binarios que ocasionalmente no tienen compilaciones ARM suelen ser herramientas CLI opcionales en Go/Rust incluidas por Skills. Verifica la arquitectura con uname -m (debería mostrar aarch64) y luego revisa la página de versiones del binario faltante para buscar artefactos linux-arm64 / aarch64 antes de recurrir a compilar desde el código fuente.

​
Persistencia y copias de seguridad

El estado de OpenClaw reside en:
  • ~/.openclaw/ — openclaw.json, auth-profiles.json por agente, estado de canales/proveedores, sesiones.
  • ~/.openclaw/workspace/ — espacio de trabajo del agente (SOUL.md, memoria, artefactos).
Estos sobreviven a los reinicios y se benefician de usar SSD en lugar de tarjeta SD, tanto por rendimiento como por longevidad. Crea una instantánea portátil con: 
openclaw backup create

​
Solución de problemas

Sin memoria suficiente — verifica que swap esté activo con free -h. Desactiva servicios no usados (sudo systemctl disable cups bluetooth avahi-daemon). Usa solo modelos basados en API. Rendimiento lento — usa un SSD USB en lugar de una tarjeta SD. Comprueba si hay limitación de CPU con vcgencmd get_throttled (debería devolver 0x0). El servicio no arranca — revisa los registros con journalctl --user -u openclaw-gateway.service --no-pager -n 100 y ejecuta openclaw doctor --non-interactive. Si es una Pi sin monitor, verifica también que lingering esté habilitado: sudo loginctl enable-linger "$(whoami)". Problemas con binarios ARM — si una skill falla con “exec format error”, comprueba si el binario tiene una compilación ARM64. Verifica la arquitectura con uname -m (debería mostrar aarch64). Caídas de WiFi — desactiva la gestión de energía de WiFi: sudo iwconfig wlan0 power off.

​
Próximos pasos

​
Relacionado