🚀 Cómo instalar OpenClaw en una Raspberry Pi (Guía Completa)
Esta guía incluye todos los pasos necesarios para instalar OpenClaw en una Raspberry Pi, incluyendo formateo, configuración, modelos, Telegram, agentes y túnel SSH.
✅ Requerimientos
- Tener una Raspberry Pi 3, 4 o 5\
- Tener instalado Raspberry Pi OS 64 bits (ARM64)
⚠️ Recomendado: Raspberry Pi 4 u 8GB RAM o superior.
La Raspberry Pi 3 puede quedarse sin memoria durante la instalación.
💽 Instalar / Formatear Raspberry Pi (ARM64)
Descarga el instalador oficial desde:
https://www.raspberrypi.com/software/
- Instala Raspberry Pi Imager
- Selecciona Raspberry Pi OS
- Asegúrate de elegir la versión 64 bits
- Flashea la tarjeta SD
- Inicia tu Raspberry Pi
📦 Instalar OpenClaw
Documentación oficial:
https://docs.openclaw.ai/install
Instalación directa:
curl -fsSL https://openclaw.ai/install.sh | bash
⚙️ Onboarding
Durante la instalación:
- Selecciona manual
- En "What do you want to setup" elige:
👉 Local Gateway
🤖 Opciones de Modelos
Puedes usar:
- OpenRouter\
- Minimax\
- Anthropic API Key\
- ChatGPT Plus (Codex)
Si usas ChatGPT Plus, selecciona Codex login para hacer el pairing.
DM Access -- Pairing requerido según proveedor.
📱 Telegram
Primero asegúrate de:
- Ir a configuración
- Habilitar plugins
- Buscar el plugin de Telegram
- Activarlo
- Guardar cambios
Luego:
openclaw pairing list telegram
Otros comandos útiles:
openclaw doctor
🧠 Gestión de Modelos
Comandos base:
openclaw models --help
openclaw models list
openclaw models add
openclaw models test
openclaw models default <modelo>
Autenticación de proveedores:
openclaw auth --help
openclaw models auth add
openclaw auth login <provider>
openclaw auth list
🔧 Configuración adicional
Para reconfigurar:
openclaw configure
Para listar modelos nuevamente:
openclaw models list
🌐 Web UI vía SSH Tunneling
Exponer el puerto:
ssh -L 18789:127.0.0.1:18789 fazt@192.168.1.56
Acceder desde navegador:
http://localhost:18789/chat?session=agent%3Amain%3Amain
🧩 Agents
En la sección:
Agents → Files
Verás los archivos principales de OpenClaw donde puedes modificar comportamiento, memoria y configuraciones del agente.
🏁 Conclusión
OpenClaw puede ejecutarse en Raspberry Pi 3, 4 o 5, pero se recomienda hardware con mayor RAM para mejor rendimiento.
La clave está en:
- Usar Raspberry OS 64 bits
- Configurar correctamente modelos
- Habilitar plugins (Telegram)
- Usar SSH tunneling para la Web UI
- Gestionar correctamente autenticaciones
Autor: Fazt