Saltar al contenido principal

​
Indicadores de diagnóstico

Los indicadores de diagnóstico te permiten habilitar registros de depuración dirigidos sin activar el registro detallado en todas partes. Los indicadores son opcionales y no tienen efecto a menos que un subsistema los compruebe.

​
Cómo funciona

  • Los indicadores son cadenas (sin distinción entre mayúsculas y minúsculas).
  • Puedes habilitar indicadores en la configuración o mediante una anulación con variable de entorno.
  • Se admiten comodines:
    • telegram.* coincide con telegram.http
    • * habilita todos los indicadores

​
Habilitar mediante configuración

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
Varios indicadores: 
{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}
Reinicia el gateway después de cambiar los indicadores.

​
Anulación por variable de entorno (puntual)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
Deshabilitar todos los indicadores: 
OPENCLAW_DIAGNOSTICS=0

​
Dónde van los registros

Los indicadores emiten registros en el archivo estándar de diagnósticos. De forma predeterminada: 
/tmp/openclaw/openclaw-YYYY-MM-DD.log
Si configuras logging.file, usa esa ruta en su lugar. Los registros están en formato JSONL (un objeto JSON por línea). La redacción sigue aplicándose según logging.redactSensitive.

​
Extraer registros

Elige el archivo de registro más reciente: 
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
Filtra diagnósticos HTTP de Telegram: 
rg "telegram http error" /tmp/openclaw/openclaw-*.log
O sigue los registros mientras reproduces el problema: 
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
Para gateways remotos, también puedes usar openclaw logs --follow (consulta /cli/logs).

​
Notas

  • Si logging.level está configurado por encima de warn, es posible que estos registros se supriman. El valor predeterminado info es correcto.
  • Es seguro dejar los indicadores habilitados; solo afectan al volumen de registros del subsistema específico.
  • Usa /logging para cambiar destinos, niveles y redacción de registros.