OpenClaw Skills | La Mayor Biblioteca de Extensiones OpenClaw

Tutorial.step

Objetivo

Ejecutar un Gateway OpenClaw persistente, siempre encendido en una Raspberry Pi por ~$35-80 costo único (sin cuotas mensuales).

Perfecto para:

- Asistente de IA personal 24/7

- Hub de automatización del hogar

- Bot de Telegram/WhatsApp de bajo consumo, siempre disponible

Tutorial.step

Requisitos de Hardware

| - |

| Pi 4 | 4GB | ✅ Bueno | Punto óptimo para la mayoría |

| Pi 4 | 2GB | ✅ OK | Funciona, agrega swap |

| Pi 4 | 1GB | ⚠️ Apretado | Posible con swap, config mínima |

| Pi 3B+ | 1GB | ⚠️ Lento | Funciona pero lento |

| Pi Zero 2 W | 512MB | ❌ | No recomendado |

Specs mínimos: 1GB RAM, 1 core, 500MB disco

Recomendado: 2GB+ RAM, OS de 64-bit, tarjeta SD de 16GB+ (o USB SSD)

Tutorial.step

Qué Necesitarás

- Raspberry Pi 4 o 5 (2GB+ recomendado)

- Tarjeta MicroSD (16GB+) o USB SSD (mejor rendimiento)

- Fuente de alimentación (PSU oficial de Pi recomendado)

- Conexión de red (Ethernet o WiFi)

- ~30 minutos

Tutorial.step

1) Flashear el OS

Usa Raspberry Pi OS Lite (64-bit) — no se necesita desktop para un servidor headless.

1. Descarga ''Raspberry Pi Imager''

2. Elige OS: Raspberry Pi OS Lite (64-bit)

3. Haz clic en el ícono de engranaje (⚙️) para pre-configurar:

- Establecer hostname: ''gateway-host''

- Habilitar SSH

- Establecer usuario/contraseña

- Configurar WiFi (si no usas Ethernet)

4. Flashea a tu tarjeta SD / unidad USB

5. Inserta y arranca el Pi

Tutorial.step

2) Conectar vía SSH

Bash

ssh user@gateway-host

ssh [email protected]

Tutorial.step

3) Configuración del Sistema

Bash

sudo apt update && sudo apt upgrade -y


sudo apt install -y git curl build-essential


sudo timedatectl set-timezone America/Chicago  # Change to your timezone

Tutorial.step

4) Instalar Node.js 22 (ARM64)

Bash

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs


node --version  # Should show v22.x.x
npm --version

Tutorial.step

5) Agregar Swap (Importante para 2GB o menos)

Swap previene crashes por falta de memoria:

Bash

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile


echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab


echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

Tutorial.step

6) Instalar OpenClaw

Tutorial.step

Opción A: Instalación Estándar (Recomendada)

Bash

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

Tutorial.step

Opción B: Instalación Hackeable (Para experimentar)

Bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link

La instalación hackeable te da acceso directo a logs y código — útil para depurar problemas específicos de ARM.

Tutorial.step

7) Ejecutar Onboarding

Bash

openclaw onboard --install-daemon

Sigue el asistente:

1. Modo Gateway: Local

2. Auth: Claves API recomendadas (OAuth puede ser problemático en Pi headless)

3. Canales: Telegram es el más fácil para empezar

4. Demonio: Sí (systemd)

Tutorial.step

8) Verificar Instalación

Bash

openclaw status


sudo systemctl status openclaw


journalctl -u openclaw -f

Tutorial.step

9) Acceder al Dashboard

Como el Pi es headless, usa un túnel SSH:

Bash

ssh -L 18789:localhost:18789 user@gateway-host


open http://localhost:18789

O usa Tailscale para acceso siempre activo:

Bash

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up


openclaw config set gateway.bind tailnet
sudo systemctl restart openclaw

Tutorial.step

Notas Específicas de ARM

Tutorial.step

Compatibilidad de Binarios

La mayoría de las características de OpenClaw funcionan en ARM64, pero algunos binarios externos pueden necesitar compilaciones ARM:

PlatformsRaspberryPiPage.step16.p2

PlatformsRaspberryPiPage.step16.p3

Tutorial.step

Configuración de Modelo Recomendada

Como el Pi es solo el Gateway (los modelos corren en la nube), usa modelos basados en API:

Json

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-20250514",
        "fallbacks": ["openai/gpt-4o-mini"]
      }
    }
  }
}

No intentes ejecutar LLMs locales en un Pi — incluso modelos pequeños son muy lentos. Deja que Claude/GPT haga el trabajo pesado.

Tutorial.step

Solución de Problemas

Tutorial.step

Sin Memoria (OOM)

Bash

free -h

Tutorial.step

Rendimiento Lento

- Usa SSD USB en lugar de tarjeta SD

- Deshabilita servicios no usados: ''sudo systemctl disable cups bluetooth avahi-daemon''

- Verifica throttling de CPU: ''vcgencmd get_throttled'' (debe retornar ''0x0'')

Tutorial.step

El Servicio No Inicia

Bash

journalctl -u openclaw --no-pager -n 100


cd ~/openclaw  # if using hackable install
npm run build
sudo systemctl restart openclaw

Tutorial.step

Problemas de Binarios ARM

Si una skill falla con "exec format error":

1. Verifica si el binario tiene build ARM64

2. Intenta compilar desde fuente

3. O usa un contenedor Docker con soporte ARM

Tutorial.step

Caídas de WiFi

Para Pis headless en WiFi:

Bash

sudo iwconfig wlan0 power off


echo 'wireless-power off' | sudo tee -a /etc/network/interfaces

Tutorial.step

Ver También

- ''Guía Linux'' — configuración general de Linux

- ''Guía DigitalOcean'' — alternativa en la nube

- ''Guía Hetzner'' — configuración Docker

- ''Tailscale'' — acceso remoto

- ''Nodos'' — empareja tu laptop/teléfono con el gateway Pi