diff --git a/docs/uk/cli/doctor.md b/docs/uk/cli/doctor.md index 8bdfaf2cf..e3e8649a1 100644 --- a/docs/uk/cli/doctor.md +++ b/docs/uk/cli/doctor.md @@ -1,14 +1,14 @@ --- read_when: - - У вас є проблеми з підключенням/автентифікацією, і вам потрібні керовані виправлення - - Ви оновилися й хочете виконати базову перевірку + - У вас проблеми з підключенням або автентифікацією, і вам потрібні покрокові виправлення + - Ви виконали оновлення й хочете провести базову перевірку summary: Довідник CLI для `openclaw doctor` (перевірки працездатності + керовані виправлення) title: Діагностика x-i18n: - generated_at: "2026-05-03T12:30:02Z" + generated_at: "2026-05-03T21:48:54Z" model: gpt-5.5 provider: openai - source_hash: d4baab5b0cd4d046d12ae5bd14ccf05224115856d45e630a57e77a2be15e5db0 + source_hash: cd7fb09d373c313e4be45ad9e3b19ceb187a5787ef3e70fcd2b1f1f01b50c905 source_path: cli/doctor.md workflow: 16 --- @@ -17,7 +17,7 @@ x-i18n: Перевірки стану + швидкі виправлення для Gateway і каналів. -Пов’язано: +Пов’язане: - Усунення несправностей: [Усунення несправностей](/uk/gateway/troubleshooting) - Аудит безпеки: [Безпека](/uk/gateway/security) @@ -32,47 +32,47 @@ openclaw doctor --repair --non-interactive openclaw doctor --generate-gateway-token ``` -## Опції +## Параметри -- `--no-workspace-suggestions`: вимкнути пропозиції пам’яті/пошуку робочого простору +- `--no-workspace-suggestions`: вимкнути пропозиції пам’яті/пошуку робочої області - `--yes`: приймати типові значення без запитів -- `--repair`: застосувати рекомендовані виправлення, не пов’язані із сервісами, без запитів; встановлення та перезапис сервісу Gateway все ще потребують інтерактивного підтвердження або явних команд Gateway +- `--repair`: застосувати рекомендовані виправлення, не пов’язані зі службами, без запитів; установлення та перезапис служб Gateway усе ще потребують інтерактивного підтвердження або явних команд Gateway - `--fix`: псевдонім для `--repair` -- `--force`: застосувати агресивні виправлення, включно з перезаписом користувацької конфігурації сервісу за потреби -- `--non-interactive`: запускати без запитів; лише безпечні міграції та виправлення, не пов’язані із сервісами +- `--force`: застосувати агресивні виправлення, зокрема перезапис користувацької конфігурації служби за потреби +- `--non-interactive`: запуск без запитів; лише безпечні міграції та виправлення, не пов’язані зі службами - `--generate-gateway-token`: згенерувати й налаштувати токен Gateway -- `--deep`: просканувати системні сервіси на наявність додаткових встановлень Gateway +- `--deep`: просканувати системні служби на наявність додаткових установлень Gateway Примітки: -- Інтерактивні запити (наприклад, виправлення keychain/OAuth) виконуються лише тоді, коли stdin є TTY і `--non-interactive` **не** встановлено. Безголові запуски (cron, Telegram, без термінала) пропускатимуть запити. -- Продуктивність: неінтерактивні запуски `doctor` пропускають завчасне завантаження plugin, щоб безголові перевірки стану залишалися швидкими. Інтерактивні сеанси все ще повністю завантажують plugins, коли перевірці потрібен їхній внесок. -- `--fix` (псевдонім для `--repair`) записує резервну копію до `~/.openclaw/openclaw.json.bak` і видаляє невідомі ключі конфігурації, перелічуючи кожне видалення. -- `doctor --fix --non-interactive` повідомляє про відсутні або застарілі визначення сервісу Gateway, але не встановлює й не перезаписує їх поза режимом виправлення оновлення. Запустіть `openclaw gateway install` для відсутнього сервісу або `openclaw gateway install --force`, коли ви навмисно хочете замінити launcher. -- Перевірки цілісності стану тепер виявляють осиротілі файли транскриптів у каталозі сеансів. Архівування їх як `.deleted.` потребує інтерактивного підтвердження; `--fix`, `--yes` і безголові запуски залишають їх на місці. +- Інтерактивні запити (наприклад, виправлення keychain/OAuth) виконуються лише тоді, коли stdin є TTY і **не** задано `--non-interactive`. Запуски без інтерфейсу (cron, Telegram, без термінала) пропускають запити. +- Продуктивність: неінтерактивні запуски `doctor` пропускають завчасне завантаження plugins, щоб перевірки стану без інтерфейсу залишалися швидкими. Інтерактивні сеанси все одно повністю завантажують plugins, коли перевірці потрібен їхній внесок. +- `--fix` (псевдонім для `--repair`) записує резервну копію в `~/.openclaw/openclaw.json.bak` і вилучає невідомі ключі конфігурації, перелічуючи кожне вилучення. +- `doctor --fix --non-interactive` повідомляє про відсутні або застарілі визначення служби Gateway, але не встановлює й не перезаписує їх поза режимом виправлення оновлення. Запустіть `openclaw gateway install` для відсутньої служби або `openclaw gateway install --force`, якщо ви навмисно хочете замінити засіб запуску. +- Перевірки цілісності стану тепер виявляють осиротілі файли транскриптів у каталозі сеансів. Архівування їх як `.deleted.` потребує інтерактивного підтвердження; `--fix`, `--yes` і запуски без інтерфейсу залишають їх на місці. - Doctor також сканує `~/.openclaw/cron/jobs.json` (або `cron.store`) на застарілі форми завдань Cron і може перезаписати їх на місці до того, як планувальнику доведеться автоматично нормалізувати їх під час виконання. -- На Linux doctor попереджає, коли crontab користувача все ще запускає застарілий `~/.openclaw/bin/ensure-whatsapp.sh`; цей скрипт більше не підтримується і може записувати хибні збої Gateway WhatsApp, коли Cron не має середовища systemd user-bus. -- Doctor очищає застарілий проміжний стан залежностей plugin, створений старішими версіями OpenClaw. Він також виправляє відсутні налаштовані завантажувані plugins, коли registry може їх розв’язати, а прохід doctor 2026.5.2 автоматично встановлює завантажувані plugins, які вже використовує старіша конфігурація, перш ніж позначити конфігурацію зміненою для цього релізу. -- Doctor виправляє застарілу конфігурацію plugin, видаляючи відсутні plugin ids з `plugins.allow`/`plugins.entries`, а також відповідну висячу конфігурацію каналів, цілі heartbeat і перевизначення моделей каналів, коли виявлення plugin працює коректно. -- Doctor ізолює недійсну конфігурацію plugin, вимикаючи відповідний запис `plugins.entries.` і видаляючи його недійсне корисне навантаження `config`. Запуск Gateway вже пропускає лише цей проблемний plugin, тому інші plugins і канали можуть продовжувати працювати. -- Установіть `OPENCLAW_SERVICE_REPAIR_POLICY=external`, коли інший supervisor керує життєвим циклом Gateway. Doctor все ще повідомляє про стан Gateway/сервісу і застосовує виправлення, не пов’язані із сервісами, але пропускає install/start/restart/bootstrap сервісу та очищення застарілих сервісів. -- На Linux doctor ігнорує неактивні додаткові systemd units, схожі на Gateway, і не перезаписує метадані команди/entrypoint для запущеного systemd-сервісу Gateway під час виправлення. Спочатку зупиніть сервіс або використайте `openclaw gateway install --force`, коли ви навмисно хочете замінити активний launcher. -- Doctor автоматично мігрує застарілу плоску конфігурацію Talk (`talk.voiceId`, `talk.modelId` та подібні) у `talk.provider` + `talk.providers.`. -- Повторні запуски `doctor --fix` більше не повідомляють і не застосовують нормалізацію Talk, коли єдина відмінність — порядок ключів об’єкта. -- Doctor містить перевірку готовності пошуку в пам’яті й може рекомендувати `openclaw configure --section model`, коли облікові дані embedding відсутні. -- Doctor попереджає, коли не налаштовано власника команд. Власник команд — це обліковий запис оператора-людини, якому дозволено виконувати команди лише для власника й затверджувати небезпечні дії. Сполучення через DM лише дозволяє комусь спілкуватися з ботом; якщо ви затвердили відправника до появи bootstrap першого власника, явно встановіть `commands.ownerAllowFrom`. -- Doctor попереджає, коли налаштовано агентів у режимі Codex і особисті ресурси Codex CLI існують у Codex home оператора. Локальні запуски app-server Codex використовують ізольовані домівки для кожного агента, тому використайте `openclaw migrate codex --dry-run`, щоб інвентаризувати ресурси, які слід свідомо просунути. -- Doctor попереджає, коли skills, дозволені для типового агента, недоступні в поточному середовищі виконання через відсутні bins, env vars, config або вимоги ОС. `doctor --fix` може вимкнути ці недоступні skills за допомогою `skills.entries..enabled=false`; натомість встановіть/налаштуйте відсутню вимогу, коли хочете залишити skill активним. -- Якщо режим sandbox увімкнено, але Docker недоступний, doctor повідомляє high-signal попередження з виправленням (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`). -- Якщо наявні застарілі файли registry sandbox (`~/.openclaw/sandbox/containers.json` або `~/.openclaw/sandbox/browsers.json`), doctor повідомляє про них; `openclaw doctor --fix` мігрує дійсні записи в шардовані каталоги registry і ізолює недійсні застарілі файли. -- Якщо `gateway.auth.token`/`gateway.auth.password` керуються SecretRef і недоступні в поточному шляху команди, doctor повідомляє попередження лише для читання й не записує plaintext fallback credentials. -- Якщо перевірка SecretRef каналу завершується помилкою в шляху виправлення, doctor продовжує роботу й повідомляє попередження замість раннього виходу. -- Після міграцій каталогу стану doctor попереджає, коли ввімкнені типові облікові записи Telegram або Discord залежать від env fallback, а `TELEGRAM_BOT_TOKEN` або `DISCORD_BOT_TOKEN` недоступні процесу doctor. -- Автоматичне розв’язання імен користувачів Telegram `allowFrom` (`doctor --fix`) потребує розв’язуваного токена Telegram у поточному шляху команди. Якщо перевірка токена недоступна, doctor повідомляє попередження й пропускає автоматичне розв’язання для цього проходу. +- У Linux doctor попереджає, коли crontab користувача досі запускає застарілий `~/.openclaw/bin/ensure-whatsapp.sh`; цей скрипт більше не підтримується і може журналювати хибні збої WhatsApp Gateway, коли cron не має середовища user-bus systemd. +- Doctor очищає застарілий стан підготовки залежностей plugin, створений старішими версіями OpenClaw. Він також відновлює відсутні налаштовані завантажувані plugins, коли реєстр може їх розпізнати, а прохід doctor 2026.5.2 автоматично встановлює завантажувані plugins, які вже використовує старіша конфігурація, перш ніж позначити конфігурацію як змінену для цього випуску. Якщо завантаження не вдається, doctor повідомляє про помилку встановлення та зберігає налаштований запис plugin для наступної спроби виправлення. +- Doctor виправляє застарілу конфігурацію plugin, вилучаючи відсутні ідентифікатори plugin з `plugins.allow`/`plugins.entries`, а також відповідну висячу конфігурацію каналів, цілі Heartbeat і перевизначення моделей каналів, коли виявлення plugin справне. +- Doctor ізолює недійсну конфігурацію plugin, вимикаючи відповідний запис `plugins.entries.` і вилучаючи його недійсне навантаження `config`. Запуск Gateway уже пропускає лише цей несправний plugin, тож інші plugins і канали можуть продовжувати працювати. +- Установіть `OPENCLAW_SERVICE_REPAIR_POLICY=external`, коли життєвим циклом Gateway керує інший supervisor. Doctor усе ще повідомляє про стан Gateway/служби та застосовує виправлення, не пов’язані зі службами, але пропускає встановлення/запуск/перезапуск/bootstrap служби та очищення застарілих служб. +- У Linux doctor ігнорує неактивні додаткові systemd-юніти, схожі на Gateway, і не перезаписує метадані команди/точки входу для запущеної systemd-служби Gateway під час виправлення. Спершу зупиніть службу або використайте `openclaw gateway install --force`, якщо ви навмисно хочете замінити активний засіб запуску. +- Doctor автоматично мігрує застарілу пласку конфігурацію Talk (`talk.voiceId`, `talk.modelId` і пов’язані параметри) у `talk.provider` + `talk.providers.`. +- Повторні запуски `doctor --fix` більше не повідомляють і не застосовують нормалізацію Talk, коли єдина різниця полягає в порядку ключів об’єкта. +- Doctor містить перевірку готовності пошуку в пам’яті та може рекомендувати `openclaw configure --section model`, коли відсутні облікові дані embeddings. +- Doctor попереджає, коли не налаштовано власника команд. Власник команд — це обліковий запис оператора-людини, якому дозволено запускати команди лише для власника та схвалювати небезпечні дії. Сполучення через DM лише дозволяє комусь говорити з ботом; якщо ви схвалили відправника до появи bootstrap першого власника, явно задайте `commands.ownerAllowFrom`. +- Doctor попереджає, коли налаштовано агентів у режимі Codex і особисті ресурси Codex CLI існують у Codex home оператора. Локальні запуски app-server Codex використовують ізольовані home для кожного агента, тож використайте `openclaw migrate codex --dry-run`, щоб інвентаризувати ресурси, які слід свідомо підвищити. +- Doctor попереджає, коли Skills, дозволені для типового агента, недоступні в поточному середовищі виконання, бо відсутні bins, змінні середовища, конфігурація або вимоги ОС. `doctor --fix` може вимкнути ці недоступні Skills через `skills.entries..enabled=false`; натомість установіть/налаштуйте відсутню вимогу, якщо хочете зберегти skill активним. +- Якщо режим пісочниці ввімкнено, але Docker недоступний, doctor повідомляє чітке попередження з виправленням (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`). +- Якщо присутні застарілі файли реєстру пісочниці (`~/.openclaw/sandbox/containers.json` або `~/.openclaw/sandbox/browsers.json`), doctor повідомляє про них; `openclaw doctor --fix` мігрує дійсні записи в сегментовані каталоги реєстру та ізолює недійсні застарілі файли. +- Якщо `gateway.auth.token`/`gateway.auth.password` керуються SecretRef і недоступні в поточному шляху команди, doctor повідомляє попередження лише для читання й не записує відкриті резервні облікові дані. +- Якщо інспекція SecretRef каналу зазнає невдачі в шляху виправлення, doctor продовжує роботу й повідомляє попередження замість раннього завершення. +- Після міграцій каталогу стану doctor попереджає, коли ввімкнені типові облікові записи Telegram або Discord залежать від резервного env, а `TELEGRAM_BOT_TOKEN` або `DISCORD_BOT_TOKEN` недоступний процесу doctor. +- Автоматичне розпізнавання імен користувачів Telegram `allowFrom` (`doctor --fix`) потребує доступного для розпізнавання токена Telegram у поточному шляху команди. Якщо інспекція токена недоступна, doctor повідомляє попередження й пропускає автоматичне розпізнавання для цього проходу. ## macOS: перевизначення env `launchctl` -Якщо ви раніше запускали `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (або `...PASSWORD`), це значення перевизначає ваш файл конфігурації й може спричиняти сталі помилки “unauthorized”. +Якщо ви раніше запускали `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (або `...PASSWORD`), це значення перевизначає ваш файл конфігурації та може спричиняти постійні помилки “unauthorized”. ```bash launchctl getenv OPENCLAW_GATEWAY_TOKEN @@ -82,7 +82,7 @@ launchctl unsetenv OPENCLAW_GATEWAY_TOKEN launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD ``` -## Пов’язано +## Пов’язане - [Довідник CLI](/uk/cli) - [Gateway doctor](/uk/gateway/doctor)