Cómo instalar OpenClaw en una Raspberry Pi (4 y 5)

Una Raspberry Pi es el lugar ideal para OpenClaw: un equipo de bajo consumo, siempre encendido, en tu propia red. El asistente queda corriendo como un servicio 24/7 sin que tengas que dejar la laptop prendida, y tus datos nunca salen de casa.

Esta guía es el camino específico para Raspberry Pi. Si quieres el panorama completo (macOS, Windows, Docker), está en cómo instalar OpenClaw; aquí voy directo a lo que cambia en la Pi.

Qué Raspberry Pi necesitas (la verdad sobre el hardware)

OpenClaw pide Node.js 24.16+ o 26.1+ y un sistema de 64 bits. Según la página de Raspberry Pi de la documentación oficial, el mínimo es 1 GB de RAM y lo recomendado, 2 GB o más. Como la Pi solo corre el gateway y los modelos van por API, la tabla oficial queda así:

Mucha gente busca "OpenClaw en Raspberry Pi 3": la 3B+ arranca, pero va lenta, así que no la compraría a propósito. La Pi 4 de 4 GB es la opción equilibrada; lo cómodo es una Pi 5. Con 2 GB o menos, agrega swap.

No intentes correr modelos de IA locales en la Pi: no tiene GPU para eso. La Pi ejecuta el agente OpenClaw, pero la inferencia la hace una API en la nube (Claude, OpenAI). Eso mantiene la Pi liviana y la cuenta de luz baja.

Paso 1: Raspberry Pi OS de 64 bits

OpenClaw exige un sistema de 64 bits (la documentación pide no usar el de 32). Instala Raspberry Pi OS (64-bit) con Raspberry Pi Imager. Como OpenClaw corre headless (sin monitor), te conviene la versión Lite: menos peso, sin escritorio.

En el Imager, antes de grabar la SD, abre la configuración avanzada (el icono del engranaje) y activa SSH, el usuario y el Wi-Fi. Así arrancas sin teclado ni pantalla.

Una vez booteada, conéctate por SSH y actualiza:

ssh tu-usuario@raspberrypi.local
sudo apt update && sudo apt full-upgrade -y
sudo reboot

Confirma que es 64 bits (debe decir aarch64):

uname -m

Paso 2: Instalar OpenClaw

El script oficial detecta el sistema y, si falta Node, instala Node 24 LTS en Linux (documentación de instalación). Es la vía recomendada en la Pi:

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

Si prefieres hacerlo a mano, primero necesitas Node 24.16+ (o 26.1+) para ARM64; Node 22, 23 y 25 no están soportados, y el apt de Raspberry Pi OS suele traer una versión vieja. La forma más limpia es con fnm o nvm:

# Instalar fnm y Node 24
curl -fsSL https://fnm.vercel.app/install | bash
exec $SHELL
fnm install 24 && fnm use 24
 
# Verificar
node --version   # v24.16 o superior
 
# Instalar OpenClaw (con npm 11.16+ o 12, agrega --allow-scripts=openclaw)
npm install -g openclaw@latest

Paso 3: Inicio automático al arrancar la Pi, con systemd

Acá está el sentido de usar una Pi: que OpenClaw quede como servicio permanente y se inicie solo al arrancar, sin que tengas que entrar por SSH a levantarlo cada vez que se va la luz. El wizard de onboarding lo registra como servicio systemd con un solo flag:

openclaw onboard --install-daemon

El wizard te va a pedir la API key del proveedor de IA, el puerto del gateway (por defecto 18789) y los canales que quieras conectar (Telegram, Slack, Discord, WhatsApp). Al terminar, OpenClaw queda con arranque automático: se levanta solo cada vez que reinicias o enciendes la Pi, sin que tengas que ejecutar nada a mano.

Comandos útiles para administrarlo:

openclaw status                                    # ¿está activo el gateway?
openclaw --version                                 # versión instalada
systemctl --user status openclaw-gateway.service   # estado del servicio systemd
journalctl --user -u openclaw-gateway.service -f   # ver logs en vivo

El servicio es una unidad de usuario de systemd. En una Pi headless, activa lingering una vez para que siga corriendo aunque cierres la sesión SSH:

sudo loginctl enable-linger "$(whoami)"

Paso 4: Acceso remoto con Cloudflare Tunnel

El gateway de OpenClaw escucha en 127.0.0.1:18789, o sea solo dentro de la Pi. Para llegar desde afuera no abras puertos en tu router (mala idea exponer tu casa a internet). Desde tu computadora, lo más simple es un túnel SSH, que es lo que propone la documentación oficial:

ssh -N -L 18789:127.0.0.1:18789 tu-usuario@raspberrypi.local

Si quieres una URL HTTPS fija para entrar también desde el celular, la documentación de OpenClaw sobre Cloudflare Tunnel y Access describe la topología soportada: el gateway sigue en loopback, cloudflared corre en la Pi como servicio con un túnel con nombre que apunta a http://localhost:18789, y Cloudflare Access autentica cada petición antes de que llegue a OpenClaw. El binario para la Pi es el de ARM64:

# Instalar cloudflared (ARM64)
curl -fsSL https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64 -o cloudflared
sudo install cloudflared /usr/local/bin/

No publiques el gateway con un túnel rápido (cloudflared tunnel --url) sin Access delante: quedaría una URL pública sin una capa de identidad. La otra opción soportada es Tailscale.

¿Y Docker en la Pi?

OpenClaw también corre en Docker, y en una Pi de 64 bits funciona con la imagen oficial, que se publica para linux/arm64. Si ya manejas contenedores, el flujo con docker-compose es el mismo que en cualquier Linux, y lo cubro paso a paso en la guía de OpenClaw con Docker Compose. Para la mayoría de las Pi, el script o npm con un Node 24 nativo es más liviano que sumar la capa de Docker. Si estás decidiendo dónde correrlo, la guía de OpenClaw compara las rutas una al lado de la otra.

Preguntas frecuentes

Cierre

Una Pi 5 (o Pi 4 de 4 GB) con Raspberry Pi OS de 64 bits, OpenClaw como servicio systemd y un túnel SSH o Cloudflare Tunnel con Access para el acceso remoto: ese es el setup completo de un asistente de IA privado, siempre encendido y de bajo consumo. Si todavía no decidiste qué hacer con él, en la guía completa de OpenClaw están las demás plataformas y la configuración de canales y skills.

Si la Pi se te queda corta y das el salto a un VPS, el servidor 24/7 en Ubuntu usa el mismo servicio systemd, así que la configuración se traslada casi sin cambios.

Fuentes

• Raspberry Pi: guía oficial de OpenClaw (tabla de hardware, requisitos, servicio systemd y acceso remoto).
• Install y Node.js compatibility: versiones de Node soportadas y qué instala el script.
• No Mac Mini, no worries: running OpenClaw on a Raspberry Pi: howto de ajfisher con una Pi 5 y Raspberry Pi OS Lite 64-bit.