Saltar al contenido principal

​
Asistente de incorporación (CLI)

El asistente de incorporación es la forma recomendada de configurar OpenClaw en macOS, Linux o Windows (vía WSL2; muy recomendado). Configura un Gateway local o una conexión a un Gateway remoto, además de canales, Skills y valores predeterminados del espacio de trabajo en un único flujo guiado. 
openclaw onboard
El primer chat más rápido: abra la IU de Control (no se requiere configuración de canales). Ejecute openclaw dashboard y chatee en el navegador. Documentación: Dashboard.
Para reconfigurar más adelante: 
openclaw configure
openclaw agents add <name>
--json no implica un modo no interactivo. Para scripts, use --non-interactive.
Recomendado: configure una clave de API de Brave Search para que el agente pueda usar web_search (web_fetch funciona sin clave). La ruta más sencilla: openclaw configure --section web, que almacena tools.web.search.apiKey. Documentación: Herramientas web.

​
Inicio rápido vs Avanzado

El asistente comienza con Inicio rápido (valores predeterminados) vs Avanzado (control total).
  • Gateway local (local loopback)
  • Espacio de trabajo predeterminado (o espacio de trabajo existente)
  • Puerto del Gateway 18789
  • Autenticación del Gateway Token (generado automáticamente, incluso en loopback)
  • Exposición por Tailscale Desactivada
  • Los mensajes directos de Telegram + WhatsApp se configuran de forma predeterminada con lista de permitidos (se le pedirá su número de teléfono)

​
Qué configura el asistente

El modo local (predeterminado) le guía por estos pasos:
  1. Modelo/Autenticación — Clave de API de Anthropic (recomendado), OAuth, OpenAI u otros proveedores. Elija un modelo predeterminado.
  2. Espacio de trabajo — Ubicación para los archivos del agente (predeterminado ~/.openclaw/workspace). Inicializa archivos de arranque.
  3. Gateway — Puerto, dirección de enlace, modo de autenticación, exposición por Tailscale.
  4. Canales — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles o iMessage.
  5. Daemon — Instala un LaunchAgent (macOS) o una unidad de usuario systemd (Linux/WSL2).
  6. Comprobación de estado — Inicia el Gateway y verifica que esté en ejecución.
  7. Skills — Instala Skills recomendadas y dependencias opcionales.
Volver a ejecutar el asistente no borra nada a menos que usted elija explícitamente Restablecer (o pase --reset). Si la configuración no es válida o contiene claves heredadas, el asistente le pedirá que ejecute openclaw doctor primero.
El modo remoto solo configura el cliente local para conectarse a un Gateway en otro lugar. No instala ni cambia nada en el host remoto.

​
Agregar otro agente

Use openclaw agents add <name> para crear un agente independiente con su propio espacio de trabajo, sesiones y perfiles de autenticación. Ejecutar sin --workspace inicia el asistente. Qué establece:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Notas:
  • Los espacios de trabajo predeterminados siguen ~/.openclaw/workspace-<agentId>.
  • Agregue bindings para enrutar mensajes entrantes (el asistente puede hacerlo).
  • Banderas no interactivas: --model, --agent-dir, --bind, --non-interactive.

​
Referencia completa

Para desgloses detallados paso a paso, scripting no interactivo, configuración de Signal, API RPC y una lista completa de campos de configuración que escribe el asistente, consulte la Referencia del asistente.

​
Documentos relacionados