---
read_when:
    - Підготовка звіту про помилку або запиту до служби підтримки
    - Налагодження аварійних завершень Gateway, перезапусків, тиску на пам’ять або надмірно великих корисних навантажень
    - Перегляд того, які діагностичні дані записуються або приховуються
summary: Створюйте діагностичні пакети Gateway для звітів про помилки, якими можна поділитися
title: Експорт діагностики
x-i18n:
    generated_at: "2026-05-11T20:37:24Z"
    model: gpt-5.5
    provider: openai
    source_hash: d6df695c590fd8239226e2e4d4e266a7b705f3963f00a005be38c526b1f28afb
    source_path: gateway/diagnostics.md
    workflow: 16
---

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

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

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

```bash
openclaw gateway diagnostics export
```

Команда виводить шлях записаного zip-архіву. Щоб вибрати шлях:

```bash
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
```

Для автоматизації:

```bash
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](/uk/plugins/codex-harness#inspect-codex-threads-locally) для
цього робочого процесу перегляду.

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

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
активним.

Перегляньте живий реєстратор:

```bash
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
```

Перегляньте найновіший збережений пакет стабільності після фатального виходу, тайм-ауту
завершення роботи або збою запуску після перезапуску:

```bash
openclaw gateway stability --bundle latest
```

Створіть діагностичний zip-архів із найновішого збереженого пакета:

```bash
openclaw gateway stability --bundle latest --export
```

Збережені пакети розташовані в `~/.openclaw/logs/stability/`, коли події існують.

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

```bash
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`: вивести машиночитані метадані експорту.

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

Діагностику ввімкнено за замовчуванням. Щоб вимкнути реєстратор стабільності та
збирання діагностичних подій:

```json5
{
  diagnostics: {
    enabled: false,
  },
}
```

Вимкнення діагностики зменшує деталізацію звітів про помилки. Воно не впливає на звичайне
журналювання Gateway.

## Пов’язане

- [Перевірки справності](/uk/gateway/health)
- [Gateway CLI](/uk/cli/gateway#gateway-diagnostics-export)
- [протокол Gateway](/uk/gateway/protocol#system-and-identity)
- [Журналювання](/uk/logging)
- [експорт OpenTelemetry](/uk/gateway/opentelemetry) — окремий потік для потокового надсилання діагностики до колектора