Introducción a OpenClaw

OpenClaw es un marco de trabajo para agentes de IA que permite la ejecución de tareas mediante comandos en lenguaje natural. Ofrece capacidades de gestión de archivos, automatización de procesos y extensiones mediante módulos denominados Skills. Requiere Node.js para su funcionamiento y puede desplegarse tanto en servidores en la nube como en entornos locales, priorizando el almacenamiento de datos en el dispositivo para mayor control y privacidad.

Requisitos previos del sistema

• Sistema operativo: Windows 11, macOS 12 o superior, Linux (Ubuntu/Debian/CentOS).
• Entorno de ejecución: Node.js versión 22.x o posterior.
• Herramientas: terminal o PowerShell, editor de texto.
• Conexión a internet para la instalación de dependencias.

Verifica la instalación de Node.js ejecutando los comandos:

node --version
npm --version

Si se muestran números de versión, el entorno está listo. De lo contrario, instala Node.js desde su sitio oficial.

Despliegue en un servidor en la nube (ejemplo general)

Este procedimiento asume un servidor con Linux, como Alibaba Cloud Linux 3, con al menos 2 GB de memoria y 40 GB de almacenamiento. Asegúrate de abrir el puerto 18789 en el grupo de seguridad del proveedor de nube.

1. Actualiza el sistema e instala dependencias: ``` sudo yum update -y sudo yum install -y curl git

2. Instala Node.js 22: ``` curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node sudo ln -s /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm

3. Configura un espejo npm para mejorar la velocidad de descarga: ``` npm config set registry https://registry.npmmirror.com

4. Instala OpenClaw globalmente: ``` npm install -g openclaw

5. Inicializa la configuración: ``` openclaw setup

   
   Sigue las indicaciones para aceptar acuerdos, seleccionar inicio rápido y habilitar canales.
   

6. Configura el acceso público: ``` openclaw config set network.host 0.0.0.0 openclaw config set network.port 18789

7. Inicia el servicio: ``` openclaw service start

8. Accede a la consola web en un navegador usando: http://IP_DEL_SERVIDOR:18789.
9. Para el inicio automático, agrega el comando al archivo rc.local: ``` echo "/usr/bin/openclaw service start" | sudo tee -a /etc/rc.local sudo chmod +x /etc/rc.local

Despliegue en entornos locales

En macOS

Instala Homebrew y luego Node.js:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw setup
openclaw service start

Accede en http://127.0.0.1:18789.

En Linux (Ubuntu/Debian)

sudo apt update
sudo apt install -y curl git nodejs npm
sudo npm install -g n
sudo n stable
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw setup
openclaw service start

En Windows 11

Abre PowerShell como administrador:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
winget install OpenJS.NodeJS --version 22.0.0
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
openclaw setup
openclaw service start

La consola estará disponible en http://127.0.0.1:18789.

Integración de módulos Skills

Los Skills extienden las funcionalidades de OpenClaw, como búsqueda web o gestión de contenido. Instala el administrador de módulos:

npm install -g skillctl

Instala Skills específicos con comandos como:

skillctl install web-search
skillctl install browser-automation
skillctl install text-summarizer

Para listar, iniciar o verificar el estado de los Skills, usa:

openclaw skill list
openclaw skill start <nombre_del_skill>
openclaw skill status <nombre_del_skill>

Reinicia el servicio para cargar los nuevos Skills:

openclaw service restart

Configuración de modelos de IA

OpenClaw requiere un modelo de IA para procesar comandos. Configura un modelo compatible editando el archivo de configuración (~/.openclaw/config.json en Linux/macOS o C:\Users\<usuario>.openclaw\config.json en Windows).

Ejemplo para un modelo genérico basado en API:

"intelligence": {
  "provider": "openai-compatible",
  "api_token": "TU_CLAVE_API",
  "endpoint": "URL_BASE_DEL_ENDPOINT",
  "model_id": "gpt-3.5-turbo",
  "max_context": 2048,
  "creativity_level": 0.7
}

Reinicia el servicio tras los cambios:

openclaw service restart

Solución de problemas comunes

• Comando no encontrado: Reinstala OpenClaw con npm install -g openclaw y verifica la ruta de Node.js.
• Fallo al iniciar el servicio: Revisa la memoria disponible (mínimo 2 GB) y consulta los registros con openclaw logs.
• Puerto bloqueado: En servidores, asegúrate de que el puerto 18789 esté abierto en el firewall. Localmente, usa lsof -i:18789 (Linux/macOS) o netstat -ano | findstr "18789" (Windows) para identificar conflictos.
• Errores de API del modelo: Verifica la clave API, los permisos y la cuota de uso en la plataforma del proveedor.
• Problemas de permisos: En sistemas Unix, usa sudo para instalar paquetes. En Windows, ajusta la política de ejecución de scripts.

Uso básico de OpenClaw

1. Inicia el servicio: openclaw service start.
2. Accede a la consola web mediante la URL proporcionada.
3. Escribe instrucciones en lenguaje natural para ejecutar tareas.
4. Expande las funcionalidades instalando Skills adicionales.
5. Monitorea la actividad con openclaw logs --follow.