openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
b4e1995b3b
docs/docs/it/diagnostics/flags.md
openclaw-docs-i18n[bot] 4521f5a24a chore(i18n): refresh it translations
2026-04-24 09:12:03 +00:00

2.6 KiB
Raw Blame History

read_when summary title x-i18n
Ti servono log di debug mirati senza aumentare i livelli di log globali
Ti serve acquisire log specifici del sottosistema per il supporto
Flag di diagnostica per log di debug mirati Flag di diagnostica
generated_at model provider source_hash source_path workflow
2026-04-24T08:38:53Z gpt-5.4 openai b7e5ec9c5e28ef51f1e617baf62412897df8096f227a74d86a0824e269aafd9d diagnostics/flags.md 15

I flag di diagnostica ti consentono di abilitare log di debug mirati senza attivare il logging verboso ovunque. I flag sono opt-in e non hanno alcun effetto a meno che un sottosistema non li controlli.

Come funziona

  • I flag sono stringhe (case-insensitive).
  • Puoi abilitare i flag nella configurazione o tramite un override env.
  • I caratteri jolly sono supportati:
    • telegram.* corrisponde a telegram.http
    • * abilita tutti i flag

Abilita tramite configurazione

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

Più flag:

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

Riavvia il Gateway dopo aver modificato i flag.

Override env (una tantum)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload

Disattiva tutti i flag:

OPENCLAW_DIAGNOSTICS=0

Dove finiscono i log

I flag emettono log nel file di log di diagnostica standard. Per impostazione predefinita:

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

Se imposti logging.file, usa invece quel percorso. I log sono in formato JSONL (un oggetto JSON per riga). La redazione continua ad applicarsi in base a logging.redactSensitive.

Estrai i log

Scegli il file di log più recente:

ls -t /tmp/openclaw/openclaw-*.log | head -n 1

Filtra per la diagnostica HTTP di Telegram:

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

Oppure usa tail mentre riproduci il problema:

tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"

Per i Gateway remoti, puoi anche usare openclaw logs --follow (vedi /cli/logs).

Note

  • Se logging.level è impostato su un valore più alto di warn, questi log possono essere soppressi. Il valore predefinito info va bene.
  • I flag sono sicuri da lasciare abilitati; influenzano solo il volume dei log per il sottosistema specifico.
  • Usa /logging per cambiare destinazioni dei log, livelli e redazione.

Correlati