Saltar al contenido
Grafico de infraestructura local para correr agentes en Raspberry Pi, mini servidor o VPS
Lección 2 de 5Gratis12 min

Hardware, sistema operativo y red

Prepara una Pi o mini servidor Linux antes de instalar el agente

Última actualización: 24 de septiembre de 2026

El agente no necesita GPU si usas modelos por API. Lo que necesita es energía estable, disco que no se corrompa y una red que no cambie de IP cada hora.

Hardware recomendado

EquipoRecomendaciónPor que
Raspberry PiPi 4 o Pi 5 con 4 GB RAM o más2 GB se queda corto cuando Node o Python + gateway coexisten
AlmacenamientomicroSD A2 de marca, o SSD USBLas tarjetas baratas mueren con logs y swaps
EnergíaFuente oficial o de 5V/5A según el modeloUn cargador de teléfono viejo reinicia la placa
RedEthernet si puedesWi-Fi sirve si es estable; no si el AP se duerme
Alternativamini PC, VPS Linux o Mac mini viejoMisma receta: Linux 64-bit, SSH, systemd
⚠️

No improvises la fuente

Si la Pi se apaga a media escritura, corrompes la microSD. Eso se parece a "el agente se volvió loco" y casi nunca es el modelo.

Sistema operativo

Usa Linux 64-bit. En Raspberry Pi, instala Raspberry Pi OS 64-bit (Lite si no necesitas escritorio) o Ubuntu Server.

Verificar arquitectura, sistema y RAM
$uname -m cat /etc/os-release free -h

Busca aarch64 o arm64 en una Pi moderna. Si ves armv7l, estás en 32-bit: cambia de imagen antes de instalar Node u OpenClaw.

Crea un usuario propio. No dejes pi con la contraseña de fabrica.

Red y acceso

Activa SSH en el imager o con raspi-config. Desde tu computadora:

Entrar por SSH

Si .local no resuelve, usa la IP que te da el router. Anota esa IP o reserva DHCP para que no cambie.

Actualiza paquetes una vez, no en medio de un onboarding:

Actualizar sistema
$sudo apt update sudo apt upgrade -y sudo reboot

Seguridad básica (antes del runtime)

  1. Cambia la contraseña o, mejor, usa llaves SSH.
  2. Desactiva login por contraseña cuando las llaves funcionen.
  3. No abras el puerto 22 a internet "porque es más cómodo".
  4. Si usas VPS, un firewall que solo permita tu IP o un salto (Tailscale, WireGuard) es más sano que 0.0.0.0/0.
⚠️

Gateway expuesto

Un agente con tools es un usuario más en esa máquina. Si el gateway queda público sin lista de usuarios, cualquiera puede pedirle que lea archivos o dispare comandos.

Carpeta de trabajo

Separa runtime, backups y logs. Así un rm o un tar no se come todo.

Crear carpetas
$mkdir -p ~/agents ~/backups ~/logs chmod 700 ~/agents ~/backups

En ~/agents vivirá el working directory de Hermes o los archivos que OpenClaw no deba mezclar con backups.

Checklist antes de la siguiente lección

Listo para instalar runtime0/6