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

Hosting

Raspberry Pi

Ejecute un Gateway de OpenClaw persistente y siempre activo en una Raspberry Pi. Puesto que la Pi funciona únicamente como Gateway (los modelos se ejecutan en la nube mediante una API), incluso una Pi modesta gestiona bien la carga de trabajo; el coste 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 El más rápido; recomendado.
Pi 4 4 GB Bien La opción ideal para la mayoría de usuarios.
Pi 4 2 GB Aceptable Añada espacio de intercambio.
Pi 4 1 GB Limitado Posible con espacio de intercambio y una configuración mínima.
Pi 3B+ 1 GB Lento Funciona, pero con lentitud.
Pi Zero 2 W 512 MB No No se recomienda.

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 de Pi
  • Conexión de red (Ethernet o WiFi)
  • Raspberry Pi OS de 64 bits (obligatorio; no utilice la versión de 32 bits)
  • Unos 30 minutos

Configuración

  • Grabar el SO

    Utilice Raspberry Pi OS Lite (64-bit); no se necesita un escritorio para un servidor sin monitor.

    1. Descargue Raspberry Pi Imager.
    2. Elija el SO: Raspberry Pi OS Lite (64-bit).
    3. En el cuadro de diálogo de configuración, preconfigure:
      • Nombre de host: gateway-host
      • Active SSH
      • Establezca el nombre de usuario y la contraseña
      • Configure WiFi (si no utiliza Ethernet)
    4. Grabe la imagen en la tarjeta SD o unidad USB, insértela e inicie la Pi.

  • Conectarse mediante SSH

    bash
    ssh user@gateway-host

  • Actualizar el sistema

    bash
    sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Establecer la zona horaria (importante para cron y los recordatorios)sudo timedatectl set-timezone America/Chicago

  • Instalar Node.js 24

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

  • Añadir espacio de intercambio (importante con 2 GB o menos)

    bash
    sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Reducir la tendencia al intercambio en dispositivos con poca RAMecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

  • Instalar OpenClaw

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

  • Ejecutar la incorporación

    bash
    openclaw onboard --install-daemon

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

  • Verificar

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

  • Acceder a la interfaz de control

    En el ordenador, obtenga una URL del panel desde la Pi:

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

    Después, cree un túnel SSH en otro terminal:

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

    Abra la URL mostrada en el navegador local. Para disponer de acceso remoto permanente, consulte la integración con Tailscale.

    • Consejos de rendimiento

    Utilice 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; utilícelo para OPENCLAW_STATE_DIR si mantiene el SO en la tarjeta SD. Consulte la guía de arranque USB de Pi.

    Active 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 proceso, 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

    Utilice /var/tmp, no /tmp; algunas distribuciones borran /tmp durante el arranque, lo que elimina la caché preparada.

    Reduzca el uso de memoria; para configuraciones sin monitor, libere memoria de la GPU y desactive los servicios que no se utilicen:

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

    Configuración adicional de systemd para reinicios estables; si esta Pi se utiliza principalmente para ejecutar OpenClaw, añada una configuración adicional 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

    A continuación, systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. En una Pi sin monitor, active también la permanencia una vez para que el servicio de usuario continúe ejecutándose después de cerrar la sesión: sudo loginctl enable-linger "$(whoami)".

    Configuración de modelos recomendada

    Como la Pi solo ejecuta el Gateway, utilice modelos de API alojados en la nube; no ejecute 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 cambios (Node.js, Telegram, WhatsApp/Baileys y Chromium). Los binarios que ocasionalmente carecen de compilaciones para ARM suelen ser herramientas CLI opcionales de Go o Rust distribuidas mediante Skills. Compruebe la arquitectura con uname -m (debería mostrar aarch64) y, a continuación, consulte la página de versiones del binario que falte para buscar artefactos linux-arm64 / aarch64 antes de recurrir a la compilación desde el código fuente.

    Persistencia y copias de seguridad

    El estado de OpenClaw se almacena en:

    • ~/.openclaw/ -- openclaw.json, auth-profiles.json por agente, estado de canales/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. Cree una instantánea portátil con:

    bash
    openclaw backup create

    Solución de problemas

    Memoria insuficiente; compruebe con free -h que el espacio de intercambio esté activo. Desactive los servicios que no se utilicen (sudo systemctl disable cups bluetooth avahi-daemon). Utilice únicamente modelos basados en API.

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

    El servicio no se inicia; consulte los registros con journalctl --user -u openclaw-gateway.service --no-pager -n 100 y ejecute openclaw doctor --non-interactive. Si se trata de una Pi sin monitor, compruebe también que la permanencia esté activada: sudo loginctl enable-linger "$(whoami)".

    Problemas con binarios ARM; si una Skill falla con "exec format error", compruebe si el binario dispone de una compilación para ARM64. Verifique la arquitectura con uname -m (debería mostrar aarch64).

    Interrupciones de WiFi; desactive la administración de energía de WiFi: sudo iwconfig wlan0 power off.

    Pasos siguientes

    Contenido relacionado

    Was this useful?
    On this page

    On this page