Depura y corrige problemas comunes del asistente de IA Clawdbot. Aprende a diagnosticar problemas de conexión, fallos de mensajes y errores del gateway.

Descripción General de Solución de Problemas de Clawdbot

Esta guía te ayuda a diagnosticar y corregir problemas comunes con tu despliegue de Clawdbot. Encuentra soluciones para problemas de conexión, fallos de mensajes y errores del gateway.

Problemas Comunes

El Gateway No Inicia

Síntomas: El gateway falla al iniciar o se cierra inmediatamente.

Soluciones:

Verificar disponibilidad del puerto:

lsof -i :3010

Validar configuración:

clawdbot config validate

Verificar logs:

clawdbot gateway logs

Conexión de WhatsApp Fallida

Síntomas: El código QR no se muestra o la conexión se pierde.

Soluciones:

Limpiar sesión de WhatsApp:

rm -rf ~/.clawdbot/providers/whatsapp/session

Reiniciar gateway:

clawdbot gateway restart

Verificar conectividad de red

Mensajes No Entregados

Síntomas: Mensajes enviados pero no recibidos.

Soluciones:

Verificar estado de la sesión:

clawdbot sessions list

Verificar conexión del proveedor:

clawdbot providers status

Verificar límites de tasa

El Agente No Responde

Síntomas: El agente no genera respuestas.

Soluciones:

Verificar estado del agente:

clawdbot agents status

Verificar clave API:

echo $ANTHROPIC_API_KEY

Verificar disponibilidad del modelo

Comandos de Diagnóstico

Estado del Gateway

# Verificar salud del gateway
clawdbot gateway status

# Ver conexiones activas
clawdbot gateway connections

# Mostrar uso de recursos
clawdbot gateway stats

Diagnóstico de Sesiones

# Listar todas las sesiones
clawdbot sessions list

# Ver detalles de sesión
clawdbot sessions get <session-key>

# Limpiar sesión atascada
clawdbot sessions clear <session-key>

Diagnóstico de Proveedores

# Verificar estado del proveedor
clawdbot providers status

# Probar conexión del proveedor
clawdbot providers test whatsapp

# Reconectar proveedor
clawdbot providers reconnect telegram

Análisis de Logs

Habilitar Logging de Depuración

clawdbot gateway start --log-level debug

Ubicaciones de Logs

Log	Ubicación
Gateway	`~/.clawdbot/logs/gateway.log`
Proveedores	`~/.clawdbot/logs/providers/`
Agentes	`~/.clawdbot/logs/agents/`

Niveles de Log

Nivel	Descripción
`error`	Solo errores
`warn`	Advertencias y errores
`info`	Información general
`debug`	Información detallada de depuración

Códigos de Error

Errores de Conexión

Código	Descripción	Solución
`ECONNREFUSED`	Puerto no abierto	Verificar que el gateway esté ejecutándose
`ETIMEDOUT`	Tiempo de espera de red	Verificar red
`EAUTH`	Autenticación fallida	Verificar credenciales

Errores de Proveedor

Código	Descripción	Solución
`WA_DISCONNECTED`	WhatsApp desconectado	Re-escanear QR
`TG_INVALID_TOKEN`	Token de Telegram inválido	Verificar token
`DC_MISSING_INTENTS`	Intents de Discord faltantes	Habilitar intents

Problemas de Rendimiento

Respuestas Lentas

Causas:

Alto volumen de mensajes
Tamaño de contexto grande
Latencia de red

Soluciones:

Habilitar streaming
Reducir tamaño de contexto
Verificar red

Uso de Memoria

Verificar memoria:

clawdbot gateway stats --memory

Reducir memoria:

{
  "gateway": {
    "messageBuffer": 500,
    "maxHistory": 50
  }
}

Procedimientos de Recuperación

Resetear Gateway

# Detener gateway
clawdbot gateway stop

# Limpiar estado
clawdbot gateway reset --state

# Reiniciar
clawdbot gateway start

Resetear Proveedor

# Desconectar proveedor
clawdbot providers disconnect whatsapp

# Limpiar datos del proveedor
rm -rf ~/.clawdbot/providers/whatsapp

# Reconfigurar
clawdbot providers setup whatsapp

Resetear Agente

# Limpiar sesiones del agente
clawdbot agents reset main --sessions

# Limpiar espacio de trabajo del agente
clawdbot agents reset main --workspace

Obtener Ayuda

Recursos de Soporte

Documentación: https://docs.clawdbotai.app
GitHub Issues: https://github.com/clawdbot/clawdbot/issues
Discord de la Comunidad: https://discord.gg/clawdbot

Reportes de Errores

Incluir en los reportes de errores:

Versión de Clawdbot
Sistema operativo
Mensajes de error
Pasos para reproducir

Próximos Pasos

Configuración de Clawdbot - Guía de configuración
Seguridad de Clawdbot - Configuración de seguridad
Clawdbot Gateway - Descripción general del gateway

Solución de Problemas de Clawdbot

On this page