Instalación de OpenClaw

OpenClaw se distribuye como un paquete npm. Puedes instalarlo globalmente y tener un agente de IA funcionando en menos de 5 minutos — o saltarte la configuración por completo y desplegarlo con Clawly.

¿No eres técnico o simplemente no quieres complicaciones?

Clawly es una plataforma alojada que despliega y gestiona tu agente OpenClaw por ti — sin terminal, sin servidores, sin Docker. Elige un plan, conecta tus canales y estarás en línea en segundos.

Prueba Clawly

> Requisitos previos

Antes de instalar OpenClaw, asegúrate de tener:

  • ✓ Node.js 22 o posterior. OpenClaw utiliza funciones modernas de JavaScript que requieren Node 22+. Comprueba tu versión con node --version.
  • ✓ Una clave de API de un proveedor de IA. Necesitarás una clave de Anthropic (Claude), OpenAI (GPT), Google (Gemini) u otro proveedor compatible.
  • ✓ Un token de bot de una plataforma de mensajería. Crea un bot de Telegram a través de @BotFather o un bot de Discord en el Developer Portal.
  • ✓ Un servidor (para operación 24/7). Cualquier VPS, VM en la nube o máquina siempre encendida. Un servidor de $5/mes es suficiente para un solo agente.

> Instalación

Instala OpenClaw globalmente a través de npm:

npm install -g openclaw

Verifica la instalación:

openclaw --version

> Configuración

OpenClaw utiliza un archivo .env para la configuración. Crea un directorio de trabajo e inicialízalo:

mkdir my-agent && cd my-agent
openclaw init

Esto crea un archivo .env con las variables necesarias. Como mínimo, deberás configurar:

# AI Provider
ANTHROPIC_API_KEY=sk-ant-...

# Telegram (optional)
TELEGRAM_BOT_TOKEN=123456:ABC-...

# Discord (optional)
DISCORD_BOT_TOKEN=MTIz...

# Agent personality
AGENT_NAME=MyAgent
AGENT_SYSTEM_PROMPT="You are a helpful assistant."

Solo necesitas configurar los canales que quieras usar. OpenClaw es compatible con Telegram, Discord, WhatsApp, Signal, Slack, iMessage y más — simplemente añade el token correspondiente.

> Ejecutar tu agente

Inicia el agente con el comando gateway:

openclaw gateway

El agente se conecta a los canales configurados y comienza a escuchar mensajes. Verás una salida como:

[OpenClaw] Agent "MyAgent" starting...
[OpenClaw] Telegram connected
[OpenClaw] Discord connected
[OpenClaw] Ready — listening on 2 channels

Para despliegues en producción, usa un gestor de procesos como pm2 o Docker para mantener el agente en ejecución:

# With pm2
pm2 start "openclaw gateway" --name my-agent

# With Docker
docker run -d --env-file .env --name my-agent openclaw-agent

> Problemas comunes

"Error: Node.js version too old"

OpenClaw requiere Node.js 22+. Usa nvm install 22 o descárgalo desde el sitio web oficial de Node.js.

"Telegram polling conflict"

Esto ocurre si otro proceso ya está haciendo polling con el mismo token de bot. Detén cualquier otra instancia o usa un token de bot diferente.

"API rate limit exceeded"

Tu proveedor de IA está limitando las solicitudes. Revisa los límites de tu plan y considera actualizar o añadir cola de solicitudes.

¿Demasiada configuración?

Clawly se encarga de la instalación, el alojamiento, la monitorización y las actualizaciones por ti. Elige un plan, conecta tus canales y tu agente estará en línea en segundos.

Despliega sin complicaciones