Журналювання

• Файлові журнали (рядки JSON), які записує Gateway.
• Консольний вивід у терміналі, де працює Gateway.

​

Де розташовані журнали

{
  "logging": {
    "file": "/path/to/openclaw.log"
  }
}

​

Як читати журнали

​

CLI: відстеження наживо (рекомендовано)

openclaw logs --follow

• Сеанси TTY: наочні кольорові структуровані рядки журналу.
• Сеанси без TTY: звичайний текст.

• meta: метадані потоку (файл, джерело, тип джерела, служба, курсор, розмір)
• log: проаналізований запис журналу
• notice: повідомлення про обрізання / ротацію
• raw: непроаналізований рядок журналу
• error: помилки підключення до Gateway (записуються в stderr)

openclaw doctor

​

Інтерфейс керування (веб)

​

Журнали лише каналів

openclaw channels logs --channel whatsapp

​

Формати журналів

​

Файлові журнали (JSONL)

• hostname: ім’я хоста Gateway.
• message: зведений текст повідомлення журналу для повнотекстового пошуку.
• agent_id: ідентифікатор активного агента, якщо виклик журналювання містить контекст агента.
• session_id: ідентифікатор/ключ активного сеансу, якщо виклик журналювання містить контекст сеансу.
• channel: активний канал, якщо виклик журналювання містить контекст каналу.

​

Консольний вивід

• Префікси підсистем (наприклад, gateway/channels/whatsapp)
• Кольорове позначення рівнів (інформація/попередження/помилка)
• Необов’язковий компактний режим або режим JSON

​

Журнали WebSocket Gateway

• звичайний режим: лише важливі результати (помилки, помилки аналізу, повільні виклики)
• --verbose: увесь трафік запитів/відповідей
• --ws-log auto|compact|full: вибір стилю докладного відображення
• --compact: псевдонім для --ws-log compact

openclaw gateway
openclaw gateway --verbose --ws-log compact
openclaw gateway --verbose --ws-log full

​

Налаштування журналювання

{
  "logging": {
    "level": "info",
    "file": "/tmp/openclaw/openclaw-YYYY-MM-DD.log",
    "consoleLevel": "info",
    "consoleStyle": "pretty",
    "redactSensitive": "tools",
    "redactPatterns": ["sk-.*"]
  }
}

​

Рівні журналювання

• logging.level: рівень файлових журналів (JSONL) (за замовчуванням: info).
• logging.consoleLevel: рівень докладності консолі.

​

Цільова діагностика транспорту моделей

OPENCLAW_DEBUG_MODEL_TRANSPORT=1 openclaw gateway
OPENCLAW_DEBUG_MODEL_PAYLOAD=tools OPENCLAW_DEBUG_SSE=events openclaw gateway

• OPENCLAW_DEBUG_MODEL_TRANSPORT=1: виводити початок запиту, відповідь отримання, заголовки SDK, першу потокову подію, завершення потоку та транспортні помилки на рівні info.
• OPENCLAW_DEBUG_MODEL_PAYLOAD=summary: додавати обмежений підсумок корисного навантаження запиту до журналів запитів моделі.
• OPENCLAW_DEBUG_MODEL_PAYLOAD=tools: додавати до підсумку корисного навантаження всі назви інструментів, доступних моделі.
• OPENCLAW_DEBUG_MODEL_PAYLOAD=full-redacted: додавати відредагований і обмежений за розміром знімок корисного навантаження JSON. Використовуйте лише під час налагодження; секрети редагуються, але запити та текст повідомлень усе одно можуть бути присутні.
• OPENCLAW_DEBUG_SSE=events: виводити часові показники першої події та завершення потоку.
• OPENCLAW_DEBUG_SSE=peek: також виводити корисне навантаження перших п’яти відредагованих подій SSE з обмеженням розміру кожної події.
• OPENCLAW_DEBUG_CODE_MODE=1: виводити діагностичні дані поверхні моделі в режимі коду, зокрема коли нативні інструменти постачальника приховано, оскільки режим коду володіє поверхнею інструментів.

​

Кореляція трасування

​

Розмір і часові показники виклику моделі

• requestPayloadBytes: розмір у байтах UTF-8 остаточного корисного навантаження запиту моделі
• responseStreamBytes: розмір у байтах UTF-8 корисного навантаження потокових фрагментів відповіді моделі. Часті події дельт тексту, міркувань і викликів інструментів враховують лише байти приросту delta, а не повні знімки partial.
• timeToFirstByteMs: час до першої потокової події відповіді
• durationMs: загальна тривалість виклику моделі

​

Стилі консолі

• pretty: зручний для читання, кольоровий, із часовими позначками.
• compact: щільніший вивід (найкращий для тривалих сеансів).
• json: JSON у кожному рядку (для обробників журналів).

​

Редагування конфіденційних даних

• logging.redactSensitive: off | tools (за замовчуванням: tools)
• logging.redactPatterns: список рядків регулярних виразів, який замінює стандартний набір для виводу журналів/розшифрувань. Для корисного навантаження інструментів інтерфейсу керування користувацькі шаблони застосовуються додатково до вбудованих стандартних, тому додавання шаблону ніколи не послаблює редагування значень, які вже виявляють стандартні шаблони.

​

Діагностика та OpenTelemetry

• Експорт OpenTelemetry — надсилання метрик, трасувань і журналів через OTLP/HTTP до будь-якого сумісного з OpenTelemetry збирача або серверної системи (Datadog, Grafana, Honeycomb, New Relic, Tempo тощо). Повна конфігурація, каталог сигналів, назви метрик/інтервалів, змінні середовища та модель конфіденційності наведені на окремій сторінці: Експорт OpenTelemetry.
• Прапорці діагностики — цільові прапорці журналювання налагодження, які спрямовують додаткові журнали до logging.file, не підвищуючи logging.level. Прапорці не залежать від регістру та підтримують символи підстановки (telegram.*, *). Налаштуйте їх у diagnostics.flags або за допомогою перевизначення змінною середовища OPENCLAW_DIAGNOSTICS=.... Повний посібник: Прапорці діагностики.

​

Поради щодо усунення несправностей

• Gateway недоступний? Спочатку виконайте openclaw doctor.
• Журнали порожні? Переконайтеся, що Gateway працює та записує дані за шляхом до файлу, указаним у logging.file.
• Потрібно більше подробиць? Установіть для logging.level значення debug або trace та повторіть спробу.

​

Пов’язані матеріали

• Експорт OpenTelemetry — експорт через OTLP/HTTP, каталог метрик/інтервалів, модель конфіденційності
• Прапорці діагностики — цільові прапорці журналювання налагодження
• Внутрішня реалізація журналювання Gateway — стилі журналів WS, префікси підсистем і захоплення консолі
• Довідник із конфігурації — повний довідник полів diagnostics.*