Raspberry Pi

Raspberry Pi

Ejecute un Gateway de OpenClaw persistente y siempre activo en una Raspberry Pi. Dado que la Pi es solo el gateway (los modelos se ejecutan en la nube a través de API), incluso una Pi modesta maneja bien la carga de trabajo.

Requisitos previos

• Raspberry Pi 4 o 5 con 2 GB+ de RAM (se recomiendan 4 GB)
• Tarjeta MicroSD (16 GB+) o SSD USB (mejor rendimiento)
• Fuente de alimentación oficial de Pi
• Conexión de red (Ethernet o WiFi)
• Raspberry Pi OS de 64 bits (obligatorio — no use 32 bits)
• Unos 30 minutos

Configuración

1. Flashear el sistema operativo

   Utilice Raspberry Pi OS Lite (64 bits) — no se necesita escritorio para un servidor headless.

   1. Descargue Raspberry Pi Imager.
   2. Elija SO: Raspberry Pi OS Lite (64 bits).
   3. En el diálogo de configuración, preconfigurado:
      • Nombre de host: gateway-host
      • Habilitar SSH
      • Establecer nombre de usuario y contraseña
      • Configurar WiFi (si no se usa Ethernet)
   4. Flashee en su tarjeta SD o unidad USB, insértela y arranque la Pi.

2. Conectarse a través de SSH

   bash ssh user@gateway-host

3. Actualizar 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. Instalar Node.js 24

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

5. Añadir 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. Instalar OpenClaw

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

7. Ejecutar onboarding

   openclaw onboard --install-daemon

   Siga el asistente. Se recomiendan las claves API sobre OAuth para dispositivos headless. Telegram es el canal más fácil para comenzar.

8. Verificar

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

9. Acceder a la Interfaz de Control

   En su computadora, obtenga una URL del panel de control desde la Pi:

   ssh user@gateway-host 'openclaw dashboard --no-open'

   Luego cree un túnel SSH en otra terminal:

   ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

   Abra la URL impresa en su navegador local. Para acceso remoto siempre activo, consulte Integración con Tailscale.

Consejos de rendimiento

Use un SSD USB — las tarjetas SD son lentas y se desgastan. Un SSD USB mejora drásticamente el rendimiento. Consulte la guía de arranque USB de Pi.

Habilitar caché de compilación de módulos — Acelera las invocaciones repetidas de la CLI en hosts Pi de baja potencia:

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

Reducir el uso de memoria — Para configuraciones sin cabeza (headless), libere memoria de la GPU y deshabilite los servicios no utilizados:

echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth

Solución de problemas

Sin memoria — Verifique que el intercambio (swap) esté activo con free -h. Deshabilite los servicios no utilizados (sudo systemctl disable cups bluetooth avahi-daemon). Use solo modelos basados en API.

Rendimiento lento — Use un SSD USB en lugar de una tarjeta SD. Compruebe si hay limitación de la CPU con vcgencmd get_throttled (debería devolver 0x0).

El servicio no se iniciará — Verifique los registros con journalctl --user -u openclaw-gateway.service --no-pager -n 100 y ejecute openclaw doctor --non-interactive. Si esta es una Pi sin cabeza (headless), también verifique que lingering esté habilitado: sudo loginctl enable-linger "$(whoami)".

Problemas con binarios ARM — Si una habilidad falla con “exec format error”, verifique si el binario tiene una compilación ARM64. Verifique la arquitectura con uname -m (debería mostrar aarch64).

Caídas de WiFi — Desactive la administración de energía del WiFi: sudo iwconfig wlan0 power off.

Siguientes pasos

• Canales — conecte Telegram, WhatsApp, Discord y más
• Configuración del Gateway — todas las opciones de configuración
• Actualización — mantenga OpenClaw actualizado