Raspberry Pi 5 — Instalación, configuración y OpenClaw.

Raspberry Pi 5 — Instalación, configuración y OpenClaw.

La Raspberry Pi 5 es el nodo más especial de mi homelab. No es el más potente ni el que más servicios corre — pero es el único dedicado exclusivamente a experimentos con IA y automatización.

En este post explico cómo lo configuré desde cero y cómo instalé OpenClaw, el servicio que uso actualmente como asistente de IA conectado a un bot de Telegram.


El hardware

  • 🍓 Raspberry Pi 5
  • 💾 Disco SSD externo como disco de arranque — mucho más rápido y fiable que una microSD
  • 🔌 Cable Ethernet — sin WiFi, siempre por cable en servidores
  • ⌨️ Teclado para la configuración inicial

Paso 1 — Instalar Raspberry Pi OS

Para crear el disco de arranque usamos Raspberry Pi Imager, que puedes descargar desde la web oficial:

https://www.raspberrypi.com/software/

Conecta el SSD externo a tu ordenador, abre Raspberry Pi Imager y selecciona:

  • Dispositivo: Raspberry Pi 5
  • Sistema operativo: Raspberry Pi OS Lite — sin escritorio, solo terminal
  • Almacenamiento: tu SSD externo

Antes de escribir pulsa el icono de configuración (⚙️) y configura:

  • Nombre del equipo: el que quieras
  • Usuario y contraseña: los que usarás para conectarte
  • WiFi: yo no lo configuro — cable Ethernet siempre
  • Activar SSH: ✅ imprescindible — sin esto no puedes conectarte remotamente

⚠️ Importante: esto borrará todo el contenido del disco seleccionado. Asegúrate de seleccionar el SSD correcto.

Pulsa Escribir y espera a que termine.


Paso 2 — Primer arranque

Conecta el SSD a uno de los puertos USB de la Raspberry Pi y enciéndela.

Para conectarte por SSH necesitas saber la IP que le asignó el router. Entra en la web de administración de tu router:

http://192.168.1.1/

Busca la Raspberry Pi en la lista de dispositivos conectados y apunta su IP. Luego conéctate por SSH desde cualquier máquina de tu red:

ssh [email protected]

Paso 3 — Configurar IP estática

Lo primero siempre — IP fija para que no cambie al reiniciar. Sin esto perderías acceso cada vez que el router le asigne una IP diferente.

sudo nmtui

Dentro de la interfaz ve a Edit a connection → tu conexión Ethernet → cambia IPv4 a Manual y asigna la IP que quieras. Asegúrate de que ningún otro dispositivo de tu red tenga esa IP.


Paso 4 — Instalar Tailscale

Tailscale es la VPN mesh que uso en todo el homelab para acceder a los dispositivos desde cualquier sitio sin abrir puertos en el router.

# Instalar
curl -fsSL https://tailscale.com/install.sh | sh

# Activar y vincular con tu cuenta
sudo tailscale up

El segundo comando te dará una URL — ábrela en el navegador y acepta el dispositivo en tu red de Tailscale. A partir de ahora puedes conectarte a la Raspberry desde cualquier sitio con su IP de Tailscale.

# Verificar que está activo
tailscale status

Paso 5 — Instalar Docker

OpenClaw corre en Docker, así que hay que instalarlo primero. En Raspberry Pi OS (basado en Debian) el proceso es el siguiente:

# Añadir la clave GPG oficial de Docker
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Añadir el repositorio
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update
# Instalar Docker
sudo apt install docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

Verifica que funciona:

sudo docker run hello-world

Si ves el mensaje Hello from Docker! está todo correcto.


Paso 6 — Instalar OpenClaw

OpenClaw es un framework de agentes de IA que permite conectar diferentes proveedores de IA y automatizar tareas. Lo uso principalmente como asistente personal a través de un bot de Telegram.

La instalación es muy sencilla:

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

Una vez instalado hay que configurar al menos un proveedor de IA — OpenClaw es compatible con los principales proveedores del mercado. La configuración es a través de su panel de administración donde añades las credenciales del proveedor que uses.

💡 La parte interesante de OpenClaw es que una vez configurado puedes interactuar con él a través de diferentes interfaces — en mi caso lo tengo conectado a un bot de Telegram, lo que me permite consultarle cosas directamente desde el móvil sin abrir ninguna aplicación adicional.


Resultado final

Con esto tienes la Raspberry Pi 5 completamente operativa:

  • ✅ Raspberry Pi OS Lite instalado en SSD externo
  • ✅ IP estática configurada
  • ✅ Acceso remoto por SSH y Tailscale
  • ✅ Docker instalado
  • ✅ OpenClaw funcionando con bot de Telegram

Es el nodo más ligero del homelab pero curiosamente el que más uso en el día a día — tener un asistente de IA accesible desde Telegram en cualquier momento es más útil de lo que parece.

Actualmente también lo uso para monitorización del resto de servicios del homelab, pero eso es otro post. 👀