OpenClaw
GitHubComenzar
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.bot/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 <code>
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 --allMejor reporte de depuración para copiar y pegar, solo lectura
  • openclaw healthoopenclaw status --deepSolicita 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.