chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
86cf0e4bed
commit
cf0ccfbdc7
@ -1,23 +1,23 @@
|
||||
---
|
||||
read_when:
|
||||
- У вас виникли проблеми з підключенням або автентифікацією, і вам потрібні покрокові виправлення
|
||||
- Ви оновилися й хочете виконати базову перевірку
|
||||
summary: Довідник CLI для `openclaw doctor` (перевірки справності + керовані виправлення)
|
||||
- У вас проблеми з підключенням чи автентифікацією, і ви хочете покроково усунути їх
|
||||
- Ви оновили й хочете швидку перевірку
|
||||
summary: Довідка CLI для `openclaw doctor` (перевірки працездатності + керовані виправлення)
|
||||
title: Діагностика
|
||||
x-i18n:
|
||||
generated_at: "2026-05-01T21:50:48Z"
|
||||
generated_at: "2026-05-02T03:33:34Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 8b15e5e5d062ae3e6f236775567b098d57ea6518171c0d45c78cab5b985e215e
|
||||
source_hash: e861fa105737088eafa55815faa1a37ccd61e154e8dbe811cf4b988bc1c571e5
|
||||
source_path: cli/doctor.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
# `openclaw doctor`
|
||||
|
||||
Перевірки стану + швидкі виправлення для Gateway і каналів.
|
||||
Перевірки справності + швидкі виправлення для Gateway і каналів.
|
||||
|
||||
Пов’язане:
|
||||
Пов’язано:
|
||||
|
||||
- Усунення несправностей: [Усунення несправностей](/uk/gateway/troubleshooting)
|
||||
- Аудит безпеки: [Безпека](/uk/gateway/security)
|
||||
@ -34,42 +34,43 @@ openclaw doctor --generate-gateway-token
|
||||
|
||||
## Параметри
|
||||
|
||||
- `--no-workspace-suggestions`: вимкнути пропозиції пам’яті/пошуку робочої області
|
||||
- `--yes`: приймати типові значення без запиту
|
||||
- `--repair`: застосувати рекомендовані виправлення, не пов’язані зі службами, без запиту; встановлення та перезапис служб Gateway усе ще потребують інтерактивного підтвердження або явних команд Gateway
|
||||
- `--no-workspace-suggestions`: вимкнути підказки пам’яті/пошуку робочого простору
|
||||
- `--yes`: приймати типові значення без запитів
|
||||
- `--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, щоб безголові перевірки стану залишалися швидкими. Інтерактивні сеанси все одно повністю завантажують Plugin, коли перевірці потрібен їхній внесок.
|
||||
- `--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 і може перезаписати їх на місці до того, як scheduler муситиме автоматично нормалізувати їх під час виконання.
|
||||
- У Linux doctor попереджає, коли crontab користувача все ще запускає застарілий `~/.openclaw/bin/ensure-whatsapp.sh`; цей скрипт більше не підтримується й може реєструвати хибні збої Gateway WhatsApp, коли cron не має середовища user-bus systemd.
|
||||
- Doctor очищає застарілий проміжний стан залежностей Plugin, створений старішими версіями OpenClaw. Він також відновлює відсутні налаштовані завантажувані Plugin, коли реєстр може їх розв’язати.
|
||||
- Doctor виправляє застарілу конфігурацію Plugin, видаляючи відсутні ідентифікатори Plugin із `plugins.allow`/`plugins.entries`, а також відповідну висячу конфігурацію каналів, цілі Heartbeat і перевизначення моделей каналів, коли виявлення Plugin працює коректно.
|
||||
- Doctor поміщає недійсну конфігурацію Plugin у карантин, вимикаючи відповідний запис `plugins.entries.<id>` і видаляючи його недійсний payload `config`. Запуск Gateway уже пропускає лише цей несправний Plugin, тож інші Plugin і канали можуть продовжувати працювати.
|
||||
- Установіть `OPENCLAW_SERVICE_REPAIR_POLICY=external`, коли інший supervisor керує життєвим циклом Gateway. Doctor і далі повідомляє про стан Gateway/служби та застосовує виправлення, не пов’язані зі службами, але пропускає встановлення/запуск/перезапуск/bootstrap служби та очищення застарілих служб.
|
||||
- У Linux doctor ігнорує неактивні додаткові systemd units, схожі на Gateway, і не перезаписує метадані команди/entrypoint для запущеної служби Gateway systemd під час виправлення. Спершу зупиніть службу або використайте `openclaw gateway install --force`, коли навмисно хочете замінити активний launcher.
|
||||
- Doctor автоматично мігрує застарілу пласку конфігурацію Talk (`talk.voiceId`, `talk.modelId` і пов’язані ключі) у `talk.provider` + `talk.providers.<provider>`.
|
||||
- Інтерактивні запити (наприклад, виправлення keychain/OAuth) запускаються лише тоді, коли stdin є TTY і `--non-interactive` **не** задано. Запуски без інтерфейсу (cron, Telegram, без термінала) пропускатимуть запити.
|
||||
- Продуктивність: неінтерактивні запуски `doctor` пропускають завчасне завантаження Plugin, щоб перевірки справності без інтерфейсу залишалися швидкими. Інтерактивні сеанси й надалі повністю завантажують Plugin, коли перевірці потрібен їхній внесок.
|
||||
- `--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.
|
||||
- Doctor очищує застарілий проміжний стан залежностей Plugin, створений старішими версіями OpenClaw. Він також виправляє відсутні налаштовані завантажувані Plugin, коли реєстр може їх розв’язати.
|
||||
- Doctor виправляє застарілу конфігурацію Plugin, вилучаючи відсутні ідентифікатори Plugin з `plugins.allow`/`plugins.entries`, а також відповідні завислі конфігурації каналів, цілі Heartbeat і перевизначення моделей каналів, коли виявлення Plugin працює справно.
|
||||
- Doctor поміщає недійсну конфігурацію Plugin у карантин, вимикаючи відповідний запис `plugins.entries.<id>` і вилучаючи його недійсне навантаження `config`. Запуск Gateway уже пропускає лише цей несправний Plugin, тож інші Plugin і канали можуть продовжувати працювати.
|
||||
- Задайте `OPENCLAW_SERVICE_REPAIR_POLICY=external`, коли інший supervisor керує життєвим циклом Gateway. Doctor і надалі повідомляє про справність Gateway/сервісу та застосовує виправлення, не пов’язані із сервісами, але пропускає встановлення/запуск/перезапуск/bootstrap сервісу й очищення застарілих сервісів.
|
||||
- На Linux doctor ігнорує неактивні додаткові systemd-юніти, схожі на Gateway, і не перезаписує метадані команди/точки входу для запущеного 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`, коли відсутні облікові дані embeddings.
|
||||
- Doctor попереджає, коли не налаштовано власника команд. Власник команд — це обліковий запис оператора-людини, якому дозволено запускати команди лише для власника та схвалювати небезпечні дії. Сполучення через DM лише дозволяє комусь спілкуватися з ботом; якщо ви схвалили відправника до появи bootstrap першого власника, задайте `commands.ownerAllowFrom` явно.
|
||||
- Doctor попереджає, коли налаштовано агентів у режимі Codex і в Codex home оператора існують особисті ресурси Codex CLI. Локальні запуски app-server Codex використовують ізольовані home для кожного агента, тому використовуйте `openclaw migrate codex --dry-run`, щоб інвентаризувати ресурси, які слід просувати свідомо.
|
||||
- Якщо режим sandbox увімкнено, але Docker недоступний, doctor повідомляє високосигнальне попередження з remediation (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`).
|
||||
- Якщо `gateway.auth.token`/`gateway.auth.password` керуються SecretRef і недоступні в поточному шляху команди, doctor повідомляє попередження лише для читання й не записує plaintext fallback credentials.
|
||||
- Doctor включає перевірку готовності пошуку в пам’яті та може рекомендувати `openclaw configure --section model`, коли відсутні облікові дані embedding.
|
||||
- Doctor попереджає, коли не налаштовано власника команд. Власник команд — це обліковий запис оператора-людини, якому дозволено запускати команди лише для власника та схвалювати небезпечні дії. Спарювання DM лише дає змогу комусь спілкуватися з ботом; якщо ви схвалили відправника до появи bootstrap першого власника, задайте `commands.ownerAllowFrom` явно.
|
||||
- Doctor попереджає, коли налаштовано агентів у режимі Codex і в Codex home оператора існують особисті ресурси Codex CLI. Локальні запуски сервера застосунку Codex використовують ізольовані домівки для кожного агента, тому використовуйте `openclaw migrate codex --dry-run`, щоб інвентаризувати ресурси, які слід свідомо підвищити.
|
||||
- Якщо режим sandbox увімкнено, але Docker недоступний, doctor повідомляє високосигнальне попередження з усуненням (`install Docker` або `openclaw config set agents.defaults.sandbox.mode off`).
|
||||
- Якщо `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
|
||||
@ -79,7 +80,7 @@ launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
|
||||
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD
|
||||
```
|
||||
|
||||
## Пов’язане
|
||||
## Пов’язано
|
||||
|
||||
- [Довідник CLI](/uk/cli)
|
||||
- [Gateway doctor](/uk/gateway/doctor)
|
||||
- [Doctor Gateway](/uk/gateway/doctor)
|
||||
|
||||
@ -1,55 +1,55 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви переносите OpenClaw на новий ноутбук або сервер
|
||||
- Ви переходите з іншої системи агентів і хочете зберегти стан
|
||||
- Ви переходите з іншої агентної системи й хочете зберегти стан
|
||||
- Ви оновлюєте Plugin на місці
|
||||
summary: 'Центр міграції: імпорт між системами, перенесення між машинами та оновлення плагінів'
|
||||
title: Посібник з міграції
|
||||
summary: 'Центр міграції: міжсистемні імпорти, перенесення між машинами та оновлення Plugin'
|
||||
title: Посібник із міграції
|
||||
x-i18n:
|
||||
generated_at: "2026-04-27T11:00:16Z"
|
||||
model: gpt-5.4
|
||||
generated_at: "2026-05-02T03:33:41Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: e2a1dc86ed367a0b92cdc0d5189123bb045d327be944516f564dac723f324c97
|
||||
source_hash: e447e38cf0086603a7b30ee5204e63cc8227ebc7a56add26d06ac2798a23e26f
|
||||
source_path: install/migrating.md
|
||||
workflow: 15
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
OpenClaw підтримує три шляхи міграції: імпорт з іншої системи агентів, перенесення наявної інсталяції на нову машину та оновлення Plugin на місці.
|
||||
OpenClaw підтримує три шляхи міграції: імпорт з іншої агентної системи, перенесення наявного встановлення на нову машину та оновлення Plugin на місці.
|
||||
|
||||
## Імпорт з іншої системи агентів
|
||||
## Імпорт з іншої агентної системи
|
||||
|
||||
Використовуйте вбудовані провайдери міграції, щоб перенести інструкції, MCP-сервери, Skills, конфігурацію моделей і (за бажанням) API-ключі до OpenClaw. Плани переглядаються перед будь-якими змінами, секрети редагуються у звітах, а apply захищено перевіреною резервною копією.
|
||||
Використовуйте вбудовані постачальники міграції, щоб перенести інструкції, сервери MCP, Skills, конфігурацію моделі та (за згодою) ключі API до OpenClaw. Плани попередньо показуються перед будь-якою зміною, секрети редагуються у звітах, а застосування підкріплене перевіреною резервною копією.
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Міграція з Claude" href="/uk/install/migrating-claude" icon="brain">
|
||||
Імпортуйте стан Claude Code і Claude Desktop, зокрема `CLAUDE.md`, MCP-сервери, skills і команди проєкту.
|
||||
Імпортуйте стан Claude Code і Claude Desktop, зокрема `CLAUDE.md`, сервери MCP, Skills і команди проєкту.
|
||||
</Card>
|
||||
<Card title="Міграція з Hermes" href="/uk/install/migrating-hermes" icon="feather">
|
||||
Імпортуйте конфігурацію Hermes, providers, MCP-сервери, пам’ять, skills і підтримувані ключі `.env`.
|
||||
Імпортуйте конфігурацію Hermes, постачальників, сервери MCP, пам’ять, Skills і підтримувані ключі `.env`.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
Точка входу CLI — [`openclaw migrate`](/uk/cli/migrate). Онбординг також може запропонувати міграцію, коли виявляє відоме джерело (`openclaw onboard --flow import`).
|
||||
Точка входу CLI — [`openclaw migrate`](/uk/cli/migrate). Під час онбордингу також може бути запропонована міграція, якщо виявлено відоме джерело (`openclaw onboard --flow import`).
|
||||
|
||||
## Перенесення OpenClaw на нову машину
|
||||
|
||||
Скопіюйте **каталог стану** (типово `~/.openclaw/`) і ваш **робочий простір**, щоб зберегти:
|
||||
Скопіюйте **каталог стану** (`~/.openclaw/` за замовчуванням) і ваш **робочий простір**, щоб зберегти:
|
||||
|
||||
- **Конфігурацію** — `openclaw.json` і всі налаштування Gateway.
|
||||
- **Автентифікацію** — `auth-profiles.json` для кожного агента (API-ключі та OAuth), а також будь-який стан каналу або provider-а в `credentials/`.
|
||||
- **Автентифікацію** — `auth-profiles.json` для кожного агента (ключі API плюс OAuth), а також будь-який стан каналу або постачальника в `credentials/`.
|
||||
- **Сесії** — історію розмов і стан агента.
|
||||
- **Стан каналу** — вхід WhatsApp, сесію Telegram тощо.
|
||||
- **Файли робочого простору** — `MEMORY.md`, `USER.md`, Skills і промпти.
|
||||
|
||||
<Tip>
|
||||
Виконайте `openclaw status` на старій машині, щоб підтвердити шлях до вашого каталогу стану. Користувацькі профілі використовують `~/.openclaw-<profile>/` або шлях, заданий через `OPENCLAW_STATE_DIR`.
|
||||
Запустіть `openclaw status` на старій машині, щоб підтвердити шлях до каталогу стану. Користувацькі профілі використовують `~/.openclaw-<profile>/` або шлях, заданий через `OPENCLAW_STATE_DIR`.
|
||||
</Tip>
|
||||
|
||||
### Кроки міграції
|
||||
|
||||
<Steps>
|
||||
<Step title="Зупиніть gateway і створіть резервну копію">
|
||||
На **старій** машині зупиніть gateway, щоб файли не змінювалися під час копіювання, а потім архівуйте:
|
||||
<Step title="Зупиніть Gateway і створіть резервну копію">
|
||||
На **старій** машині зупиніть Gateway, щоб файли не змінювалися під час копіювання, а потім створіть архів:
|
||||
|
||||
```bash
|
||||
openclaw gateway stop
|
||||
@ -57,12 +57,12 @@ OpenClaw підтримує три шляхи міграції: імпорт з
|
||||
tar -czf openclaw-state.tgz .openclaw
|
||||
```
|
||||
|
||||
Якщо ви використовуєте кілька профілів (наприклад, `~/.openclaw-work`), архівуйте кожен окремо.
|
||||
Якщо ви використовуєте кілька профілів (наприклад, `~/.openclaw-work`), заархівуйте кожен окремо.
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Установіть OpenClaw на новій машині">
|
||||
[Установіть](/uk/install) CLI (і Node, якщо потрібно) на новій машині. Нічого страшного, якщо онбординг створить новий `~/.openclaw/`. Ви перезапишете його на наступному кроці.
|
||||
<Step title="Встановіть OpenClaw на новій машині">
|
||||
[Встановіть](/uk/install) CLI (і Node, якщо потрібно) на новій машині. Нічого страшного, якщо онбординг створить свіжий `~/.openclaw/`. Далі ви його перезапишете.
|
||||
</Step>
|
||||
|
||||
<Step title="Скопіюйте каталог стану та робочий простір">
|
||||
@ -73,12 +73,12 @@ OpenClaw підтримує три шляхи міграції: імпорт з
|
||||
tar -xzf openclaw-state.tgz
|
||||
```
|
||||
|
||||
Переконайтеся, що приховані каталоги було включено і що власник файлів збігається з користувачем, який запускатиме gateway.
|
||||
Переконайтеся, що приховані каталоги були включені, а власник файлів відповідає користувачу, який запускатиме Gateway.
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Запустіть doctor і перевірте">
|
||||
На новій машині запустіть [Doctor](/uk/gateway/doctor), щоб застосувати міграції конфігурації та відновити сервіси:
|
||||
На новій машині запустіть [Doctor](/uk/gateway/doctor), щоб застосувати міграції конфігурації та відновити служби:
|
||||
|
||||
```bash
|
||||
openclaw doctor
|
||||
@ -89,48 +89,56 @@ OpenClaw підтримує три шляхи міграції: імпорт з
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Поширені помилки
|
||||
Якщо Telegram або Discord використовує стандартний резервний варіант через env (`TELEGRAM_BOT_TOKEN` або `DISCORD_BOT_TOKEN`), перевірте, що перенесений `.env` у каталозі стану містить ці ключі, не виводячи секретні значення:
|
||||
|
||||
```bash
|
||||
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
|
||||
```
|
||||
|
||||
`openclaw doctor` також попереджає, коли ввімкнений стандартний обліковий запис Telegram або Discord не має налаштованого токена, а відповідна змінна env недоступна процесу doctor.
|
||||
|
||||
### Поширені пастки
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Невідповідність профілю або state-dir">
|
||||
Якщо старий gateway використовував `--profile` або `OPENCLAW_STATE_DIR`, а новий — ні, канали виглядатимуть як розлогінені, а сесії будуть порожніми. Запустіть gateway з **тим самим** профілем або state-dir, який ви перенесли, а потім знову виконайте `openclaw doctor`.
|
||||
<Accordion title="Невідповідність профілю або каталогу стану">
|
||||
Якщо старий Gateway використовував `--profile` або `OPENCLAW_STATE_DIR`, а новий — ні, канали виглядатимуть розлогіненими, а сесії будуть порожніми. Запустіть Gateway із **тим самим** профілем або каталогом стану, який ви перенесли, а потім повторно запустіть `openclaw doctor`.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Копіювання лише openclaw.json">
|
||||
Одного лише файла конфігурації недостатньо. Профілі автентифікації моделей зберігаються в `agents/<agentId>/agent/auth-profiles.json`, а стан каналів і provider-ів — у `credentials/`. Завжди переносіть **увесь** каталог стану.
|
||||
Самого файлу конфігурації недостатньо. Профілі автентифікації моделей зберігаються в `agents/<agentId>/agent/auth-profiles.json`, а стан каналів і постачальників — у `credentials/`. Завжди мігруйте **весь** каталог стану.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Права доступу та власник">
|
||||
Якщо ви копіювали від root або змінили користувача, gateway може не змогти прочитати облікові дані. Переконайтеся, що каталог стану й робочий простір належать користувачеві, який запускає gateway.
|
||||
<Accordion title="Дозволи та власник">
|
||||
Якщо ви копіювали від root або змінили користувача, Gateway може не змогти прочитати облікові дані. Переконайтеся, що каталог стану й робочий простір належать користувачу, який запускає Gateway.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Віддалений режим">
|
||||
Якщо ваш UI вказує на **віддалений** gateway, віддалений хост володіє сесіями та робочим простором. Переносьте сам хост gateway, а не свій локальний ноутбук. Див. [FAQ](/uk/help/faq#where-things-live-on-disk).
|
||||
Якщо ваш UI вказує на **віддалений** Gateway, сесіями та робочим простором володіє віддалений хост. Мігруйте сам хост Gateway, а не свій локальний ноутбук. Див. [FAQ](/uk/help/faq#where-things-live-on-disk).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Секрети в резервних копіях">
|
||||
Каталог стану містить профілі автентифікації, облікові дані каналів та інший стан provider-ів. Зберігайте резервні копії у зашифрованому вигляді, уникайте незахищених каналів передавання та змініть ключі, якщо підозрюєте компрометацію.
|
||||
Каталог стану містить профілі автентифікації, облікові дані каналів та інший стан постачальників. Зберігайте резервні копії зашифрованими, уникайте небезпечних каналів передавання й ротуйте ключі, якщо підозрюєте витік.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
### Контрольний список перевірки
|
||||
|
||||
На новій машині переконайтеся, що:
|
||||
На новій машині підтвердьте:
|
||||
|
||||
- [ ] `openclaw status` показує, що gateway запущено.
|
||||
- [ ] `openclaw status` показує, що Gateway запущено.
|
||||
- [ ] Канали все ще підключені (повторне сполучення не потрібне).
|
||||
- [ ] Інформаційна панель відкривається і показує наявні сесії.
|
||||
- [ ] Панель керування відкривається й показує наявні сесії.
|
||||
- [ ] Файли робочого простору (пам’ять, конфігурації) присутні.
|
||||
|
||||
## Оновлення Plugin на місці
|
||||
|
||||
Оновлення Plugin на місці зберігають той самий id плагіна та ключі конфігурації, але можуть переміщувати стан на диску до поточного компонування. Посібники з оновлення для конкретних плагінів розміщені поруч із їхніми каналами:
|
||||
Оновлення Plugin на місці зберігають той самий ідентифікатор Plugin і ключі конфігурації, але можуть перемістити стан на диску в поточну структуру. Посібники з оновлення для окремих Plugin розміщені поруч із їхніми каналами:
|
||||
|
||||
- [Міграція Matrix](/uk/channels/matrix-migration): обмеження відновлення зашифрованого стану, автоматична поведінка знімків і команди ручного відновлення.
|
||||
- [Міграція Matrix](/uk/channels/matrix-migration): обмеження відновлення зашифрованого стану, поведінка автоматичних знімків і команди ручного відновлення.
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [`openclaw migrate`](/uk/cli/migrate): довідка CLI для імпорту між системами.
|
||||
- [Огляд встановлення](/uk/install): усі способи встановлення.
|
||||
- [Doctor](/uk/gateway/doctor): перевірка стану після міграції.
|
||||
- [Видалення](/uk/install/uninstall): коректне видалення OpenClaw.
|
||||
- [Видалення](/uk/install/uninstall): чисте видалення OpenClaw.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user