Primeros Pasos

Objetivo: Ir de Cero → Primer Chat Exitoso en tiempo récord usando valores predeterminados sensatos.

Forma Más Rápida de Chatear: Abre la interfaz de control (no se requiere configuración de canal). Ejecuta openclaw dashboard

Luego chatea en tu navegador o abre http://127.0.0.1:18789/ (en el host del Gateway).

Docs: Dashboard y UI de Control.

Ruta Recomendada: Usa el Asistente de Incorporación CLI (openclaw onboard). Configura:

• Modelos/Auth (OAuth recomendado)
• Configuración del Gateway
• Canales (WhatsApp/Telegram/Discord/etc.)
• Valores Predeterminados de Emparejamiento (DMs Seguros)
• Incorporación del Espacio de Trabajo + Habilidades
• Servicios en Segundo Plano Opcionales

Si necesitas páginas de referencia más detalladas, ve a: Asistente, Configuración, Emparejamiento, Seguridad.

Notas de Sandbox: agents.defaults.sandbox.mode: "non-main" usa session.mainKey (predeterminado "main"), así que las sesiones de grupos/canales están en sandbox. Si quieres que el agente principal siempre se ejecute en el host, establece una anulación explícita por agente:

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/.openclaw/workspace",
        "sandbox": { "mode": "off" }
      }
    }
  }
}

• Node >=22
• pnpm (opcional; recomendado si compilas desde fuente)
• Recomendado: Clave API de Brave Search para búsqueda web.

La forma más simple: openclaw configure --section web (almacena tools.web.search.apiKey).

Ver Herramienta Web.

macOS: Si planeas compilar la app, instala Xcode / CLT. Para solo CLI + Gateway, Node es suficiente.

Windows: Usa WSL2 (Ubuntu recomendado). Windows nativo no está probado y la compatibilidad de herramientas es menor. Ver Windows (WSL2).

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

Opciones de instalación (sabor de shell, no interactivo, desde GitHub): Instalación.

Windows (PowerShell):

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

Alternativa (instalación global):

npm install -g openclaw@latest

pnpm add -g openclaw@latest

openclaw onboard --install-daemon

Lo que necesitarás elegir:

• Gateway Local vs Remoto
• Auth: Suscripción OpenAI Code (Codex) (OAuth) o Clave API. Para Anthropic, recomendamos claves API; claude setup-token también es compatible.
• Proveedores: Inicio de sesión QR de WhatsApp, tokens de Bot TG/Discord, etc.
• Demonio: Instalación en segundo plano (launchd/systemd)
• Runtime: Node (Recomendado; requerido para WhatsApp/TG). Bun no recomendado.
• Token del Gateway: El asistente genera uno por defecto y lo almacena en gateway.auth.token.

Docs del Asistente: Asistente

• Ruta Anthropic recomendada: Establece la clave API (el asistente puede almacenarla para el servicio). claude setup-token es compatible si quieres reutilizar las credenciales de Claude Code.
• Credenciales OAuth (importación heredada): ~/.openclaw/credentials/oauth.json
• Perfil de Auth (OAuth + Claves API): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Consejo Headless/Servidor: Haz OAuth primero en una máquina de escritorio, luego copia oauth.json al host del Gateway.

Si instalaste el servicio durante la incorporación, el Gateway ya debería estar ejecutándose:

openclaw gateway status

Ejecución manual (primer plano):

openclaw gateway --port 18789 --verbose

Dashboard (localhost): http://127.0.0.1:18789/

Si hay un token configurado, pégalo en la configuración de la UI de Control (almacenado como connect.params.auth.token).

openclaw channels login

Escanea vía WhatsApp → Configuración → Dispositivos Vinculados.

Docs de WhatsApp: WhatsApp

El asistente puede escribir tokens/configuración por ti. Si prefieres configuración manual, empieza aquí:

• Telegram: Telegram
• Discord: Discord
• Mattermost (Plugin): Mattermost (Plugin)

Consejo TG DM: Tu primer DM devolverá un código de emparejamiento. Apruébalo (ver siguiente paso) o el bot no responderá.

Política predeterminada: Los DMs desconocidos obtienen un código corto y los mensajes no se procesan hasta ser aprobados.

Si tu primer DM no recibe respuesta, aprueba el emparejamiento:

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <code>

Docs de Emparejamiento: Emparejamiento

Si estás desarrollando OpenClaw mismo, ejecuta desde fuente:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard --install-daemon

Si no has instalado globalmente, ejecuta el paso de incorporación vía pnpm openclaw ... (desde dentro del repo).

pnpm build también empaqueta los assets de A2UI; usa pnpm canvas:a2ui:bundle si solo necesitas eso.

Gateway (desde este repo):

node openclaw.mjs gateway --port 18789 --verbose

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

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Si openclaw health dice "Auth not configured", vuelve al asistente para configurar auth OAuth/Key—los agentes no pueden responder sin ello.

Consejo: openclaw status --all es el mejor informe de depuración de solo lectura para pegar.

Sondeo de salud: openclaw health (o openclaw status --deep) pregunta al Gateway en ejecución por una instantánea de salud.

• App de Barra de Menú macOS + Voice Wake: App de Barra de Menú macOS + Voice Wake
• Nodos iOS/Android (Canvas/Cámara/Voz): Nodos iOS/Android (Canvas/Cámara/Voz)
• Acceso Remoto (Túnel SSH / Tailscale Serve): Acceso Remoto (Túnel SSH / Tailscale Serve)
• Tailscale: Tailscale
• Ejecución permanente / configuración VPN: Acceso Remoto (Túnel SSH / Tailscale Serve), exe.dev, Hetzner