OpenClaw
Primeros pasos8 min de lectura

Inicio Rápido de OpenClaw: De Cero a Funcionando en 30 Minutos

Desde preparar tu clave de modelo hasta recibir tu primera respuesta, cubriendo instalación, configuración, verificaciones de estado y fallos de inicio comunes.

O

OpenClaw Guides

Tutorial Authors

1. Requisitos Previos

Antes de instalar OpenClaw, asegúrate de que tu sistema cumple con los siguientes requisitos:

  • Node.js 22 o superior (se recomienda LTS)
  • Gestor de paquetes npm o pnpm
  • Una conexión a Internet estable

Para verificar tu versión de Node.js:

bash
node --version
# Debería mostrar v22.x.x o superior

2. Instalación en Una Línea

Abre tu terminal y ejecuta:

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

El script de instalación detectará automáticamente tu entorno del sistema y completará todas las configuraciones.

Alternativa: Usar npm

Si prefieres usar npm directamente:

bash
# Instalar OpenClaw globalmente
npm install -g openclaw@latest

# Iniciar el asistente de incorporación
openclaw onboard

3. Configuración Inicial

Después de la instalación, ejecuta el asistente de configuración:

bash
openclaw onboard

El asistente te guiará a través de:

  1. Configuración de la Clave API - Ingresa tu clave API de Anthropic
  2. Selección del Modelo Predeterminado - Elige entre Claude 3.5 Haiku, Claude 3.5 Sonnet o Claude Sonnet 4
  3. Conexión de la Plataforma de Chat - Conecta WhatsApp, Telegram o Discord

4. Iniciar el Servicio Gateway

Inicia el gateway de OpenClaw:

bash
openclaw gateway start

Deberías ver una salida como:

🦞 OpenClaw Gateway v1.0.0
✓ Model provider connected
✓ Gateway listening on http://127.0.0.1:18789
✓ Ready to receive messages

5. Verificar Tu Instalación

Verifica el estado del servicio:

bash
openclaw status

Si todo funciona correctamente, deberías ver:

Gateway: Running ✓
Model: Connected ✓
Channels: 0 active

Solución de Problemas

Puerto Ya en Uso

Si ves el error EADDRINUSE:

bash
# Encontrar qué está usando el puerto 3000
lsof -i :18789

# Terminar el proceso o usar un puerto diferente
openclaw gateway start --port 18790

Problemas con la Clave API

Si obtienes 401 Unauthorized:

bash
# Reconfigurar tu clave API
openclaw config set api-key

Próximos Pasos