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

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

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

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

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

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

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

​
Модель конфіденційності

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

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

Gateway типово записує обмежений потік даних стабільності без корисного навантаження, коли діагностику ввімкнено. Він призначений для операційних фактів, а не для вмісту. Перегляньте активний реєстратор: 
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.

​
Пов’язана документація