OpenClaw Manual OpenClaw
6 Pasos para Desplegar

OpenClaw Comenzando

Sigue estos pasos para instalar y configurar OpenClaw desde cero

Ruta Más Rápida

¿Solo quieres probarlo? Un comando inicia el Dashboard para chatear instantáneamente:

$ openclaw dashboard
http://127.0.0.1:18789/

Requisitos de OpenClaw

Antes de comenzar, asegúrate de que tu sistema cumpla estos requisitos

Node.js ≥ 22

Requerido para ejecutar OpenClaw

Sistema Operativo

macOS, Linux o Windows (WSL2 recomendado)

Brave Search API (Opcional)

Habilita la funcionalidad de búsqueda web

Windows
Se recomienda encarecidamente a los usuarios de Windows usar WSL2 para mejor compatibilidad y rendimiento.
1

Instalar OpenClaw

Elige tu método de instalación preferido. Se recomienda la instalación de una línea

$ curl -fsSL https://openclaw.ai/install.sh | bash
El comando de una línea detecta e instala automáticamente Node.js y todas las dependencias. No se requiere configuración manual.
2

Asistente de Configuración de OpenClaw

El asistente te guiará a través de toda la configuración necesaria incluyendo gateway, autenticación y conexiones de plataformas de chat

$ openclaw onboard --install-daemon

El asistente configurará

  • Tipo de Gateway - Elige gateway local o remoto
  • Autenticación de Modelo IA - OpenAI (OAuth/Clave API) o Anthropic (Clave API recomendada, claude setup-token también soportado)
  • Plataformas de Chat - Código QR de WhatsApp, Token de Bot de Telegram/Discord, etc.
  • Servicio Daemon - Instalación de servicio en segundo plano (macOS: launchd, Linux/WSL2: systemd)
Ubicaciones de Archivos de Configuración (Importante)
  • Directorio de configuración principal ~/.openclaw/
  • Credenciales OAuth ~/.openclaw/credentials/oauth.json
  • Perfiles de autenticación (OAuth + Clave API) ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Si tienes Claude Code instalado, puedes reutilizar credenciales existentes vía claude setup-token sin reconfigurar.
Consejo para servidor headless: Completa OAuth en una máquina con navegador primero, luego copia el archivo oauth.json al directorio correspondiente del servidor.
3

Iniciar Gateway de OpenClaw

El gateway es el servicio central de OpenClaw que maneja todos los mensajes

Verificar estado del servicio

$ openclaw gateway status

Iniciar gateway manualmente (para especificar puerto)

$ openclaw gateway --port 18789

Acceder al Dashboard Web

http://127.0.0.1:18789/
Verificación Rápida (confirmar que el servicio está funcionando) 
$ openclaw status
$ openclaw health
$ openclaw security audit --deep
4

Conectar Plataformas de Chat

Empareja y conecta tu primera interfaz de chat

WhatsApp ( Inicio de Sesión con Código QR ) 

$ openclaw channels login

Ejecuta el comando para mostrar un código QR. Abre WhatsApp → Configuración → Dispositivos Vinculados → Escanea el código QR para conectar.

Se recomienda un número de teléfono dedicado. Los números VoIP no son recomendados (fácilmente bloqueados). Las credenciales se almacenan en el directorio ~/.openclaw/credentials/whatsapp/.

Telegram / Discord / Otros

El asistente puede ayudar a configurar tokens. Si prefieres configuración manual, consulta estos documentos:

Consejo de Telegram: Tu primer DM devolverá un código de emparejamiento. Necesitas aprobarlo (ver siguiente paso), de lo contrario el bot no responderá.
5

Configuración de Seguridad de OpenClaw

Asegura que solo usuarios autorizados puedan usar tu asistente de IA

Comportamiento por defecto: Los DMs desconocidos reciben un código corto, y los mensajes no se procesarán hasta que sean aprobados. Si tu primer DM no obtiene respuesta, aprueba el emparejamiento:

Listar solicitudes de emparejamiento pendientes

$ openclaw pairing list whatsapp

Aprobar emparejamiento (reemplaza [code] con el código real)

$ openclaw pairing approve whatsapp
Esta es una medida de seguridad importante para prevenir acceso no autorizado. También puedes configurar una lista de permitidos en el archivo de configuración para permitir automáticamente números específicos.
6

Verificar OpenClaw

En una nueva terminal, envía un mensaje de prueba

Enviar mensaje de prueba (reemplaza con tu número destino)

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
Si openclaw health muestra "auth not configured", vuelve al asistente y configura la autenticación OAuth/clave API—sin ella, el agente no responderá.

Consejos de Depuración

  • openclaw status --all Mejor reporte de depuración para copiar y pegar, solo lectura
  • openclaw health o openclaw status --deep Solicita instantánea de salud del gateway en ejecución

Configuración de OpenClaw Completa

¡Felicitaciones! Has instalado y configurado OpenClaw exitosamente. Comienza a chatear con tu asistente de IA ahora.