Instalar OpenClaw: Guía paso a paso (Mac, Windows, Linux)

"Si puedes preparar fideos instantáneos, puedes instalar OpenClaw. Más o menos tarda lo mismo."

Objetivo de hoy

Paso 0: Elegir dónde vive tu asistente

Primera decisión: ¿dónde se ejecuta tu asistente?

Especificaciones recomendadas para VPS: Ubuntu 22.04, 2 núcleos de CPU, 4 GB de RAM, 40 GB SSD.

¿Qué entorno debería elegir?

• Solo probarlo → portátil (lo más fácil, pero solo funciona cuando el portátil está encendido)
• Quiero disponibilidad 24/7 → VPS (5-10 USD/mes, sigue funcionando mientras duermes)
• Quiero 24/7 sin cloud → Mac Mini o PC antiguo

Los archivos de trabajo de OpenClaw suelen vivir en ~/.openclaw/workspace/, sin importar el entorno que elijas, y los skills instalados suelen vivir en ~/.openclaw/skills/.

Sabrás que este paso está hecho cuando puedas responder: "¿Qué máquina exacta va a permanecer en línea para mi asistente?"

Paso 1: Reunir los requisitos previos

Antes de ejecutar el instalador, ten listo lo siguiente:

Node 22.16 o superior (Node 24 es el runtime recomendado por defecto)

• Por qué lo necesitas: la CLI openclaw se ejecuta sobre Node.js.
• Compruébalo con node -v. Si ves Node 22.16 o superior, ya estás listo.

Acceso a un modelo de IA (elige uno)

• Suscripción a Claude (Pro/Max/Team)
  • Por qué la necesitas: el asistente sigue necesitando un proveedor de modelo para cada respuesta y cada plan de tool.
  • Usa OAuth en el asistente, así no tienes que pegar ninguna API key.
• API key de Anthropic
  • Por qué la necesitas: es la credencial que OpenClaw usa para llamar a Anthropic directamente.
  • Consíguela en console.anthropic.com.
• También compatible con OpenAI, Gemini, OpenRouter, Qwen, Mistral y otros.
  • Por qué lo necesitas: cualquier proveedor compatible puede impulsar el asistente si Claude no es lo que quieres.

Telegram Bot Token

1. Abre Telegram y busca @BotFather.
2. Envía /newbot, elige un nombre y un nombre de usuario.
3. Copia el token que devuelve BotFather.

Por qué lo necesitas: este token permite a OpenClaw recibir y enviar mensajes de Telegram mediante tu bot.

Tu Telegram User ID

• Busca @userinfobot en Telegram y copia tu ID numérico.
• Por qué lo necesitas: el onboarding usa esto para marcarte como admin, de modo que otras personas no puedan controlar tu asistente.

Sabrás que este paso está hecho cuando tengas cuatro cosas a mano: una máquina, Node 22.16 o superior, una vía de credenciales del modelo y ambos valores de Telegram.

Paso 2: Instalar

Ejecuta:

curl -fsSL https://openclaw.ai/install.sh | bash

Este es el comando oficial. Instala OpenClaw y, si hace falta, instala Node automáticamente.

Instalación manual alternativa:

npm install -g openclaw@latest && openclaw onboard

Esta ruta manual instala la CLI directamente y luego lanza el asistente de onboarding, que escribe tu configuración inicial en ~/.openclaw/workspace/.

Guía de plataforma: macOS → Guía de plataforma: Windows → Guía de plataforma: Linux / VPS →

Sabrás que funcionó cuando se abra el asistente en lugar de devolver command not found y, después del onboarding, openclaw status muestre un servicio en ejecución.

Paso 3: Qué pregunta el asistente

El asistente de configuración te guía por cinco preguntas:

1. Mode - Elige QuickStart si es tu primera instalación.
2. AI Model - Selecciona tu proveedor y autentícate.
3. Chat Channel - Elige Telegram y pega tu Bot Token.
4. Admin Setup - Introduce tu Telegram User ID.
5. Daemon Install - Responde que sí para que el asistente se ejecute en segundo plano y sobreviva a los reinicios.

En Linux esto suele ser una systemd user unit. En macOS suele ser un LaunchAgent. En ambos casos, el objetivo es el mismo: OpenClaw debe iniciarse automáticamente después de reiniciar la máquina.

Sabrás que este paso funcionó cuando la instalación del daemon termine sin errores y openclaw status informe un estado saludable en lugar de detenido.

Paso 4: Enviar tu primer mensaje

Cuando termine el asistente, abre Telegram, busca tu bot y envía:

Hello - who are you?

Deberías recibir una respuesta en pocos segundos. Ahora sonará genérica porque todavía no has personalizado archivos como ~/.openclaw/workspace/SOUL.md. Eso llega en el Día 3.

Prueba algunos mensajes más:

• "Write a Python quicksort"
• "What's the square root of 1024?"
• "Can you check my email?" (De momento debería decir que no.)

Sabrás que este paso funcionó cuando Telegram muestre una respuesta real del bot y openclaw logs --follow no enseñe errores repetidos para ese mensaje.

Criterios mínimos de éxito

Después de hoy, deberías poder:

• Ejecutar openclaw status y ver que está en ejecución
• Enviar un mensaje por Telegram y recibir una respuesta
• Apagar y encender tu equipo: el servicio se reinicia automáticamente

Comprobación: haz la prueba de reinicio ahora, no más tarde. Si el servicio no vuelve automáticamente, arréglalo antes de continuar.

Comandos de gestión diaria

Los usarás con frecuencia:

openclaw status           # Overall health
openclaw doctor           # Full diagnostic check
openclaw gateway restart  # Restart background service
openclaw logs --follow    # View runtime logs
openclaw configure        # Change model, channel, or any setting

Sabrás que estos comandos bastan para la operación básica cuando puedas responder rápido a dos preguntas: "¿Está funcionando?" y "¿Qué dicen los logs?"

Problemas comunes

Puerto ya en uso - Otro proceso ya está usando el puerto que OpenClaw quiere. Revisa el error en openclaw logs --follow, libera el proceso en conflicto y ejecuta openclaw daemon restart. Sabrás que está resuelto cuando los logs dejen de repetir el error de bind y openclaw status vuelva a estado saludable.

El bot de Telegram no responde - Normalmente el Bot Token es incorrecto, falta tu Telegram User ID o el daemon nunca arrancó. Vuelve a ejecutar openclaw configure o openclaw onboard, y luego envía un mensaje de prueba nuevo. Sabrás que funcionó cuando el bot responda y los logs muestren el mensaje entrante en lugar de un fallo de autenticación.

El servicio no arranca tras reiniciar - Probablemente el paso de instalación del daemon falló o se omitió. Ejecuta openclaw doctor, reinstala el daemon si se te indica y reinicia una vez más. Sabrás que está resuelto cuando openclaw status muestre que está en ejecución justo después del login o del arranque del servidor.

Guía completa de troubleshooting →

Qué sigue

Tu asistente ya puede chatear, pero todavía no tiene personalidad ni instrucciones. Mañana le darás forma editando archivos clave en ~/.openclaw/workspace/, incluidos ~/.openclaw/workspace/SOUL.md, ~/.openclaw/workspace/USER.md, ~/.openclaw/workspace/AGENTS.md y ~/.openclaw/workspace/IDENTITY.md.