Solución de problemas
Comience aquí cuando algo no funcione. Siga los pasos en orden.
Primeros pasos
1. Compruebe si el daemon está en ejecución
bash
triggerfish statusSi el daemon no está en ejecución, inícielo:
bash
triggerfish start2. Compruebe los registros
bash
triggerfish logsEsto muestra el fichero de registro en tiempo real. Utilice un filtro de nivel para reducir el ruido:
bash
triggerfish logs --level ERROR
triggerfish logs --level WARN3. Ejecute diagnósticos
bash
triggerfish patrolPatrol comprueba si el gateway es accesible, si el proveedor LLM responde, si los canales están conectados, si las reglas de política están cargadas y si las skills están descubiertas. Cualquier comprobación marcada como CRITICAL o WARNING le indica dónde centrar la atención.
4. Valide su configuración
bash
triggerfish config validateEsto analiza triggerfish.yaml, comprueba los campos obligatorios, valida los niveles de clasificación y resuelve las referencias de secretos.
Solución de problemas por área
Si los primeros pasos anteriores no le han señalado el problema, seleccione el área que coincida con sus síntomas:
- Instalación - fallos del script de instalación, problemas al compilar desde el código fuente, problemas de plataforma
- Daemon - el servicio no se inicia, conflictos de puertos, errores de "ya en ejecución"
- Configuración - errores de análisis YAML, campos ausentes, fallos de resolución de secretos
- Canales - el bot no responde, fallos de autenticación, problemas de entrega de mensajes
- Proveedores LLM - errores de API, modelo no encontrado, fallos de streaming
- Integraciones - OAuth de Google, PAT de GitHub, API de Notion, CalDAV, servidores MCP
- Automatización del navegador - Chrome no encontrado, fallos de inicio, navegación bloqueada
- Seguridad y clasificación - bloqueos de write-down, problemas de taint, SSRF, denegaciones de política
- Secretos y credenciales - errores de llavero, almacén de ficheros cifrados, problemas de permisos
¿Sigue atascado?
Si ninguna de las guías anteriores ha resuelto su problema:
- Recopile un paquete de registros
- Lea la guía para reportar issues
- Abra un issue en GitHub
