Перейти до основного вмісту

​
Прапорці діагностики

Прапорці діагностики дають змогу вмикати цільові журнали налагодження без увімкнення докладного журналювання всюди. Прапорці вмикаються за бажанням і не мають жодного ефекту, якщо підсистема їх не перевіряє.

​
Як це працює

  • Прапорці — це рядки (без урахування регістру).
  • Ви можете вмикати прапорці в конфігурації або через перевизначення env.
  • Підтримуються wildcard:
    • telegram.* відповідає telegram.http
    • * вмикає всі прапорці

​
Увімкнення через конфігурацію

{
  "diagnostics": {
    "flags": ["telegram.http"]
  }
}
Кілька прапорців: 
{
  "diagnostics": {
    "flags": ["telegram.http", "gateway.*"]
  }
}
Після зміни прапорців перезапустіть gateway.

​
Перевизначення env (разово)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload
Вимкнення всіх прапорців: 
OPENCLAW_DIAGNOSTICS=0

​
Куди потрапляють журнали

Прапорці записують журнали у стандартний файл журналу діагностики. Типово: 
/tmp/openclaw/openclaw-YYYY-MM-DD.log
Якщо ви задали logging.file, використовуйте натомість цей шлях. Журнали мають формат JSONL (один JSON-об’єкт на рядок). Редагування чутливих даних і далі застосовується залежно від logging.redactSensitive.

​
Отримання журналів

Виберіть найновіший файл журналу: 
ls -t /tmp/openclaw/openclaw-*.log | head -n 1
Відфільтруйте журнали діагностики Telegram HTTP: 
rg "telegram http error" /tmp/openclaw/openclaw-*.log
Або стежте за ними під час відтворення: 
tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"
Для віддалених gateway ви також можете використовувати openclaw logs --follow (див. /cli/logs).

​
Примітки

  • Якщо logging.level задано вище за warn, ці журнали можуть бути приглушені. Типове значення info підходить.
  • Прапорці безпечно залишати ввімкненими; вони впливають лише на обсяг журналів для конкретної підсистеми.
  • Використовуйте /logging, щоб змінити призначення журналів, рівні та редагування чутливих даних.