¿Qué es OpenClaw?

OpenClaw es un agente de IA de código abierto que opera directamente desde tu terminal. Piensa en él como tu asistente de programación personal capaz de leer, escribir y modificar código, ejecutar comandos, gestionar archivos y mucho más. A diferencia de las soluciones SaaS, OpenClaw se ejecuta en tu propio servidor, lo que te da control total sobre tus datos y modelos de IA.

OpenClaw se ha convertido rápidamente en una de las herramientas favoritas de desarrolladores que buscan automatizar flujos de trabajo complejos directamente desde la terminal. Es compatible con múltiples proveedores de IA (OpenAI, Anthropic, DeepSeek, etc.), tiene un sistema de habilidades (skills), memoria persistente, y se integra con plataformas de mensajería como Telegram, Discord y Slack.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

  • Un VPS con Ubuntu 22.04 LTS o superior (también funciona en Debian 12+, Rocky Linux 9+, y otras distribuciones basadas en Linux)
  • Mínimo 2 GB de RAM (4 GB recomendado si planeas usar modelos locales)
  • Node.js v18+ y npm instalados
  • Git instalado
  • Claves de API de al menos un proveedor de IA (Anthropic, OpenAI, DeepSeek, etc.)
  • Opcional: un token de bot de Telegram (creado desde @BotFather) si quieres interactuar con tu agente desde Telegram

Paso 1: Conectarse al VPS

Accede a tu VPS por SSH:

ssh usuario@tu-vps-ip

Una vez dentro, actualiza los paquetes del sistema:

sudo apt update && sudo apt upgrade -y

Paso 2: Instalar dependencias esenciales

OpenClaw necesita Node.js v18 o superior. Si tu VPS no lo tiene, instálalo así:

# Instalar Node.js 22 (LTS recomendada)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt install -y nodejs

# Verificar instalación
node --version   # Debe mostrar v22.x.x
npm --version    # Debe mostrar 10.x.x o superior

# Instalar herramientas adicionales
sudo apt install -y git curl wget build-essential python3 python3-pip

Paso 3: Clonar el repositorio de OpenClaw

# Clonar awesome-openclaw-agents (plantillas y quickstart)
git clone https://github.com/mergisi/awesome-openclaw-agents.git
cd awesome-openclaw-agents/quickstart

# Instalar dependencias npm
npm install

Paso 4: Configurar el entorno

# Copiar el archivo de entorno de ejemplo
cp .env.example .env

# Editarlo con tus claves
nano .env

Dentro del archivo .env, configura al menos estos valores:

# Token de tu bot de Telegram (obligatorio para interfaz Telegram)
TELEGRAM_BOT_TOKEN=tu_token_aqui

# Clave de API de Anthropic o DeepSeek
ANTHROPIC_API_KEY=sk-ant-...
# O bien:
OPENAI_API_KEY=sk-...

# Nombre de tu agente
AGENT_NAME=MiAgenteOpenClaw

💡 Tip: Si quieres usar DeepSeek (más económico que Claude/OpenAI), configura DEEPSEEK_API_KEY en el .env y ajusta el modelo en tu SOUL.md.

Paso 5: Elegir una personalidad (SOUL.md)

El archivo SOUL.md define la personalidad, habilidades y reglas de tu agente. Puedes elegir entre más de 160 plantillas predefinidas:

# Ver las categorías disponibles
ls ../agents/

# Ejemplo: usar el agente de desarrollo de software
cp ../agents/engineering/software-engineer/SOUL.md ./SOUL.md

# O crea tu propio SOUL.md desde cero

Un SOUL.md típico se ve así:

# Personalidad
Eres un ingeniero de software experto. Ayudas a escribir código limpio,
efficiente y bien documentado. Respondes en español.

# Habilidades
- Escribir y depurar código en Python, JavaScript, TypeScript
- Revisar pull requests
- Refactorizar código legacy
- Escribir tests unitarios y de integración

# Reglas
- Siempre pregunta antes de hacer cambios destructivos
- Prefiere soluciones simples sobre complejas
- Documenta cada función pública

Paso 6: Ejecutar el agente

# Iniciar el agente
node bot.js

Si todo está configurado correctamente, verás un mensaje similar a:

🤖 MiAgenteOpenClaw está listo
📬 Busca tu bot en Telegram y envíale un mensaje

Abre Telegram, busca el nombre de tu bot (el que le diste a @BotFather) y envía /start. Tu agente te responderá.

Paso 7: Configurar como servicio systemd (producción)

Para que OpenClaw se ejecute automáticamente al arrancar el VPS y se reinicie si falla, créale un servicio systemd:

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

Pega este contenido (ajusta las rutas según tu instalación):

[Unit]
Description=OpenClaw AI Agent
After=network.target

[Service]
Type=simple
User=tu_usuario
WorkingDirectory=/home/tu_usuario/awesome-openclaw-agents/quickstart
ExecStart=/usr/bin/node /home/tu_usuario/awesome-openclaw-agents/quickstart/bot.js
Restart=always
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

Luego habilita e inicia el servicio:

sudo systemctl daemon-reload
sudo systemctl enable openclaw.service
sudo systemctl start openclaw.service

# Verificar que está corriendo
sudo systemctl status openclaw.service

# Ver logs en tiempo real
sudo journalctl -u openclaw.service -f

Paso 8: Configurar dominios y HTTPS (opcional)

Si planeas exponer un dashboard web o webhooks, configura Nginx como proxy inverso con certificados SSL:

sudo apt install -y nginx certbot python3-certbot-nginx

sudo nano /etc/nginx/sites-available/openclaw

server {
    listen 80;
    server_name tu-dominio.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

# Habilitar el sitio
sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

# Obtener certificado SSL
sudo certbot --nginx -d tu-dominio.com

Configuración avanzada

Usar múltiples proveedores de IA

OpenClaw soporta múltiples proveedores. Puedes configurar varios en tu openclaw.json:

{
  "models": {
    "providers": {
      "anthropic": {
        "apiKey": "sk-ant-...",
        "baseUrl": "https://api.anthropic.com",
        "apiType": "anthropic-messages"
      },
      "deepseek": {
        "apiKey": "sk-...",
        "baseUrl": "https://api.deepseek.com",
        "apiType": "openai"
      },
      "openrouter": {
        "apiKey": "sk-or-...",
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiType": "openai"
      }
    }
  }
}

Agregar servidores MCP

Los servidores MCP (Model Context Protocol) le dan a OpenClaw acceso a herramientas externas como bases de datos, APIs, y servicios:

{
  "mcp": {
    "servers": {
      "filesystem": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/ruta/permitida"]
      },
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"]
      }
    }
  }
}

Conectar con Discord y Slack

Además de Telegram, OpenClaw puede conectarse a Discord y Slack. Solo agrega los tokens correspondientes a tu .env:

DISCORD_BOT_TOKEN=tu_token_discord
SLACK_BOT_TOKEN=tu_token_slack
SLACK_APP_TOKEN=tu_app_token_slack

Solución de problemas comunes

El bot de Telegram no responde

  • Verifica que el token del bot sea correcto
  • Asegúrate de haber iniciado una conversación con /start
  • Revisa los logs: journalctl -u openclaw.service -f

Error de conexión con la API de IA

  • Confirma que tu clave de API sea válida y tenga saldo
  • Verifica que la URL base del proveedor sea correcta
  • Algunos proveedores (como DeepSeek) requieren configurar apiType: "openai"

El agente se queda sin memoria

  • OpenClaw usa compresión automática de contexto. Si tu VPS tiene poca RAM, limita el historial con max_turns en la configuración
  • Considera usar un plan con más RAM si trabajas con proyectos grandes

El servicio no arranca automáticamente

  • Verifica que systemctl enable se ejecutó correctamente
  • Revisa las rutas en el archivo de servicio systemd
  • Asegúrate de que el usuario tenga permisos de ejecución

Conclusión

OpenClaw te permite tener tu propio agente de IA corriendo 24/7 en tu VPS. Es una alternativa open-source a servicios como Claude Code y GitHub Copilot, con la ventaja de que tú controlas los datos, los modelos, y la infraestructura.

Con la configuración básica que hemos visto, puedes tener tu agente operativo en menos de 10 minutos. A partir de ahí, puedes expandirlo con skills personalizados, MCP servers, y múltiples plataformas de mensajería.

Y si en el futuro quieres migrar a algo más potente, herramientas como Hermes Agent ofrecen rutas de migración directa desde OpenClaw, conservando toda tu configuración, memoria y skills.