docs/flags.md at d788ce3c9fa20b41ece4e3f870027fcb8a010e83

openclaw/docs

Fork 0

openclaw-docs-i18n[bot] 642f4762ce chore(i18n): refresh es translations

2026-04-24 05:58:54 +00:00

2.8 KiB

Raw Blame History

read_when

summary

title

x-i18n

Necesitas registros de depuración dirigidos sin elevar los niveles globales de registro

Necesitas capturar registros específicos de subsistemas para soporte

Banderas de diagnóstico para registros de depuración dirigidos

Banderas de diagnóstico

generated_at	model	provider	source_hash	source_path	workflow
2026-04-24T05:27:29Z	gpt-5.4	openai	b7e5ec9c5e28ef51f1e617baf62412897df8096f227a74d86a0824e269aafd9d	diagnostics/flags.md	15

Las banderas de diagnóstico te permiten habilitar registros de depuración dirigidos sin activar el registro detallado en todas partes. Las banderas son opcionales y no tienen efecto a menos que un subsistema las consulte.

Cómo funciona

Las banderas son cadenas (no distinguen entre mayúsculas y minúsculas).
Puedes habilitar banderas en la configuración o mediante una anulación por entorno.
Se admiten comodines:
- telegram.* coincide con telegram.http
- * habilita todas las banderas

Habilitar mediante configuración

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}

Varias banderas:

{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}

Reinicia el gateway después de cambiar las banderas.

Anulación por entorno (puntual)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload

Desactivar todas las banderas:

OPENCLAW_DIAGNOSTICS=0

Dónde van los registros

Las banderas emiten registros en el archivo estándar de registros de diagnóstico. De forma predeterminada:

/tmp/openclaw/openclaw-YYYY-MM-DD.log

Si estableces 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

Filtrar diagnósticos HTTP de Telegram:

rg "telegram http error" /tmp/openclaw/openclaw-*.log

O seguirlos 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, estos registros pueden suprimirse. El valor predeterminado info está bien.
Las banderas son seguras para dejarlas habilitadas; solo afectan al volumen de registros del subsistema específico.
Usa /logging para cambiar destinos, niveles y redacción de registros.

2.8 KiB Raw Blame History