openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-03 12:30:35 +00:00
parent 1ce4c9b3b8
commit 4db903fda4
2 changed files with 109 additions and 101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
docs/uk/cli/doctor.md
View File

@ -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.<timestamp>` потребує інтерактивного підтвердження; `--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.<id>` і видаляючи його недійсний 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.<provider>`.
- Повторні запуски `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.<skill>.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.<timestamp>` потребує інтерактивного підтвердження; `--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.<id>` і видаляючи його недійсне корисне навантаження `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.<provider>`.
- Повторні запуски `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.<skill>.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)

135
docs/uk/cli/sandbox.md
View File

@ -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 <key>`: перевідтворити контейнер для конкретного сеансу
- `--agent <id>`: перевідтворити контейнери для конкретного агента
- `--browser`: перевідтворити лише контейнери браузера
- `--force`: пропустити запит на підтвердження
- `--all`: перестворити всі контейнери sandbox
- `--session <key>`: перестворити контейнер для певної сесії
- `--agent <id>`: перестворити контейнери для певного агента
- `--browser`: перестворити лише браузерні контейнери
- `--force`: пропустити запит підтвердження
<Note>
Середовища виконання автоматично створюються знову під час наступного використання агента.
Середовища виконання автоматично перестворюються під час наступного використання агента.
</Note>
## Випадки використання
## Варіанти використання
### Після оновлення образу 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`, щоб примусово видалити старі середовища виконання. Вони автоматично перестворюються з поточними налаштуваннями, коли знову знадобляться.
<Tip>
Надавайте перевагу `openclaw sandbox recreate` замість ручного очищення, специфічного для конкретного бекенда. Ця команда використовує реєстр середовищ виконання Gateway і допомагає уникнути невідповідностей, коли змінюються область або ключі сеансу.
Надавайте перевагу `openclaw sandbox recreate` замість ручного очищення, специфічного для backend. Він використовує реєстр середовищ виконання Gateway і уникає невідповідностей, коли змінюються ключі області або сесії.
</Tip>
## Міграція реєстру
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.