OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

Raspberry Pi

Ejecuta un Gateway de OpenClaw persistente y siempre activo en una Raspberry Pi. Como la Pi solo funciona como Gateway (los modelos se ejecutan en la nube mediante una API), incluso una Pi modesta gestiona bien la carga de trabajo: el costo habitual del hardware es de $35-80 en un único pago, sin cuotas mensuales.

Compatibilidad de hardware

Modelo de Pi RAM ¿Funciona? Notas
Pi 5 4/8 GB Óptimo La más rápida; recomendada.
Pi 4 4 GB Bien La mejor opción para la mayoría.
Pi 4 2 GB Aceptable Añade espacio de intercambio.
Pi 4 1 GB Limitado Posible con intercambio y configuración mínima.
Pi 3B+ 1 GB Lento Funciona, pero con lentitud.
Pi Zero 2 W 512 MB No No recomendada.

Mínimo: 1 GB de RAM, 1 núcleo, 500 MB de espacio libre en disco y un SO de 64 bits. Recomendado: 2 GB o más de RAM, tarjeta SD de 16 GB o más (o SSD USB) y Ethernet.

Requisitos previos

  • Raspberry Pi 4 o 5 con 2 GB o más de RAM (se recomiendan 4 GB)
  • 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 la versión de 32 bits)
  • Unos 30 minutos

Configuración

  • Flash the OS

    Usa Raspberry Pi OS Lite (64 bits); no se necesita escritorio para un servidor sin monitor.

    1. Descarga Raspberry Pi Imager.
    2. Elige el SO: Raspberry Pi OS Lite (64-bit).
    3. En el cuadro de configuración, configura previamente:
      • Nombre de host: gateway-host
      • Habilita SSH
      • Establece el nombre de usuario y la contraseña
      • Configura el WiFi (si no usas Ethernet)
    4. Graba la imagen en la tarjeta SD o unidad USB, insértala e inicia la Pi.

  • Connect via SSH

    bash
    ssh user@gateway-host

  • Update the system

    bash
    sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Set timezone (important for cron and reminders)sudo timedatectl set-timezone America/Chicago

  • Install Node.js 24

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

  • Add swap (important for 2 GB or less)

    bash
    sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Reduce swappiness for low-RAM devicesecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

  • Install OpenClaw

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

  • Run onboarding

    bash
    openclaw onboard --install-daemon

    Sigue el asistente. Para dispositivos sin monitor, se recomiendan claves de API en lugar de OAuth. Telegram es el canal más sencillo para empezar.

  • Verify

    bash
    openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

  • Access the Control UI

    En tu computadora, obtén desde la Pi una URL para el panel:

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

    Después, crea un túnel SSH en otra terminal:

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

    Abre la URL mostrada en tu navegador local. Para disponer de acceso remoto permanente, 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 considerablemente el rendimiento y soporta más ciclos de escritura; úsalo para OPENCLAW_STATE_DIR si mantienes el SO en la tarjeta SD. Consulta la guía de arranque USB de 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 en el mismo proceso los reinicios habituales del Gateway, lo que evita transferencias adicionales entre procesos y simplifica el seguimiento del PID en hosts pequeños:

    bash
    grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

    Usa /var/tmp, no /tmp: algunas distribuciones borran /tmp al arrancar, lo que elimina la caché precalentada.

    Reduce el uso de memoria: en configuraciones sin monitor, libera memoria de la GPU y deshabilita los servicios que no se utilicen:

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

    Configuración complementaria de systemd para reinicios estables: si esta Pi se utiliza principalmente para ejecutar OpenClaw, añade una configuración complementaria al servicio:

    bash
    systemctl --user edit openclaw-gateway.service
    ini
    [Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=90

    Después, ejecuta systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. En una Pi sin monitor, habilita también una vez la persistencia de la sesión para que el servicio de usuario siga activo después de cerrar 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, ya que incluso los modelos pequeños son demasiado lentos para resultar útiles:

    json
    {  "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 modificaciones (Node.js, Telegram, WhatsApp/Baileys y Chromium). Los binarios que ocasionalmente no disponen de compilaciones para ARM suelen ser herramientas opcionales de la CLI escritas en Go o Rust y distribuidas mediante Skills. Comprueba la arquitectura con uname -m (debe mostrar aarch64) y revisa después la página de versiones del binario que falte para buscar artefactos linux-arm64 / aarch64 antes de recurrir a compilarlo desde el código fuente.

    Persistencia y copias de seguridad

    El estado de OpenClaw se almacena en:

    • ~/.openclaw/: openclaw.json, archivos auth-profiles.json de cada agente, estado de canales y proveedores, y sesiones.
    • ~/.openclaw/workspace/: espacio de trabajo del agente (SOUL.md, memoria y artefactos).

    Estos datos sobreviven a los reinicios y se benefician del uso de un SSD en lugar de una tarjeta SD, tanto en rendimiento como en durabilidad. Crea una instantánea portátil con:

    bash
    openclaw backup create

    Solución de problemas

    Memoria insuficiente: comprueba que el espacio de intercambio esté activo con free -h. Deshabilita los servicios que no utilices (sudo systemctl disable cups bluetooth avahi-daemon). Usa únicamente modelos basados en API.

    Rendimiento lento: usa un SSD USB en lugar de una tarjeta SD. Comprueba si la CPU está reduciendo su frecuencia con vcgencmd get_throttled (debe devolver 0x0).

    El servicio no se inicia: consulta los registros con journalctl --user -u openclaw-gateway.service --no-pager -n 100 y ejecuta openclaw doctor --non-interactive. Si se trata de una Pi sin monitor, comprueba también que la persistencia de la sesión esté habilitada: sudo loginctl enable-linger "$(whoami)".

    Problemas con binarios ARM: si una skill falla con "exec format error", comprueba si el binario dispone de una compilación para ARM64. Verifica la arquitectura con uname -m (debe mostrar aarch64).

    Desconexiones de WiFi: deshabilita la administración de energía del WiFi: sudo iwconfig wlan0 power off.

    Pasos siguientes

    Contenido relacionado

    Was this useful?
    On this page

    On this page