OpenClaw: Guía Definitiva de Despliegue (Local, VPS y Docker)

Por El Equipo PAI

Aquí el equipo de PAI. Vamos a ser honestos: el ecosistema de agentes de IA es un caos de nombres. Si has oído hablar de Moltbot, ClawdBot y ahora OpenClaw, tranquilo, son el mismo software que ha cambiado de nombre tres veces. Pero más allá del branding, la tecnología es sólida.

Hoy no te traemos un chatbot que vive en una pestaña del navegador. Te enseñamos a desplegar OpenClaw, un daemon de sistema que vive en tu máquina (o servidor), tiene acceso a tus archivos y trabaja mientras duermes. Si buscas un "Jarvis" real y autohospedado, esta es la guía.

⚡ TL;DR: Resumen Ejecutivo

Qué es: Un agente de IA autónomo que se ejecuta en background (CLI/Daemon).
Para quién: Desarrolladores y SysAdmins que quieren automatizar tareas de sistema.
Costo: Gratis (Open Source). Solo pagas la API del modelo (o $0 si usas Ollama).
Riesgo: Alto si no configuras la seguridad. Puede ejecutar comandos destructivos si se lo permites.
Tiempo de despliegue: 10 minutos.

1. The Tech: ¿Por qué OpenClaw?

A diferencia de las herramientas "no-code", OpenClaw está diseñado para técnicos. Funciona sobre Node.js y se conecta a múltiples interfaces (Slack, Telegram, Discord o CLI).

Central Geometric Node (Daemon), Bifurcated Data Flow (Cloud vs Local), Minimalist Tech Icons (Shield, Coin, Cloud, Chip), Dark Mode Blueprint Aesthetic

Su arquitectura es agnóstica al modelo: puedes usar la inteligencia de Claude 3.5 Sonnet (recomendado por su capacidad de codificación) o conectar modelos locales vía Ollama o LM Studio para privacidad total.

💡 The Lightbulb Moment

No necesitas una suscripción de $20/mes a ChatGPT para tareas repetitivas. Tu "compute" local es gratis. Al mover la ejecución a tu propia máquina con OpenClaw + Ollama, pasas de un modelo OpEx (pago por token) a un modelo CapEx (uso de tu hardware existente).

2. Reality Check: El Lado Oscuro

Wireframe Glass Sandbox Cube, Mechanical Robotic Arm, Red Malicious Data Stream, Yellow Hazard Stripes

Antes de abrir la terminal, una advertencia de seguridad crítica. OpenClaw tiene un "App Store" llamado ClawHub. Aunque es útil, se ha llenado recientemente de "skills trampa".

⚠️ Regla de Oro PAI: Nunca instales una skill sin auditar su código, especialmente si le das al agente permisos de escritura en tu sistema de archivos. OpenClaw es poderoso, y eso significa que puede ser destructivo si se configura mal.

3. Prerrequisitos (No Negociables)

Si ignoras esto, la instalación fallará. Lo hemos comprobado en nuestro laboratorio:

OS: macOS, Linux o Windows (vía WSL2).
Runtime: Node.js v22+. Aunque guías antiguas mencionan v18, la versión 22 es necesaria para las últimas dependencias.
Docker: Obligatorio si eliges la Ruta B (VPS).
API Key: Anthropic (Recomendado), OpenAI, o una instancia local de Ollama.

4. Action Plan: El Tutorial

Elige tu aventura. ¿Lo quieres en tu portátil para probar o en un servidor para trabajar 24/7?

RUTA A: Instalación Local Rápida (Mac/Linux/WSL)

Ideal para probar el concepto en 5 minutos.

Paso 1: El One-Liner

OpenClaw ofrece un script de instalación universal. Abre tu terminal:


bash

Paso 2: El Wizard

El script lanzará un asistente. Te pedirá:

Proveedor de IA: Elige Anthropic si tienes key, o Ollama si eres purista del local-host.
Plataformas: Selecciona Telegram para la prueba más fácil.

Paso 3: Arrancar


bash

Accede a http://127.0.0.1:18789/. Si ves el panel de control, has triunfado.

RUTA B: Producción en VPS (Docker)

Esta es la forma profesional. Ideal para VPS en DigitalOcean o servidores dedicados. Usaremos Docker para no ensuciar el sistema base.

Paso 1: Preparar el VPS

Accede por SSH y actualiza:


bash

Paso 2: Clonar y Construir

OpenClaw prefiere construir su imagen localmente para optimizarla:


bash

💡 Nota: Selecciona "local" cuando el wizard pregunte por el modo gateway.

Paso 3: Verificación


bash

Debes ver openclaw-gateway en estado Up.

⚠️ Seguridad Crítica en VPS: No expongas el puerto 18789 a todo internet (0.0.0.0). Usa una VPN como Tailscale para acceder al dashboard de forma segura, o configura un proxy inverso con autenticación básica.

5. Configuración Avanzada: Modelos Locales (Ollama)

¿Quieres que sea gratis? Configura OpenClaw para hablar con tu Llama 3 local. Edita ~/.openclaw/openclaw.json (o config.json en el volumen de Docker):


json

💡 Truco PAI: Usamos host.docker.internal para que el contenedor de OpenClaw pueda "ver" al Ollama corriendo en tu máquina host.

6. Solución de Problemas (Troubleshooting)

Aquí es donde la gente se rinde. Nosotros no.

1. "Command not found: openclaw"

Causa: Problema de PATH con NPM o Node desactualizado.
Solución: Asegúrate de usar Node v22. Si persiste, mira este fix rápido o reinstala con:


bash

2. El Bot no responde en Telegram

Causa: Webhook no configurado o falta de créditos API.
Solución: Revisa los logs con:


bash

Si ves errores 401, tu API key de OpenAI/Anthropic no tiene saldo (el tier gratuito real ya casi no existe).

3. Errores de Permisos

Causa: El bot intenta escribir donde no debe.
Solución: Edita el archivo tools.yaml y usa la WhiteList para restringir al agente solo a carpetas específicas (ej: /home/user/workspace).

Siguientes Pasos

Ya tienes tu daemon corriendo. ¿Ahora qué?

Conecta Slack: Sigue esta guía oficial para integrarlo en tu equipo de trabajo.
Habilita Búsqueda Web: Configura múltiples motores de búsqueda para que tu agente pueda googlear por ti.

Bienvenido a la era del Agente Local. Úsalo con responsabilidad.

✅ ¿Quieres ir más allá? Si te interesa automatizar flujos de trabajo complejos, revisa nuestra guía completa sobre Agentes de IA.