Instalar OpenClaw en Raspberry Pi 4 y 5 (y por qué no la 3)

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 la guía de instalación de OpenClaw; aquí voy directo a lo que cambia en la Pi.

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

OpenClaw pide Node.js 22+ y al menos 4 GB de RAM (8 GB para uso intensivo). Ese requisito de memoria es el que decide qué Pi sirve:

Modelo	RAM	¿Sirve?
Raspberry Pi 5 (4/8/16 GB)	4–16 GB	✅ La mejor opción
Raspberry Pi 4 (4 u 8 GB)	4–8 GB	✅ Mínimo viable (la de 4 GB puede usar swap)
Raspberry Pi 4 (2 GB)	2 GB	❌ Por debajo del mínimo
Raspberry Pi 3 / 3B+	1 GB	❌ No alcanza
Raspberry Pi Zero 2 W	512 MB	❌ No alcanza

Lo digo claro porque mucha gente busca "OpenClaw en Raspberry Pi 3": la Pi 3 no llega, tiene como máximo 1 GB de RAM y el mínimo es 4 GB. La Pi 4 de 4 GB es el piso real (ya usa swap bajo carga); lo cómodo es una Pi 5 con 8 GB.

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

Node.js 22 necesita un sistema de 64 bits. Instalá 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 (⚙️) 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

Confirmá que es 64 bits (debe decir aarch64):

uname -m

Paso 2: Instalar OpenClaw

El script oficial detecta la arquitectura ARM e instala Node 22 por ti. Es la vía recomendada en la Pi:

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

Si prefieres hacerlo a mano, primero necesitas Node 22+ para ARM64 (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 22
curl -fsSL https://fnm.vercel.app/install | bash
exec $SHELL
fnm install 22 && fnm use 22
 
# Verificar
node --version   # v22.x o superior
 
# Instalar OpenClaw
npm install -g openclaw@latest

Paso 3: Dejarlo corriendo 24/7 con systemd

Acá está el sentido de usar una Pi: que OpenClaw quede como servicio permanente. 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, el agente sobrevive reinicios de la Pi.

Comandos útiles para administrarlo:

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

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 sin abrir puertos en tu router (mala idea exponer tu casa a internet), lo más seguro es un Cloudflare Tunnel: una conexión saliente cifrada, sin IP pública ni port-forwarding.

# Instalar cloudflared (ARM64)
curl -fsSL https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64 -o cloudflared
sudo install cloudflared /usr/local/bin/
 
# Autenticar y crear el túnel
cloudflared tunnel login
cloudflared tunnel --url http://localhost:18789

Cloudflare te devuelve una URL pública (o puedes mapear un subdominio tuyo) que apunta al gateway de la Pi, con HTTPS y sin exponer tu red. Es el patrón que recomienda la comunidad para acceder a OpenClaw en la Pi desde el celular.

¿Y Docker en la Pi?

OpenClaw también corre en Docker, y en una Pi de 64 bits funciona siempre que la imagen sea multi-arquitectura (ARM64). Si ya manejas contenedores, el flujo con docker-compose es el mismo que en cualquier Linux —lo cubro en la sección de Docker de la guía principal. Para la mayoría de las Pi, el script o npm con un Node 22 nativo es más liviano que sumar la capa de Docker.

Preguntas frecuentes

¿Funciona OpenClaw en una Raspberry Pi 3?

No de forma usable. La Pi 3 tiene como máximo 1 GB de RAM y OpenClaw necesita al menos 4 GB. Lo mínimo recomendable es una Pi 4 de 4 GB.

¿Cuánta RAM necesita OpenClaw en la Pi?

4 GB para funcionar, 8 GB para uso intensivo (varios canales y skills activos a la vez).

¿Consume mucha energía dejarla 24/7?

No: una Raspberry Pi 4 o 5 consume unos pocos vatios, mucho menos que dejar una computadora encendida. Por eso es el equipo ideal para un agente siempre activo.

¿Tengo que dejar la laptop prendida?

No. Esa es la gracia: el agente vive en la Pi. Apagas la laptop y OpenClaw sigue revisando emails, respondiendo en tus canales y ejecutando tus skills.

Cierre

Una Pi 5 (o Pi 4 de 4 GB+) con Raspberry Pi OS de 64 bits, OpenClaw como servicio systemd y un Cloudflare Tunnel 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.

Fuente

No Mac Mini, no worries: running OpenClaw on a Raspberry Pi — howto de referencia de ajfisher (Pi 5 8GB, mínimo Pi 4 4GB, Raspberry Pi OS Lite 64-bit, Node 22).