Clawdbot

Clawdbot es un asistente personal de IA que se ejecuta localmente y se conecta a múltiples plataformas de mensajería a través de una arquitectura Gateway basada en WebSocket.

⚠️ En Desarrollo

Esta plantilla está en desarrollo. Clawdbot está en desarrollo rápido, por lo que esta plantilla usa el tag main para obtener la última versión.

✅ Completado

• Gateway inicia y acepta conexiones WebSocket
• Web UI carga a través de dominio público
• Autenticación por token (sin emparejamiento de dispositivo)
• Autenticación de proveedor AI (clave API Anthropic)
• Chat con asistente AI vía Web UI
• Integración Zeabur AI Hub
• Conexión bot de Telegram

🔄 En Pruebas

• Conexión WhatsApp (inicio con código QR)
• Conexión bot de Discord
• Integración Slack

---

Recursos Recomendados

Los requisitos de recursos pueden variar según las herramientas y funciones que utilice.

• Clúster Compartido: 2000 m (2 vCPU), 2048 Mi (2 GB)
• Servidor Dedicado: Recomendado para mejor rendimiento

Plataformas Compatibles

• WhatsApp
• Telegram
• Slack
• Discord
• Y más plataformas de mensajería

Uso

1. Después del despliegue, se genera automáticamente un token de Gateway seguro
2. Encuentre la URL pre-generada en la pestaña Instrucciones
3. Haga clic en el enlace "Web UI (with token)" para conectar directamente (el token está incluido en la URL)
4. Cuando vea la interfaz de Clawdbot, el despliegue está completo
5. Vaya a la página Chat para probar si su proveedor de AI funciona

Para más detalles, consulte la documentación oficial.

Configuración

• ZEABUR_AI_HUB_API_KEY: Su clave API de Zeabur AI Hub (Recomendado). Obtenga su clave API aquí
• ANTHROPIC_API_KEY: Su clave API de Anthropic para Claude
• OPENAI_API_KEY: Su clave API de OpenAI (opcional, para funciones de OpenAI como búsqueda de memoria, TTS)

Configuración de Bot de Telegram

Obtener el token de BotFather:

1. Abra Telegram y busque @BotFather
2. Envíe /newbot para crear un nuevo bot
3. Siga las instrucciones para configurar el nombre y nombre de usuario del bot
4. BotFather le enviará un token (ej: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Agregar el token a Zeabur:

1. Vaya a la pestaña Variable de su servicio en el panel de Zeabur
2. Agregue TELEGRAM_BOT_TOKEN con su token de bot
3. Reinicie el servicio

Vincular su cuenta de Telegram:

1. Envíe /start a su bot en Telegram
2. El bot responderá con un código de vinculación (ej: JN4MSY23)
3. Abra Comando en el panel de Zeabur para acceder a la terminal del contenedor
4. Ejecute: clawdbot pairing approve telegram <código>
5. Verá: Approved telegram sender <user-id>. indicando vinculación exitosa
6. ¡Ahora puede chatear con el bot!

Configuración Adicional

Además de las variables de entorno, puede configurar Clawdbot usando:

Web UI

1. Abra la Web UI de Clawdbot
2. Vaya a Settings para configurar modelos, canales y preferencias

Línea de Comandos

1. Abra Comando en el panel de Zeabur
2. Use comandos clawdbot para gestionar proveedores, modelos y configuraciones

Cambiar el Modelo Predeterminado

El modelo predeterminado es zeabur-ai/gpt-5-mini. Para cambiarlo:

Vía Web UI:

1. Abra Settings en la Web UI de Clawdbot
2. Seleccione su modelo preferido de la lista

Vía Línea de Comandos:

clawdbot config set agents.defaults.model.primary zeabur-ai/claude-sonnet-4-5

Modelos disponibles: gemini-3-pro-preview, gpt-5, claude-sonnet-4-5, gemini-3-flash-preview, gpt-5-mini, claude-haiku-4-5, gemini-2.5-flash, deepseek-v3.2

Persistencia de Datos

• /home/node/.clawdbot - Configuración, sesiones y credenciales
• /home/node/clawd - Espacio de trabajo y archivos de memoria

Documentación

• GitHub: https://github.com/clawdbot/clawdbot