Skip to content

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 status

Si el daemon no esta ejecutandose, inicielo:

bash
triggerfish start

2. Revise los logs

bash
triggerfish logs

Esto 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 WARN

3. Ejecute diagnosticos

bash
triggerfish patrol

Patrol 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 validate

Esto 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:

  1. Recopile un paquete de logs
  2. Lea la guia para reportar issues
  3. Abra un issue en GitHub