Guía de configuración completa de Clawdbot incluyendo instalación, configuración y flujos de trabajo de desarrollo.

Ubicaciones de Almacenamiento

Clawdbot separa la configuración de la instalación:

Ubicación	Propósito
`~/.clawdbot/workspace`	Tus archivos de espacio de trabajo
`~/.clawdbot/clawdbot.json`	Configuración principal
`~/.clawdbot/credentials/`	Tokens de autenticación

Esta separación permite actualizaciones fáciles sin romper las configuraciones personales.

Requisitos Previos

Node.js >= 22
pnpm (recomendado) o npm
Docker (opcional, para configuración contenedorizada)

Métodos de Instalación

Instalación Rápida (Recomendada)

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

Vía npm

npm i -g clawdbot
clawdbot setup

Vía pnpm

pnpm add -g clawdbot
clawdbot setup

Flujos de Trabajo

Flujo de Trabajo Estable (App macOS)

Para la mayoría de usuarios, la app macOS proporciona la experiencia más fácil:

Instalar - Descargar y lanzar Clawdbot.app
Incorporación - Completar el asistente de configuración
Permisos - Otorgar acceso al sistema requerido
Modo Gateway - Asegurar que Gateway esté en modo Local
Canales - Vincular canales de comunicación (WhatsApp, Telegram, etc.)
Verificar - Ejecutar clawdbot health para confirmar la configuración

Flujo de Trabajo de Desarrollo

Para contribuidores y usuarios avanzados:

# Clonar el repositorio
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Instalar dependencias
pnpm install

# Iniciar Gateway de desarrollo con recarga en caliente
pnpm gateway:watch

Configura la app macOS en modo de conexión Local. La app se conecta al Gateway en ejecución en el puerto configurado (predeterminado: ws://127.0.0.1:18789).

Almacenamiento de Credenciales

Tipo	Ubicación
WhatsApp	`~/.clawdbot/credentials/whatsapp/<accountId>/creds.json`
Telegram	`~/.clawdbot/credentials/telegram/`
Sesiones	`~/.clawdbot/agents/<agentId>/sessions/`
OAuth	`~/.clawdbot/credentials/oauth.json`
Logs	`/tmp/clawdbot/`

Notas de Plataforma

macOS

La app gestiona el Gateway automáticamente vía LaunchAgent.

Linux

Usa servicio de usuario systemd. Habilita lingering para prevenir el cierre del servicio al cerrar sesión:

sudo loginctl enable-linger $USER

Windows (WSL2)

Ejecuta Clawdbot dentro de WSL2 con una distribución Linux. La configuración es idéntica a Linux.

Estrategia de Actualización

Mantén el contenido personal en directorios ~/.clawdbot/ separado de la instalación:

# Actualizar vía npm
npm update -g clawdbot

# O descargar el último código fuente
cd clawdbot
git pull
pnpm install

Tu espacio de trabajo y configuración permanecen intactos entre actualizaciones.

Verificación de Salud

Verifica tu instalación:

clawdbot health

Salida esperada:

Estado del Gateway: En ejecución
Puerto: 18789
Canales: Conectados
Agente: Listo

Solución de Problemas

El Gateway No Inicia

Verifica si el puerto 18789 está en uso: lsof -i :18789
Revisa los logs: cat /tmp/clawdbot/gateway.log
Resetea la configuración: clawdbot configure --reset

Problemas de Conexión de Canales

Re-autenticar: clawdbot channels login
Verificar credenciales: ls ~/.clawdbot/credentials/
Verificar allowlist: Revisar clawdbot.json

Próximos Pasos

Asistente de Incorporación - Configuración guiada
Vinculación - Control de acceso
Asistente Personal - Construye tu asistente

Guía de Configuración