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

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw може створити локальний діагностичний zip-архів для звітів про помилки. Він поєднує санітизовані статус, справність, журнали, форму конфігурації Gateway і нещодавні події стабільності без корисного навантаження. Ставтеся до діагностичних пакетів як до секретів, доки не переглянете їх. Вони спроєктовані так, щоб вилучати або редагувати корисні навантаження та облікові дані, але все одно узагальнюють локальні журнали Gateway і стан середовища виконання на рівні хоста.

​
Швидкий старт

openclaw gateway diagnostics export
Команда виводить шлях записаного zip-архіву. Щоб вибрати шлях: 
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
Для автоматизації: 
openclaw gateway diagnostics export --json

​
Команда чату

Власники можуть використовувати /diagnostics [note] у чаті, щоб запросити локальний експорт Gateway. Використовуйте це, коли помилка сталася в реальній розмові й потрібен один звіт для підтримки, який можна скопіювати й вставити:
  1. Надішліть /diagnostics у розмові, де ви помітили проблему. Додайте коротку примітку, якщо це допоможе, наприклад /diagnostics bad tool choice.
  2. OpenClaw надсилає вступ до діагностики й просить одне явне схвалення exec. Схвалення запускає openclaw gateway diagnostics export --json. Не схвалюйте діагностику через правило allow-all.
  3. Після схвалення OpenClaw відповідає звітом для вставлення, який містить локальний шлях пакета, зведення маніфесту, примітки щодо приватності та відповідні ідентифікатори сеансів.
У групових чатах власник усе ще може виконати /diagnostics, але OpenClaw не публікує діагностичні подробиці назад у спільний чат. Він надсилає вступ, запити на схвалення, результат експорту Gateway і розбивку сеансу/потоку Codex власнику через приватний маршрут схвалення. Група отримує лише коротке сповіщення про те, що діагностичний потік було надіслано приватно. Якщо OpenClaw не може знайти приватний маршрут до власника, команда завершується безпечною відмовою й просить власника запустити її з DM. Коли активний сеанс OpenClaw використовує нативну обв’язку OpenAI Codex, те саме схвалення exec також охоплює завантаження відгуку OpenAI для потоків середовища виконання Codex, про які знає OpenClaw. Це завантаження окреме від локального zip-архіву Gateway і з’являється лише для сеансів обв’язки Codex. Перед схваленням запит пояснює, що схвалення діагностики також надішле відгук Codex, але він не перелічує ідентифікатори сеансів або потоків Codex. Після схвалення відповідь у чаті перелічує канали, ідентифікатори сеансів OpenClaw, ідентифікатори потоків Codex і локальні команди resume для потоків, які було надіслано на сервери OpenAI. Якщо ви відхилите або проігноруєте схвалення, OpenClaw не запускає експорт, не надсилає відгук Codex і не виводить ідентифікатори Codex. Це робить типовий цикл налагодження Codex коротким: помітили неправильну поведінку в Telegram, Discord або іншому каналі, запустили /diagnostics, один раз схвалили, поділилися звітом із підтримкою, а потім запустили надруковану команду codex resume <thread-id> локально, якщо хочете самостійно переглянути нативний потік Codex. Див. обв’язка Codex для цього робочого процесу перегляду.

​
Що містить експорт

Zip-архів містить:
  • summary.md: зрозумілий для людини огляд для підтримки.
  • diagnostics.json: машиночитане зведення конфігурації, журналів, статусу, справності та даних стабільності.
  • manifest.json: метадані експорту та список файлів.
  • Санітизовану форму конфігурації та несекретні подробиці конфігурації.
  • Санітизовані зведення журналів і нещодавні відредаговані рядки журналів.
  • Найкращі можливі знімки статусу та справності Gateway.
  • stability/latest.json: найновіший збережений пакет стабільності, якщо доступний.
Експорт корисний навіть тоді, коли Gateway несправний. Якщо Gateway не може відповісти на запити статусу або справності, локальні журнали, форма конфігурації та найновіший пакет стабільності все одно збираються, коли доступні.

​
Модель приватності

Діагностика спроєктована так, щоб нею можна було ділитися. Експорт зберігає операційні дані, які допомагають у налагодженні, зокрема:
  • назви підсистем, ідентифікатори Plugin, ідентифікатори провайдерів, ідентифікатори каналів і налаштовані режими
  • коди статусу, тривалості, кількість байтів, стан черги та показники пам’яті
  • санітизовані метадані журналів і відредаговані операційні повідомлення
  • форму конфігурації та несекретні налаштування функцій
Експорт вилучає або редагує:
  • текст чату, підказки, інструкції, тіла Webhook і виводи інструментів
  • облікові дані, ключі API, токени, cookies і секретні значення
  • необроблені тіла запитів або відповідей
  • ідентифікатори облікових записів, ідентифікатори повідомлень, необроблені ідентифікатори сеансів, імена хостів і локальні імена користувачів
Коли повідомлення журналу схоже на текст користувача, чату, підказки або корисного навантаження інструмента, експорт зберігає лише факт того, що повідомлення було вилучено, і кількість байтів.

​
Реєстратор стабільності

Gateway за замовчуванням записує обмежений потік стабільності без корисного навантаження, коли діагностику ввімкнено. Він призначений для операційних фактів, а не вмісту. Той самий діагностичний Heartbeat записує зразки життєздатності, коли Gateway продовжує працювати, але цикл подій Node.js або CPU виглядає перевантаженим. Ці події diagnostic.liveness.warning містять затримку циклу подій, використання циклу подій, співвідношення CPU-ядер, кількість активних/очікувальних/поставлених у чергу сеансів, поточну фазу запуску/середовища виконання, якщо відома, нещодавні проміжки фаз і обмежені мітки активної/поставленої в чергу роботи. Неактивні зразки лишаються в телеметрії на рівні info. Зразки життєздатності стають попередженнями Gateway лише коли робота очікує або стоїть у черзі, або коли активна робота перетинається зі стійкою затримкою циклу подій. Тимчасові піки максимальної затримки під час інакше справної фонової роботи лишаються в журналах налагодження. Вони самі по собі не перезапускають Gateway. Фази запуску також створюють події diagnostic.phase.completed із часовими показниками wall-clock і CPU. Діагностика завислого embedded-run позначає terminalProgressStale=true, коли останній прогрес bridge виглядав термінальним, як-от необроблений елемент відповіді або подія завершення відповіді, але Gateway усе ще вважає embedded run активним. Перегляньте живий реєстратор: 
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
Перегляньте найновіший збережений пакет стабільності після фатального виходу, тайм-ауту завершення роботи або збою запуску після перезапуску: 
openclaw gateway stability --bundle latest
Створіть діагностичний zip-архів із найновішого збереженого пакета: 
openclaw gateway stability --bundle latest --export
Збережені пакети розташовані в ~/.openclaw/logs/stability/, коли події існують.

​
Корисні параметри

openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
  • --output <path>: записати в конкретний шлях zip-архіву.
  • --log-lines <count>: максимальна кількість санітизованих рядків журналу для включення.
  • --log-bytes <bytes>: максимальна кількість байтів журналу для перевірки.
  • --url <url>: URL WebSocket Gateway для знімків статусу та справності.
  • --token <token>: токен Gateway для знімків статусу та справності.
  • --password <password>: пароль Gateway для знімків статусу та справності.
  • --timeout <ms>: тайм-аут знімків статусу та справності.
  • --no-stability-bundle: пропустити пошук збереженого пакета стабільності.
  • --json: вивести машиночитані метадані експорту.

​
Вимкнення діагностики

Діагностику ввімкнено за замовчуванням. Щоб вимкнути реєстратор стабільності та збирання діагностичних подій: 
{
  diagnostics: {
    enabled: false,
  },
}
Вимкнення діагностики зменшує деталізацію звітів про помилки. Воно не впливає на звичайне журналювання Gateway.

​
Пов’язане