Como instalar OpenClaw paso a paso

Que es OpenClaw?

OpenClaw fue el primer ecosistema de skills para asistentes de IA. Aunque revolucionario, tiene importantes problemas de seguridad documentados por Microsoft, Adversa AI y Contabo. Su creador original lo abandonó y ha sido reemplazado por alternativas más seguras como Hermes Agent.

En esta guia completa te enseñaremos a instalarlo desde cero, configurarlo con diferentes proveedores de IA, asegurarlo correctamente, y sacarle el maximo partido con consejos profesionales y flujos de trabajo reales. Al final, como bonus, te explicamos como potenciarlo con las 1136 skills de SKILLSBUNDLE.

Requisitos del sistema

Antes de empezar, asegurate de que tu sistema cumple estos requisitos:

• Sistema operativo: macOS 12+, Windows 10+ (64-bit) o Ubuntu 20+ / Debian 11+ / Fedora 38+
• RAM: 8 GB minimo (16 GB recomendado para proyectos grandes)
• Disco: 500 MB para la herramienta + espacio para tus proyectos
• Node.js 18+ (si la instalacion es via npm)
• Python 3.9+ (para herramientas como Aider y Hermes Agent)
• Git (para herramientas que trabajan con repositorios)
• Conexion a internet (para descargar e instalar; para IA en la nube)
• Terminal: bash, zsh o PowerShell

Metodos de instalacion

Hay varias formas de instalar OpenClaw. Elige la que mejor se adapte a tu sistema y preferencias:

npm

npm install -g openclaw
Requiere Node.js 18+. Es el método de instalación estándar.

Desde GitHub

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

Docker

docker pull openclaw/openclaw
docker run -d --name openclaw -p 18780:18780 openclaw/openclaw

Verificar la instalacion

Una vez instalado, verifica que todo funciona:

openclaw --version

Si ves un error, revisa la seccion de solucion de problemas al final de la guia.

Configurar autenticacion y proveedores de IA

La mayoria de herramientas de IA requieren configurar al menos un proveedor de modelos. Aqui tienes las opciones disponibles para OpenClaw:

API Key local

OpenClaw no requiere autenticación externa por defecto. Configura los proveedores en openclaw.json.

OpenRouter

Configura en openclaw.json: "provider": "openrouter", "apiKey": "sk-or-..."
Recomendado para evitar APIs directas.

Anthropic

Configura en openclaw.json: "provider": "anthropic", "apiKey": "sk-ant-..."

Ollama (local)

Configura en openclaw.json: "provider": "ollama", "apiBase": "http://localhost:11434"

Proveedores alternativos

No tienes por que limitarte a un solo proveedor. Aqui tienes una comparativa de los principales proveedores de IA que puedes usar:

Seguridad: mejores practicas

La seguridad es critica cuando usas herramientas de IA que tienen acceso a tu sistema. Sigue estas recomendaciones:

• OpenClaw NO es seguro. Microsoft recomienda no ejecutarlo con cuentas principales o en dispositivos con datos sensibles.
• OpenClaw Gateway nunca debe exponerse en 0.0.0.0. Usa exclusivamente Tailscale para acceso remoto.
• ClawHub (el mercado de skills de OpenClaw) ha tenido ataques de supply chain: 335+ skills maliciosas distribuyendo malware.
• El creador original abandonó OpenClaw. No hay actualizaciones de seguridad. Cuentas de Twitter abandonadas fueron secuestradas para estafar.
• Si usas OpenClaw, aíslało en un contenedor Docker con --read-only y --cap-drop=ALL.
• Ejecuta: openclaw security audit --deep --fix para identificar malas configuraciones.
• Habilita el firewall del sistema y bloquea todos los puertos excepto los necesarios.
• Considera migrar a Hermes Agent (Nous Research) o Claude Code (Anthropic) que tienen mejor seguridad y soporte activo.
• No instales skills de fuentes no verificadas. Los skills pueden ejecutar código arbitrario en tu máquina.
• Monitorea los costos de API: OpenClaw puede consumir recursos sin control si no configuras límites.

Consejos profesionales

Una vez que OpenClaw funciona, estos consejos te ayudaran a usarlo como un experto:

• NO uses OpenClaw para proyectos nuevos. El proyecto está abandonado y tiene vulnerabilidades de seguridad críticas.
• Si ya tienes OpenClaw funcionando, migra a Hermes Agent o Claude Code. SKILLSBUNDLE es compatible con ambos.
• El gateway de OpenClaw en modo Funnel (Tailscale) es más seguro que bind a 0.0.0.0, pero sigue siendo riesgoso.
• OpenClaw no tiene actualizaciones automáticas. No recibirás parches de seguridad.
• Los skills de OpenClaw son compatibles con Claude Code, Cursor y Cline. Puedes migrarlos sin cambios.
• Considera el costo: OpenClaw recomienda Claude Opus 4.5 para evitar prompt injection (el modelo más caro).
• Para usuarios existentes: migra tus skills a ~/.claude/skills/ (Claude Code) o ~/.hermes/skills/ (Hermes Agent).
• No compartas tu configuración de OpenClaw (openclaw.json contiene API keys y rutas del sistema).

Flujos de trabajo recomendados

Estos son los casos de uso mas potentes de OpenClaw:

• Migración a Hermes: copia ~/.openclaw/skills/* a ~/.hermes/skills/ y configura hermes setup
• Migración a Claude Code: copia ~/.openclaw/skills/* a ~/.claude/skills/
• Uso legacy (solo si ya tienes OpenClaw): usa skills existentes sin actualizar la plataforma
• Contenedor aislado: ejecuta OpenClaw en Docker con --read-only y --cap-drop=ALL para minimizar riesgos

Solucion de errores comunes

openclaw: command not found

npm global no está en PATH. Solución: export PATH=$PATH:$(npm config get prefix)/bin

Error: 'Gateway crashed'

OpenClaw Gateway es inestable. Solución: reinicia con openclaw gateway restart. Considera migrar a Hermes Agent.

Error: 'Skill not found'

El skill no está en el directorio. Solución: verifica ~/.openclaw/skills/ y que el nombre del skill sea correcto.

Error de seguridad: puerto expuesto

OpenClaw se bindeó a 0.0.0.0. Solución: cambia a bind: 'loopback' en openclaw.json y usa Tailscale.

Error: 'Provider rejected'

El proveedor de IA bloqueó la solicitud. Solución: cambia de proveedor o verifica tu API key.

Consumo excesivo de API

OpenClaw no tiene límites de costos. Solución: configurar límites en el proveedor (OpenRouter ofrece límites de gasto).

Error: 'ClawHub connection failed'

ClawHub puede estar caído o bloqueado. Solución: instala skills manualmente desde SKILLSBUNDLE.

Versión desactualizada

OpenClaw no recibe actualizaciones. Solución: migra a una alternativa con soporte activo.

Preguntas frecuentes

¿Puedo usar varios proveedores a la vez?

Si, la mayoria de herramientas permiten configurar multiples modelos. Puedes usar uno rapido (Haiku, GPT-4o-mini) para tareas simples y uno potente (Opus, GPT-5) para tareas complejas.

¿Funciona sin conexion a internet?

Solo si usas modelos locales con Ollama, LM Studio o llama.cpp. Los modelos en la nube requieren conexion permanente.

¿Cual es el mejor proveedor para empezar?

OpenRouter: una sola API key, 300+ modelos, facturación consolidada. Puedes probar todos los modelos sin comprometerte con uno.

¿Como protejo mis API keys?

Usa variables de entorno (export CLAVE=valor), nunca las incluyas en el codigo, anade .env a .gitignore, y usa un gestor de secrets como 1Password o Bitwarden.

¿Puedo compartir mi configuracion con el equipo?

Comparte el archivo de configuracion sin las API keys. Usa variables de entorno para los secrets y documenta que variables necesita cada miembro del equipo.

Comparativa: como se compara con otras herramientas

Configuracion avanzada

Si ya tienes OpenClaw y necesitas migrar:

• Migrar a Hermes Agent: copia ~/.openclaw/skills/* a ~/.hermes/skills/ y ejecuta hermes setup.
• Migrar a Claude Code: copia ~/.openclaw/skills/* a ~/.claude/skills/.
• Migrar a Cursor: copia las skills a ~/.cursor/skills/.
• Compatibilidad: los skills de OpenClaw son compatibles con Claude Code, Cursor, Cline y Hermes Agent sin modificaciones.
• Configuracion: exporta tu configuracion de openclaw.json (sin API keys) antes de migrar.

Ejemplos de uso reales

Estos son prompts reales que puedes usar para empezar a trabajar inmediatamente con tu herramienta recien instalada. Copia y pega, adapta segun tu proyecto:

# 1. Migrar skills a Hermes Agent
cp -r ~/.openclaw/skills/* ~/.hermes/skills/
hermes setup --provider openrouter
hermes "Verifica que las skills se cargaron correctamente"

# 2. Migrar skills a Claude Code
cp -r ~/.openclaw/skills/* ~/.claude/skills/
claude "Lista las skills disponibles y dime cuantas hay"

# 3. Seguridad: auditar OpenClaw
openclaw security audit --deep --fix
# Si todavia usas OpenClaw, al menos ejecuta esto semanalmente

# 4. Aislar OpenClaw en Docker
docker run --read-only --cap-drop=ALL \
  -v ~/.openclaw:/home/openclaw/.openclaw \
  -p 127.0.0.1:18780:18780 \
  openclaw/openclaw

Bonus: Potencia OpenClaw con 1136 skills de SKILLSBUNDLE

Ahora que OpenClaw funciona perfectamente con tu proveedor de IA favorito, es momento de llevarlo al siguiente nivel. SKILLSBUNDLE te ofrece 1136 skills profesionales listos para usar.

Los skills son archivos de instrucciones que tu herramienta carga automaticamente segun el contexto. Con SKILLSBUNDLE obtienes:

• 40 verticales: marketing, finanzas, desarrollo web, SEO, diseno, y mas
• 15 tipos de uso: creacion de contenido, analisis de datos, automatizacion
• Skills transversales: code review, testing, documentacion, seguridad
• Optimizados y probados: cada skill ha sido refinado para dar resultados consistentes

Instalar los skills es directo:

# 1. Compra SKILLSBUNDLE en skillsbundle.com
# 2. Descarga skills.zip
# 3. Descomprime y copia las skills al directorio de tu herramienta
unzip skills.zip -d ~/skillsbundle-pack
cp -r ~/skillsbundle-pack/skills/* ~/openclaw/skills/
# 4. Verifica
ls ~/openclaw/skills/ | wc -l   # Deberias ver 1136

Una vez copiados, cada vez que uses OpenClaw con un prompt que toque una vertical, la skill correspondiente se cargara automaticamente.

Incluye 1136 skills, actualizaciones gratuitas y soporte prioritario