Start

Asistente de Incorporación (CLI)

Usa el asistente CLI para configurar Clawdbot con configuración guiada para Gateway, canales, habilidades y valores predeterminados del espacio de trabajo.

Descripción General

El asistente de incorporación es el método de configuración recomendado para Clawdbot en macOS, Linux o Windows (vía WSL2). Proporciona un flujo de configuración guiado para conexiones de Gateway locales o remotas, canales, habilidades y valores predeterminados del espacio de trabajo.

Comandos Principales

ComandoDescripción
clawdbot onboardAsistente de configuración principal
clawdbot dashboardAbre la UI de Control para chat en navegador
clawdbot configureReconfigurar instalación existente
clawdbot configure --section webConfigurar búsqueda web (Brave Search API)

Modos de Configuración

Inicio Rápido (Recomendado)

Configuración predeterminada para la mayoría de usuarios:

  • Gateway local en loopback
  • Puerto 18789 con autenticación por token
  • DMs de Telegram/WhatsApp usan modo allowlist

Modo Avanzado

Control total sobre todos los pasos de configuración para usuarios avanzados.

Flujo de Configuración

1. Detección de Configuración Existente

El asistente detecta ~/.clawdbot/clawdbot.json y ofrece:

  • Mantener - Usar configuración existente
  • Modificar - Actualizar configuraciones específicas
  • Resetear - Empezar de nuevo

2. Modelo y Autenticación

Elige tu proveedor de IA:

ProveedorDescripción
Anthropic API KeyRecomendado para mejor rendimiento
Anthropic OAuthPara suscriptores de Claude Pro/Max
OpenAI API KeyGPT-4 y otros modelos
OpenAI CodexSuscripción enfocada en código
Vercel AI GatewayOpción de proxy
Modelos LocalesOperación sin conexión

3. Configuración del Espacio de Trabajo

Espacio de trabajo predeterminado: ~/.clawdbot/workspace

Archivos de arranque creados:

  • AGENTS.md - Configuración del agente
  • SOUL.md - Configuración de personalidad
  • TOOLS.md - Herramientas disponibles
  • IDENTITY.md - Información de identidad

4. Configuración del Gateway

Configura los ajustes de tu Gateway:

  • Puerto: Predeterminado 18789
  • Dirección de Enlace: Loopback o red
  • Modo de Autenticación: Basado en token (recomendado)
  • Tailscale: Exposición remota opcional

5. Configuración de Canales

Integraciones opcionales:

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • Signal
  • iMessage
  • Google Chat
  • Mattermost

6. Instalación del Demonio

  • macOS: LaunchAgent
  • Linux/WSL2: unidad de usuario systemd

7. Verificación de Salud

Valida el inicio del Gateway y la conectividad.

8. Instalación de Habilidades

Paquetes de habilidades opcionales vía npm/pnpm.

Modo Remoto

Conectar a un Gateway existente ejecutándose en otro lugar:

clawdbot onboard --remote

No se realizan instalaciones en el host remoto - solo configura la conexión del cliente local.

Modo No Interactivo

Para automatización y scripting:

clawdbot onboard --non-interactive \
  --auth-choice anthropic \
  --anthropic-api-key $ANTHROPIC_API_KEY

Múltiples Agentes

Crear instancias de agentes aisladas:

clawdbot agents add work
clawdbot agents add personal
clawdbot agents list

Cada agente tiene su propio espacio de trabajo y configuración.

Próximos Pasos