> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Raspberry Pi

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 Pi | RAM    | ¿Funciona? | Notas                                    |
| ------------ | ------ | ---------- | ---------------------------------------- |
| Pi 5         | 4/8 GB | Mejor      | La más rápida, recomendada.              |
| Pi 4         | 4 GB   | Bien       | Punto ideal para la mayoría de usuarios. |
| Pi 4         | 2 GB   | Aceptable  | Añade swap.                              |
| Pi 4         | 1 GB   | Justo      | Posible con swap, configuración mínima.  |
| Pi 3B+       | 1 GB   | Lenta      | 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 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

<Steps>
  <Step title="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](https://www.raspberrypi.com/software/).
    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.
  </Step>

  <Step title="Conéctate por SSH">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    ssh user@gateway-host
    ```
  </Step>

  <Step title="Actualiza el sistema">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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
    ```
  </Step>

  <Step title="Instala Node.js 24">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
    sudo apt install -y nodejs
    node --version
    ```
  </Step>

  <Step title="Añade swap (importante para 2 GB o menos)">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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
    ```
  </Step>

  <Step title="Instala OpenClaw">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Step>

  <Step title="Ejecuta la incorporación">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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.
  </Step>

  <Step title="Verifica">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f
    ```
  </Step>

  <Step title="Accede a la Control UI">
    En tu computadora, obtén una URL del panel desde la Pi:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    ssh user@gateway-host 'openclaw dashboard --no-open'
    ```

    Luego crea un túnel SSH en otra terminal:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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](/es/gateway/tailscale).
  </Step>
</Steps>

## 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](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot).

**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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
systemctl --user edit openclaw-gateway.service
```

```ini theme={"theme":{"light":"min-light","dark":"min-dark"}}
[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:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

* [Canales](/es/channels) -- conecta Telegram, WhatsApp, Discord y más
* [Configuración del Gateway](/es/gateway/configuration) -- todas las opciones de configuración
* [Actualización](/es/install/updating) -- mantén OpenClaw actualizado

## Relacionado

* [Resumen de instalación](/es/install)
* [Servidor Linux](/es/vps)
* [Plataformas](/es/platforms)