Guía de configuración de OpenClaw Linux: instalar en Ubuntu, Debian, Fedora y Raspberry Pi

Introducción

Linux es una plataforma excelente para ejecutar OpenClaw, especialmente para servidores siempre activos e implementaciones de Raspberry Pi. Esta guía cubre la instalación en distribuciones populares de Linux, incluidos los sistemas operativos Ubuntu, Debian, Fedora y Raspberry Pi, además de compatibilidad con ARM64 y configuración del servicio systemd.

Para obtener instrucciones generales de instalación, consulte nuestra guía de instalación completa.

Requisitos del sistema

Distribuciones admitidas

• Ubuntu 20.04+ (se recomienda LTS)
• Debian 11+ (Bullseye o posterior)
• Fedora 34+
• Raspberry Pi OS (basado en Debian)
• Arch Linux (a través de AUR o instalación manual)
• Otras distribuciones basadas en Debian/Ubuntu

Requisitos de hardware

• RAM: se recomiendan más de 2 GB (mínimo 1 GB para Raspberry Pi)
• Almacenamiento: más de 500 MB para instalación, espacio adicional para memoria/datos
• CPU: arquitectura x86_64 o ARM64
• Red — Conexión a Internet para llamadas API y actualizaciones

Requisitos previos del software

• Node.js 18+: puede instalarse automáticamente mediante el instalador de una sola línea
• curl — Generalmente preinstalado
• git — Opcional, para instalación pirateable desde el código fuente
• systemd — Para gestión de servicios (la mayoría de las distribuciones modernas)

Métodos de instalación

Método 1: Instalación de una sola línea (recomendado)

La forma más sencilla de instalar OpenClaw en Linux:

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

Este script automáticamente:

• Detecta tu distribución de Linux.
• Instala Node.js si falta (a través de NodeSource o el administrador de paquetes de distribución)
• Instala OpenClaw globalmente a través de npm
• Configura los permisos necesarios
• Verifica la instalación.

Nota: Es posible que se le solicite su contraseña (sudo) para instalar Node.js o paquetes del sistema.

Método 2: instalación de npm

Si ya tienes Node.js instalado:

npm i -g openclaw

Primero verifique la versión de Node.js:

node --version

Debe ser v18.0.0 o superior.

Método 3: Paquetes específicos de distribución

Ubuntu/Debian (a través de apt)

Algunas distribuciones pueden tener paquetes OpenClaw disponibles:

# Add repository (if available)
curl -fsSL https://openclaw.ai/repo/deb/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/openclaw.gpg
echo "deb [signed-by=/usr/share/keyrings/openclaw.gpg] https://openclaw.ai/repo/deb stable main" | sudo tee /etc/apt/sources.list.d/openclaw.list

# Install
sudo apt update
sudo apt install openclaw

Nota: Es posible que los paquetes oficiales aún no estén disponibles. Consulte docs.openclaw.ai para conocer los métodos de instalación más recientes.

Fedora (vía dnf)

# Add repository (if available)
sudo dnf install openclaw

Arch Linux (a través de AUR)

yay -S openclaw
# or
paru -S openclaw

Método 4: Instalación pirateable (desde la fuente)

Para desarrolladores que quieran modificar la fuente:

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

Luego ejecuta:

npm run openclaw onboard

O enlace globalmente:

sudo npm link --global

Instalando Node.js

Ubuntu/Debian

Opción 1: Repositorio NodeSource (recomendado)

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

Opción 2: Paquetes de distribución

sudo apt update
sudo apt install nodejs npm

Nota: Los paquetes de distribución pueden estar desactualizados. NodeSource proporciona versiones más nuevas.

Opción 3: nvm (Administrador de versiones de nodo)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18

Fedora

sudo dnf install nodejs npm

O utilice NodeSource:

curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo dnf install -y nodejs

Raspberry Pi (ARM64/ARMv7)

Sistema operativo Raspberry Pi (basado en Debian)

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

Para ARMv7 (32 bits), es posible que NodeSource no tenga paquetes. Utilice paquetes de distribución o compílelos desde el código fuente.

Alternativa: instalar a través de nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18

Configuración posterior a la instalación

Después de la instalación, configure OpenClaw:

openclaw onboard

Esta configuración interactiva cubre:

1. Configuración del modelo de IA

Elija su proveedor de IA:

Claude Anthropic:

• Soneto de Claude 3.5 (recomendado)
• Claude 3 Opus
• Claudio 4

Obtenga su clave API de console.anthropic.com.

OpenAI GPT:

• GPT-4o
• GPT-4 Turbo
• GPT-4.1

Obtenga su clave API de platform.openai.com.

Modelos locales:

• Ollama (se ejecuta localmente, no se necesita clave API)
• Estudio LM
• MiniMax

2. Permisos de Linux

OpenClaw puede necesitar permisos:- Sistema de archivos: acceso de lectura/escritura a ~/.openclaw

• Red: para llamadas API y puentes de chat
• Comandos del sistema: si se utilizan funciones de control del sistema

3. Configuración del cortafuegos

Permitir OpenClaw a través del firewall:

UFW (Ubuntu/Debian):

sudo ufw allow 3000/tcp

cortafuegos (Fedora/RHEL):

sudo firewall-cmd --add-port=3000/tcp --permanent
sudo firewall-cmd --reload

Ejecutando OpenClaw

Iniciar el servidor

openclaw

Esto inicia el servidor local y conecta todas las integraciones configuradas.

Ejecutar en segundo plano

Utilice nohup:

nohup openclaw > ~/.openclaw/logs/output.log 2>&1 &

O utilice screen:

screen -S openclaw
openclaw
# Press Ctrl+A then D to detach

O utilice tmux:

tmux new -s openclaw
openclaw
# Press Ctrl+B then D to detach

Ejecutar como servicio systemd (siempre activo)

Cree un servicio systemd para inicio automático:

1. Crear archivo de servicio:

   sudo nano /etc/systemd/system/openclaw.service

2. Agregar configuración:

   [Unit]
   Description=OpenClaw Personal AI Assistant
   After=network.target
   
   [Service]
   Type=simple
   User=your-username
   WorkingDirectory=/home/your-username
   ExecStart=/usr/bin/openclaw
   Restart=always
   RestartSec=10
   Environment="NODE_ENV=production"
   
   [Install]
   WantedBy=multi-user.target

   Reemplace your-username con su nombre de usuario real.

3. Recargar sistema:

   sudo systemctl daemon-reload

4. Habilitar servicio:

   sudo systemctl enable openclaw

5. Iniciar servicio:

   sudo systemctl start openclaw

6. Verificar estado:

   sudo systemctl status openclaw

7. Ver registros:

   sudo journalctl -u openclaw -f

Usando pm2 (Administrador de procesos)

Instalar pm2:

npm i -g pm2

Inicie OpenClaw:

pm2 start openclaw
pm2 save
pm2 startup

El comando pm2 startup generará un servicio systemd automáticamente.

Configuración específica de Raspberry Pi

Optimización del rendimiento

Raspberry Pi tiene recursos limitados. Optimizar:

1. Utilice modelos de IA más ligeros:

   • Los modelos locales (Ollama) son más eficientes
   • O utilice modelos de nube más pequeños

2. Limitar operaciones simultáneas:

   • Configurar OpenClaw para manejar menos solicitudes simultáneas

3. Monitorear recursos:

   htop

Configuración siempre activa

Para Raspberry Pi funcionando 24 horas al día, 7 días a la semana:

1. Utilice el servicio systemd (ver arriba)
2. Habilite el inicio de sesión automático (si es necesario)
3. Configurar administración de energía:

   sudo raspi-config
   # Navigate to Advanced Options → Wait for Network at Boot

Túnel de Cloudflare (acceso externo)

Exponga OpenClaw a Internet de forma segura:

1. Instalar Cloudflared:

   curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64 -o cloudflared
   chmod +x cloudflared
   sudo mv cloudflared /usr/local/bin/

2. Autenticarse:

   cloudflared tunnel login

3. Crear túnel:

   cloudflared tunnel create openclaw

4. Configurar: Cree ~/.cloudflared/config.yml:

   tunnel: <tunnel-id>
   credentials-file: /home/pi/.cloudflared/<tunnel-id>.json
   
   ingress:
     - hostname: openclaw.yourdomain.com
       service: http://localhost:3000
     - service: http_status:404

5. Ejecutar túnel:

   cloudflared tunnel run openclaw

6. Agregar a systemd (para inicio automático):

   sudo cloudflared service install

Soporte ARM64

OpenClaw funciona en la arquitectura ARM64:

• Apple Silicon Macs (a través de Linux VM)
• Raspberry Pi 4+ (64 bits)
• Instancias de AWS Graviton
• Otros servidores ARM64

La instalación es idéntica a x86_64. El instalador de una sola línea detecta la arquitectura automáticamente.

Para ARMv7 (Raspberry Pi de 32 bits), es posible que algunos paquetes no estén disponibles. Utilice paquetes de distribución o compílelos desde el código fuente.

Solución de problemas

Errores de permiso denegado

Si ve errores de permiso:

sudo npm i -g openclaw

O arreglar los permisos de npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Comando no encontrado

Si no se encuentra openclaw:

1. Verifique la ruta global de npm:

   npm config get prefix

2. Agregar a RUTA:

   echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
   source ~/.bashrc

3. Reiniciar terminal

Puerto ya en uso

Cambiar el puerto:

openclaw --port 3001

O busque y elimine el proceso:

lsof -ti:3000 | xargs kill
# or
sudo netstat -tlnp | grep :3000
sudo kill <PID>

Problemas con el servicio systemd

Si el servicio no se inicia:

1. Verificar registros:

   sudo journalctl -u openclaw -n 50

2. Verificar usuario: Asegúrese de que el servicio se ejecute como el usuario correcto

3. Verificar permisos:

   ls -la ~/.openclaw

4. Prueba manualmente:

   openclaw

Problemas específicos de Raspberry Pi

Poca memoria:

# Increase swap
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# Set CONF_SWAPSIZE=2048
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

Rendimiento lento:

• Utilice modelos de IA más ligeros
• Limitar las sesiones del navegador
• Reducir el uso de memoria

Consejos de rendimiento

Monitoreo de recursos

Monitorear CPU y memoria:

htop
# or
top

Supervisar el uso del disco:

df -h
du -sh ~/.openclaw
```### Optimización

- **Utilice modelos locales** para obtener un mejor rendimiento en hardware de gama baja
- **Limitar las sesiones del navegador** para reducir el uso de memoria
- **Configurar la rotación de registros** para evitar que el disco se llene
- **Utilice SSD** en lugar de tarjeta SD (Raspberry Pi)

## Actualizando OpenClaw

Actualizar a la última versión:

```bash
npm update -g openclaw

O vuelva a ejecutar el instalador:

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

Desinstalar

Quitar OpenClaw:

npm uninstall -g openclaw

Eliminar configuración:

rm -rf ~/.openclaw

Detenga y elimine el servicio systemd:

sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

Próximos pasos

Ahora que OpenClaw está instalado en Linux:

1. Configurar siempre activo: configurar el servicio systemd
2. Conectar aplicaciones de chat: WhatsApp, Telegram, Discord
3. Explorar habilidades — Biblioteca de habilidades
4. Lea las preguntas frecuentes — Preguntas comunes

Conclusión

Linux es una plataforma excelente para OpenClaw, especialmente para implementaciones permanentes y proyectos Raspberry Pi. El instalador de una sola línea maneja la mayor parte de la complejidad y la integración de systemd facilita su ejecución como servicio.

Para obtener más ayuda, consulte nuestra guía de instalación general o página de preguntas frecuentes. ¡Feliz automatización en Linux!