From 4db903fda4c88baca5fca58c377fe8bf3740778d Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 3 May 2026 12:30:35 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/cli/doctor.md | 75 ++++++++++++----------- docs/uk/cli/sandbox.md | 135 ++++++++++++++++++++++------------------- 2 files changed, 109 insertions(+), 101 deletions(-) diff --git a/docs/uk/cli/doctor.md b/docs/uk/cli/doctor.md index 361ffe3d9..8bdfaf2cf 100644 --- a/docs/uk/cli/doctor.md +++ b/docs/uk/cli/doctor.md @@ -1,23 +1,23 @@ --- read_when: - - У вас проблеми з підключенням або автентифікацією, і ви хочете отримати покрокові виправлення - - Ви оновили й хочете виконати базову перевірку -summary: Довідник CLI для `openclaw doctor` (перевірки справності + керовані виправлення) + - У вас є проблеми з підключенням/автентифікацією, і вам потрібні керовані виправлення + - Ви оновилися й хочете виконати базову перевірку +summary: Довідник CLI для `openclaw doctor` (перевірки працездатності + керовані виправлення) title: Діагностика x-i18n: - generated_at: "2026-05-02T18:57:43Z" + generated_at: "2026-05-03T12:30:02Z" model: gpt-5.5 provider: openai - source_hash: c64cefee8f36b38657b72912271e3734411870376d2bd5a374d23a77a080035d + source_hash: d4baab5b0cd4d046d12ae5bd14ccf05224115856d45e630a57e77a2be15e5db0 source_path: cli/doctor.md workflow: 16 --- # `openclaw doctor` -Перевірки справності + швидкі виправлення для Gateway і каналів. +Перевірки стану + швидкі виправлення для Gateway і каналів. -Пов’язане: +Пов’язано: - Усунення несправностей: [Усунення несправностей](/uk/gateway/troubleshooting) - Аудит безпеки: [Безпека](/uk/gateway/security) @@ -32,46 +32,47 @@ openclaw doctor --repair --non-interactive openclaw doctor --generate-gateway-token ``` -## Параметри +## Опції - `--no-workspace-suggestions`: вимкнути пропозиції пам’яті/пошуку робочого простору - `--yes`: приймати типові значення без запитів -- `--repair`: застосувати рекомендовані виправлення, не пов’язані зі службами, без запитів; встановлення та перезаписи служби Gateway усе ще потребують інтерактивного підтвердження або явних команд Gateway +- `--repair`: застосувати рекомендовані виправлення, не пов’язані із сервісами, без запитів; встановлення та перезапис сервісу Gateway все ще потребують інтерактивного підтвердження або явних команд Gateway - `--fix`: псевдонім для `--repair` -- `--force`: застосувати агресивні виправлення, зокрема перезапис власної конфігурації служби за потреби -- `--non-interactive`: виконати без запитів; лише безпечні міграції та виправлення, не пов’язані зі службами -- `--generate-gateway-token`: згенерувати та налаштувати токен Gateway -- `--deep`: просканувати системні служби на наявність додаткових встановлень Gateway +- `--force`: застосувати агресивні виправлення, включно з перезаписом користувацької конфігурації сервісу за потреби +- `--non-interactive`: запускати без запитів; лише безпечні міграції та виправлення, не пов’язані із сервісами +- `--generate-gateway-token`: згенерувати й налаштувати токен 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. -- Перевірки цілісності стану тепер виявляють осиротілі файли transcript у каталозі sessions. Їх архівування як `.deleted.` потребує інтерактивного підтвердження; `--fix`, `--yes` і безголові запуски залишають їх на місці. -- Doctor також сканує `~/.openclaw/cron/jobs.json` (або `cron.store`) на наявність застарілих форм завдань cron і може переписати їх на місці до того, як scheduler буде змушений автоматично нормалізувати їх під час виконання. -- У Linux doctor попереджає, коли crontab користувача все ще запускає застарілий `~/.openclaw/bin/ensure-whatsapp.sh`; цей скрипт більше не підтримується і може реєструвати хибні збої WhatsApp Gateway, коли cron не має середовища systemd user-bus. -- Doctor очищає застарілий проміжний стан залежностей Plugin, створений старішими версіями OpenClaw. Він також виправляє відсутні налаштовані завантажувані plugins, коли registry може їх розпізнати, а проходження doctor 2026.5.2 автоматично встановлює завантажувані plugins, які вже використовує старіша конфігурація, перед позначенням конфігурації як зміненої для цього випуску. -- Doctor виправляє застарілу конфігурацію Plugin, видаляючи відсутні ідентифікатори Plugin з `plugins.allow`/`plugins.entries`, а також відповідну висячу конфігурацію каналів, цілі Heartbeat і перевизначення моделей каналів, коли виявлення Plugin справне. -- Doctor ізолює недійсну конфігурацію Plugin, вимикаючи відповідний запис `plugins.entries.` і видаляючи його недійсний payload `config`. Запуск Gateway уже пропускає лише цей несправний Plugin, тож інші plugins і канали можуть продовжувати працювати. -- Встановіть `OPENCLAW_SERVICE_REPAIR_POLICY=external`, коли інший supervisor керує життєвим циклом Gateway. Doctor усе ще повідомляє про справність Gateway/служби та застосовує виправлення, не пов’язані зі службами, але пропускає встановлення/запуск/перезапуск/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 містить перевірку готовності memory-search і може рекомендувати `openclaw configure --section model`, коли облікові дані embedding відсутні. -- Doctor попереджає, коли не налаштовано власника команд. Власник команд — це обліковий запис людини-оператора, якому дозволено виконувати команди лише для власника й схвалювати небезпечні дії. Спарювання через DM лише дає комусь змогу говорити з ботом; якщо ви схвалили відправника до появи bootstrap першого власника, явно встановіть `commands.ownerAllowFrom`. -- Doctor попереджає, коли налаштовані агенти в режимі Codex і в Codex home оператора існують особисті ресурси Codex CLI. Локальні запуски app-server Codex використовують ізольовані home для кожного агента, тому використовуйте `openclaw migrate codex --dry-run`, щоб інвентаризувати ресурси, які слід свідомо просунути. -- Doctor попереджає, коли skills, дозволені для типового агента, недоступні в поточному середовищі виконання, бо відсутні bins, env vars, config або вимоги ОС. `doctor --fix` може вимкнути ці недоступні skills за допомогою `skills.entries..enabled=false`; натомість встановіть/налаштуйте відсутню вимогу, коли хочете зберегти skill активним. -- Якщо sandbox mode увімкнено, але Docker недоступний, doctor повідомляє попередження з високим сигналом і способом виправлення (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`). -- Якщо `gateway.auth.token`/`gateway.auth.password` керуються SecretRef і недоступні в поточному шляху команди, doctor повідомляє попередження лише для читання й не записує fallback облікові дані у plaintext. -- Якщо перевірка SecretRef каналу завершується невдало в шляху виправлення, doctor продовжує роботу й повідомляє попередження замість раннього завершення. +- Інтерактивні запити (наприклад, виправлення 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` і безголові запуски залишають їх на місці. +- 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 повідомляє попередження й пропускає автоматичне розпізнавання для цього проходження. +- Автоматичне розв’язання імен користувачів 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 @@ -81,7 +82,7 @@ launchctl unsetenv OPENCLAW_GATEWAY_TOKEN launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD ``` -## Пов’язане +## Пов’язано - [Довідник CLI](/uk/cli) - [Gateway doctor](/uk/gateway/doctor) diff --git a/docs/uk/cli/sandbox.md b/docs/uk/cli/sandbox.md index 82168ef14..a01cf08fb 100644 --- a/docs/uk/cli/sandbox.md +++ b/docs/uk/cli/sandbox.md @@ -1,40 +1,40 @@ --- read_when: You are managing sandbox runtimes or debugging sandbox/tool-policy behavior. status: active -summary: Керуйте середовищами виконання пісочниці та перевіряйте ефективну політику пісочниці +summary: Керуйте середовищами виконання пісочниці та перевіряйте діючу політику пісочниці title: CLI пісочниці x-i18n: - generated_at: "2026-04-27T04:33:47Z" - model: gpt-5.4 + generated_at: "2026-05-03T12:29:47Z" + model: gpt-5.5 provider: openai - source_hash: 65520040611ccf0cfc28b28f0caf2ed1c7d3b32de06eec7884131042bba4a01e + source_hash: c50b97c35ba8cd79416de6a167a7cbc313d063b320db7deafd42f7a570e507ac source_path: cli/sandbox.md - workflow: 15 + workflow: 16 --- -Керуйте середовищами виконання пісочниці для ізольованого виконання агентів. +Керуйте середовищами виконання sandbox для ізольованого виконання агентів. ## Огляд -OpenClaw може запускати агентів в ізольованих середовищах виконання пісочниці для безпеки. Команди `sandbox` допомагають перевіряти та перевідтворювати ці середовища після оновлень або змін конфігурації. +OpenClaw може запускати агентів в ізольованих середовищах виконання sandbox для безпеки. Команди `sandbox` допомагають перевіряти та перестворювати ці середовища після оновлень або змін конфігурації. Сьогодні це зазвичай означає: -- контейнери пісочниці Docker -- середовища виконання пісочниці SSH, коли `agents.defaults.sandbox.backend = "ssh"` -- середовища виконання пісочниці OpenShell, коли `agents.defaults.sandbox.backend = "openshell"` +- Контейнери Docker sandbox +- Середовища виконання SSH sandbox, коли `agents.defaults.sandbox.backend = "ssh"` +- Середовища виконання OpenShell sandbox, коли `agents.defaults.sandbox.backend = "openshell"` -Для `ssh` і OpenShell `remote` перевідтворення важливіше, ніж для Docker: +Для `ssh` і OpenShell `remote` перестворення важливіше, ніж для Docker: -- віддалений робочий простір є канонічним після початкового заповнення +- віддалений робочий простір є канонічним після початкового наповнення - `openclaw sandbox recreate` видаляє цей канонічний віддалений робочий простір для вибраної області -- під час наступного використання він знову заповнюється з поточного локального робочого простору +- наступне використання знову наповнює його з поточного локального робочого простору ## Команди ### `openclaw sandbox explain` -Перевіряє **ефективний** режим/область/доступ до робочого простору пісочниці, політику інструментів пісочниці та шлюзи підвищення прав (із шляхами до ключів конфігурації для виправлення). +Перевірте **ефективні** режим/область/доступ до робочого простору sandbox, політику інструментів sandbox і gates для підвищених прав (із шляхами ключів конфігурації для виправлення). ```bash openclaw sandbox explain @@ -45,76 +45,76 @@ openclaw sandbox explain --json ### `openclaw sandbox list` -Показує список усіх середовищ виконання пісочниці з їхнім станом і конфігурацією. +Перелічує всі середовища виконання sandbox з їхнім станом і конфігурацією. ```bash openclaw sandbox list -openclaw sandbox list --browser # Показати лише контейнери браузера -openclaw sandbox list --json # Вивід JSON +openclaw sandbox list --browser # List only browser containers +openclaw sandbox list --json # JSON output ``` **Вивід містить:** -- назву середовища виконання та стан -- бекенд (`docker`, `openshell` тощо) -- мітку конфігурації та інформацію про те, чи відповідає вона поточній конфігурації -- вік (час від створення) -- час простою (час від останнього використання) -- пов’язаний сеанс/агент +- Назву середовища виконання та стан +- Backend (`docker`, `openshell` тощо) +- Мітку конфігурації та чи відповідає вона поточній конфігурації +- Вік (час від створення) +- Час простою (час від останнього використання) +- Пов’язану сесію/агента ### `openclaw sandbox recreate` -Видаляє середовища виконання пісочниці, щоб примусово створити їх заново з оновленою конфігурацією. +Видаліть середовища виконання sandbox, щоб примусово перестворити їх з оновленою конфігурацією. ```bash -openclaw sandbox recreate --all # Перевідтворити всі контейнери -openclaw sandbox recreate --session main # Конкретний сеанс -openclaw sandbox recreate --agent mybot # Конкретний агент -openclaw sandbox recreate --browser # Лише контейнери браузера -openclaw sandbox recreate --all --force # Пропустити підтвердження +openclaw sandbox recreate --all # Recreate all containers +openclaw sandbox recreate --session main # Specific session +openclaw sandbox recreate --agent mybot # Specific agent +openclaw sandbox recreate --browser # Only browser containers +openclaw sandbox recreate --all --force # Skip confirmation ``` **Параметри:** -- `--all`: перевідтворити всі контейнери пісочниці -- `--session `: перевідтворити контейнер для конкретного сеансу -- `--agent `: перевідтворити контейнери для конкретного агента -- `--browser`: перевідтворити лише контейнери браузера -- `--force`: пропустити запит на підтвердження +- `--all`: перестворити всі контейнери sandbox +- `--session `: перестворити контейнер для певної сесії +- `--agent `: перестворити контейнери для певного агента +- `--browser`: перестворити лише браузерні контейнери +- `--force`: пропустити запит підтвердження -Середовища виконання автоматично створюються знову під час наступного використання агента. +Середовища виконання автоматично перестворюються під час наступного використання агента. -## Випадки використання +## Варіанти використання ### Після оновлення образу Docker ```bash -# Завантажити новий образ +# Pull new image docker pull openclaw-sandbox:latest docker tag openclaw-sandbox:latest openclaw-sandbox:bookworm-slim -# Оновити конфігурацію для використання нового образу -# Відредагуйте конфігурацію: agents.defaults.sandbox.docker.image (або agents.list[].sandbox.docker.image) +# Update config to use new image +# Edit config: agents.defaults.sandbox.docker.image (or agents.list[].sandbox.docker.image) -# Перевідтворити контейнери +# Recreate containers openclaw sandbox recreate --all ``` -### Після зміни конфігурації пісочниці +### Після зміни конфігурації sandbox ```bash -# Відредагуйте конфігурацію: agents.defaults.sandbox.* (або agents.list[].sandbox.*) +# Edit config: agents.defaults.sandbox.* (or agents.list[].sandbox.*) -# Перевідтворіть, щоб застосувати нову конфігурацію +# Recreate to apply new config openclaw sandbox recreate --all ``` ### Після зміни цілі SSH або матеріалів автентифікації SSH ```bash -# Відредагуйте конфігурацію: +# Edit config: # - agents.defaults.sandbox.backend # - agents.defaults.sandbox.ssh.target # - agents.defaults.sandbox.ssh.workspaceRoot @@ -124,13 +124,12 @@ openclaw sandbox recreate --all openclaw sandbox recreate --all ``` -Для основного бекенда `ssh` перевідтворення видаляє кореневий каталог віддаленого робочого простору для кожної області -на цілі SSH. Під час наступного запуску він знову заповнюється з локального робочого простору. +Для основного backend `ssh` перестворення видаляє корінь віддаленого робочого простору для кожної області на цілі SSH. Наступний запуск знову наповнює його з локального робочого простору. ### Після зміни джерела, політики або режиму OpenShell ```bash -# Відредагуйте конфігурацію: +# Edit config: # - agents.defaults.sandbox.backend # - plugins.entries.openshell.config.from # - plugins.entries.openshell.config.mode @@ -139,41 +138,49 @@ openclaw sandbox recreate --all openclaw sandbox recreate --all ``` -Для режиму OpenShell `remote` перевідтворення видаляє канонічний віддалений робочий простір -для цієї області. Під час наступного запуску він знову заповнюється з локального робочого простору. +Для режиму OpenShell `remote` перестворення видаляє канонічний віддалений робочий простір для цієї області. Наступний запуск знову наповнює його з локального робочого простору. ### Після зміни setupCommand ```bash openclaw sandbox recreate --all -# або лише для одного агента: +# or just one agent: openclaw sandbox recreate --agent family ``` -### Лише для конкретного агента +### Лише для певного агента ```bash -# Оновити контейнери лише одного агента +# Update only one agent's containers openclaw sandbox recreate --agent alfred ``` ## Навіщо це потрібно -Коли ви оновлюєте конфігурацію пісочниці: +Коли ви оновлюєте конфігурацію sandbox: -- наявні середовища виконання продовжують працювати зі старими параметрами -- середовища виконання очищаються лише після 24 годин неактивності -- агенти, які регулярно використовуються, можуть зберігати старі середовища виконання необмежено довго +- Наявні середовища виконання продовжують працювати зі старими налаштуваннями. +- Середовища виконання очищаються лише після 24 годин неактивності. +- Агенти, які використовуються регулярно, утримують старі середовища виконання живими безстроково. -Використовуйте `openclaw sandbox recreate`, щоб примусово видалити старі середовища виконання. Вони автоматично створюються знову з поточними параметрами, коли знадобляться наступного разу. +Використовуйте `openclaw sandbox recreate`, щоб примусово видалити старі середовища виконання. Вони автоматично перестворюються з поточними налаштуваннями, коли знову знадобляться. -Надавайте перевагу `openclaw sandbox recreate` замість ручного очищення, специфічного для конкретного бекенда. Ця команда використовує реєстр середовищ виконання Gateway і допомагає уникнути невідповідностей, коли змінюються область або ключі сеансу. +Надавайте перевагу `openclaw sandbox recreate` замість ручного очищення, специфічного для backend. Він використовує реєстр середовищ виконання Gateway і уникає невідповідностей, коли змінюються ключі області або сесії. +## Міграція реєстру + +OpenClaw зберігає метадані середовища виконання sandbox як один JSON-фрагмент на кожен запис контейнера/браузера в каталозі стану sandbox. Старі встановлення все ще можуть мати монолітні застарілі файли: + +- `~/.openclaw/sandbox/containers.json` +- `~/.openclaw/sandbox/browsers.json` + +Звичайні читання середовища виконання sandbox не перезаписують ці файли. Запустіть `openclaw doctor --fix`, щоб перенести чинні застарілі записи до каталогів фрагментованого реєстру. Нечинні застарілі файли ізолюються, щоб один поганий старий реєстр не міг приховати поточні записи середовища виконання. + ## Конфігурація -Параметри пісочниці містяться в `~/.openclaw/openclaw.json` у розділі `agents.defaults.sandbox` (перевизначення для окремих агентів містяться в `agents.list[].sandbox`): +Налаштування sandbox містяться в `~/.openclaw/openclaw.json` під `agents.defaults.sandbox` (перевизначення для окремих агентів розміщуються в `agents.list[].sandbox`): ```jsonc { @@ -186,11 +193,11 @@ openclaw sandbox recreate --agent alfred "docker": { "image": "openclaw-sandbox:bookworm-slim", "containerPrefix": "openclaw-sbx-", - // ... інші параметри Docker + // ... more Docker options }, "prune": { - "idleHours": 24, // Автоматичне очищення після 24 год простою - "maxAgeDays": 7, // Автоматичне очищення через 7 днів + "idleHours": 24, // Auto-prune after 24h idle + "maxAgeDays": 7, // Auto-prune after 7 days }, }, }, @@ -201,6 +208,6 @@ openclaw sandbox recreate --agent alfred ## Пов’язане - [Довідник CLI](/uk/cli) -- [Пісочниця](/uk/gateway/sandboxing) +- [Sandboxing](/uk/gateway/sandboxing) - [Робочий простір агента](/uk/concepts/agent-workspace) -- [Doctor](/uk/gateway/doctor): перевіряє налаштування пісочниці. +- [Doctor](/uk/gateway/doctor): перевіряє налаштування sandbox.