Solucion de Problemas
Comience aqui cuando algo no esta funcionando. Siga los pasos en orden.
Primeros Pasos
1. Verifique si el daemon esta ejecutandose
bash
triggerfish statusSi el daemon no esta ejecutandose, inicielo:
bash
triggerfish start2. Revise los logs
bash
triggerfish logsEsto muestra el archivo de log en tiempo real. Use un filtro de nivel para reducir el ruido:
bash
triggerfish logs --level ERROR
triggerfish logs --level WARN3. Ejecute diagnosticos
bash
triggerfish patrolPatrol verifica si el gateway es alcanzable, si el proveedor LLM responde, si los canales estan conectados, si las reglas de politica estan cargadas y si los skills fueron descubiertos. Cualquier verificacion marcada como CRITICAL o WARNING le indica donde enfocarse.
4. Valide su configuracion
bash
triggerfish config validateEsto analiza triggerfish.yaml, verifica campos requeridos, valida niveles de clasificacion y resuelve referencias de secretos.
Solucion de Problemas por Area
Si los primeros pasos anteriores no lo dirigieron al problema, elija el area que coincida con sus sintomas:
- Instalacion - fallos del script de instalacion, problemas al compilar desde fuente, problemas de plataforma
- Daemon - el servicio no inicia, conflictos de puertos, errores de "ya esta ejecutandose"
- Configuracion - errores de YAML, campos faltantes, fallos de resolucion de secretos
- Canales - bot no responde, fallos de autenticacion, problemas de entrega de mensajes
- Proveedores LLM - errores de API, modelo no encontrado, fallos de streaming
- Integraciones - Google OAuth, GitHub PAT, Notion API, CalDAV, servidores MCP
- Automatizacion de Navegador - Chrome no encontrado, fallos de inicio, navegacion bloqueada
- Seguridad y Clasificacion - bloqueos de write-down, problemas de taint, SSRF, denegaciones de politica
- Secretos y Credenciales - errores de keychain, almacen de archivos cifrados, problemas de permisos
Aun Atascado?
Si ninguna de las guias anteriores resolvio su problema:
- Recopile un paquete de logs
- Lea la guia para reportar issues
- Abra un issue en GitHub
