Instalación Paso a Paso

Es hora de ensuciarse las manos. Si hiciste la preparación del módulo anterior, esto toma ~5 minutos. Si no... bueno, vuelve al módulo anterior.

Prerequisitos

Verifica que tengas:

• Node.js 24 (o Node 22.14+) instalado
• Una API key de Anthropic, OpenAI, o Google
• Terminal abierta en tu máquina dedicada

¿No tienes Node.js? Abre la terminal y corre:

# En macOS con Homebrew
brew install node

Si no tienes Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node

Paso 1: Instalar OpenClaw

Un solo comando. Copia, pega, enter:

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

En Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

Esto descarga e instala OpenClaw. Tomará unos segundos.

Paso 2: Onboarding

Una vez instalado, corre:

openclaw onboard --install-daemon

El onboarding te guía paso a paso. Te va a preguntar:

Model Provider

Elige tu provider y pega tu API key. Recomendaciones:

• Anthropic con Opus 4.6 → mejor razonamiento, más seguro
• Anthropic con Sonnet 4.6 → buen balance costo/calidad
• OpenAI con GPT-5.4 → alternativa sólida

Claire: "Uso los modelos buenos. Pago por la confianza de la experiencia y por la seguridad. Los modelos baratos son más vulnerables."

Personal Use

Te preguntará si es para uso personal. Di que sí. OpenClaw asume que es un agente para ti y solo para ti — esto es parte de su postura de seguridad.

Channel (cómo hablar con él)

Te ofrece varias opciones. Para empezar, elige Telegram — es el más fácil de configurar. Lo configuramos en detalle en el siguiente módulo.

Paso 3: Verificar el Gateway

openclaw gateway status

Deberías ver que el gateway está escuchando en el puerto 18789. Si hay errores, corre:

openclaw status --all

Esto te da un diagnóstico completo que puedes usar para debugging.

Paso 4: Abrir el Dashboard

openclaw dashboard

Esto abre el Control UI en tu browser — una interfaz web donde puedes chatear con tu agente directamente. Es útil para testing antes de configurar Telegram.

Paso 5: Tu Primera Conversación

En el Control UI, escribe "Hola". Tu agente responderá algo como:

"Hey, I just came online. Who am I? Who are you?"

Este es el momento de onboarding — el agente está preguntando quién es y quién eres tú. Lo trabajamos en detalle en la siguiente lección.

Troubleshooting Común

"Command not found: openclaw"

→ Cierra y abre la terminal para que cargue el PATH actualizado. O corre source ~/.zshrc.

"Cannot connect to model provider"

→ Verifica tu API key. Corre openclaw doctor para diagnóstico.

"Port 18789 already in use"

→ Ya tienes un gateway corriendo. Corre openclaw gateway stop primero.

"Node.js version not supported"

→ Necesitas Node 22.14+ o Node 24. Corre node --version para verificar.