diff --git a/docs/uk/install/updating.md b/docs/uk/install/updating.md index dd2c4e7a8..68c1cf8d8 100644 --- a/docs/uk/install/updating.md +++ b/docs/uk/install/updating.md @@ -1,14 +1,14 @@ --- read_when: - Оновлення OpenClaw - - Після оновлення щось зламалося -summary: Безпечне оновлення OpenClaw (глобальне встановлення або з джерела), а також стратегія відкату + - Щось ламається після оновлення +summary: Безпечне оновлення OpenClaw (глобальне встановлення або з вихідного коду), а також стратегія відкату title: Оновлення x-i18n: - generated_at: "2026-04-06T00:47:29Z" + generated_at: "2026-04-22T04:04:21Z" model: gpt-5.4 provider: openai - source_hash: ca9fff0776b9f5977988b649e58a5d169e5fa3539261cb02779d724d4ca92877 + source_hash: 6ab2b515457c64d24c830e2e1678d9fefdcf893e0489f0d99b039db3b877b3c4 source_path: install/updating.md workflow: 15 --- @@ -19,13 +19,13 @@ x-i18n: ## Рекомендовано: `openclaw update` -Найшвидший спосіб оновлення. Він визначає тип вашого встановлення (npm або git), отримує найновішу версію, запускає `openclaw doctor` і перезапускає шлюз. +Найшвидший спосіб оновлення. Команда визначає тип вашого встановлення (npm або git), отримує найновішу версію, запускає `openclaw doctor` і перезапускає Gateway. ```bash openclaw update ``` -Щоб перемкнути канал або вибрати конкретну версію: +Щоб перемкнути канали або вказати конкретну версію: ```bash openclaw update --channel beta @@ -33,17 +33,17 @@ openclaw update --tag main openclaw update --dry-run # попередній перегляд без застосування ``` -`--channel beta` надає перевагу beta, але середовище виконання повертається до stable/latest, якщо тег beta відсутній або старіший за найновіший стабільний випуск. Використовуйте `--tag beta`, якщо хочете використати необроблений npm dist-tag beta для одноразового оновлення пакета. +`--channel beta` надає перевагу beta, але середовище виконання повертається до stable/latest, якщо тег beta відсутній або старіший за найновіший стабільний випуск. Використовуйте `--tag beta`, якщо вам потрібен сирий npm dist-tag beta для одноразового оновлення пакета. -Дивіться [Канали розробки](/uk/install/development-channels), щоб дізнатися про семантику каналів. +Перегляньте [Канали розробки](/uk/install/development-channels) щодо семантики каналів. -## Альтернатива: повторно запустити інсталятор +## Альтернатива: повторно запустіть інсталятор ```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` -Додайте `--no-onboard`, щоб пропустити онбординг. Для встановлень із джерела передайте `--install-method git --no-onboard`. +Додайте `--no-onboard`, щоб пропустити початкове налаштування. Для встановлень з вихідного коду передайте `--install-method git --no-onboard`. ## Альтернатива: вручну через npm, pnpm або bun @@ -59,9 +59,22 @@ pnpm add -g openclaw@latest bun add -g openclaw@latest ``` +### Глобальні встановлення npm, що належать root + +Деякі конфігурації npm у Linux встановлюють глобальні пакети в каталоги, що належать root, наприклад `/usr/lib/node_modules/openclaw`. OpenClaw підтримує таку схему: встановлений пакет розглядається як доступний лише для читання під час виконання, а залежності середовища виконання вбудованих Plugin розміщуються в доступному для запису каталозі середовища виконання замість зміни дерева пакета. + +Для захищених модулів systemd задайте доступний для запису каталог staging, включений до `ReadWritePaths`: + +```ini +Environment=OPENCLAW_PLUGIN_STAGE_DIR=/var/lib/openclaw/plugin-runtime-deps +ReadWritePaths=/var/lib/openclaw /home/openclaw/.openclaw /tmp +``` + +Якщо `OPENCLAW_PLUGIN_STAGE_DIR` не задано, OpenClaw використовує `$STATE_DIRECTORY`, якщо його надає systemd, а потім повертається до `~/.openclaw/plugin-runtime-deps`. + ## Автооновлювач -Автооновлювач вимкнено за замовчуванням. Увімкніть його в `~/.openclaw/openclaw.json`: +Автооновлювач за замовчуванням вимкнений. Увімкніть його в `~/.openclaw/openclaw.json`: ```json5 { @@ -77,13 +90,13 @@ bun add -g openclaw@latest } ``` -| Канал | Поведінка | -| -------- | ------------------------------------------------------------------------------------------------------------- | -| `stable` | Очікує `stableDelayHours`, потім застосовує з детермінованим зсувом у межах `stableJitterHours` (поетапне розгортання). | -| `beta` | Перевіряє кожні `betaCheckIntervalHours` (типово: щогодини) і застосовує негайно. | -| `dev` | Без автоматичного застосування. Використовуйте `openclaw update` вручну. | +| Канал | Поведінка | +| -------- | -------------------------------------------------------------------------------------------------------------- | +| `stable` | Чекає `stableDelayHours`, потім застосовує з детермінованим jitter у межах `stableJitterHours` (поступове розгортання). | +| `beta` | Перевіряє кожні `betaCheckIntervalHours` (типово: щогодини) і застосовує негайно. | +| `dev` | Автоматичне застосування відсутнє. Використовуйте `openclaw update` вручну. | -Шлюз також записує підказку про оновлення під час запуску (вимикається через `update.checkOnStart: false`). +Gateway також записує підказку про оновлення під час запуску (вимкнути можна через `update.checkOnStart: false`). ## Після оновлення @@ -95,9 +108,9 @@ bun add -g openclaw@latest openclaw doctor ``` -Мігрує конфігурацію, перевіряє політики DM і перевіряє стан шлюзу. Докладніше: [Doctor](/uk/gateway/doctor) +Мігрує конфігурацію, перевіряє політики DM і стан Gateway. Докладніше: [Doctor](/uk/gateway/doctor) -### Перезапустіть шлюз +### Перезапустіть Gateway ```bash openclaw gateway restart @@ -113,7 +126,7 @@ openclaw health ## Відкат -### Зафіксувати версію (npm) +### Зафіксуйте версію (npm) ```bash npm i -g openclaw@ @@ -123,7 +136,7 @@ openclaw gateway restart Порада: `npm view openclaw version` показує поточну опубліковану версію. -### Зафіксувати коміт (джерело) +### Зафіксуйте коміт (вихідний код) ```bash git fetch origin @@ -134,15 +147,15 @@ openclaw gateway restart Щоб повернутися до найновішої версії: `git checkout main && git pull`. -## Якщо ви зайшли в глухий кут +## Якщо ви не можете просунутися далі - Знову запустіть `openclaw doctor` і уважно прочитайте вивід. -- Для `openclaw update --channel dev` у checkout із джерела оновлювач автоматично завантажує `pnpm`, якщо це потрібно. Якщо ви бачите помилку початкового налаштування pnpm/corepack, встановіть `pnpm` вручну (або знову ввімкніть `corepack`) і повторно запустіть оновлення. -- Дивіться: [Усунення несправностей](/uk/gateway/troubleshooting) +- Для `openclaw update --channel dev` у checkout з вихідного коду засіб оновлення автоматично виконує початкове налаштування `pnpm`, якщо потрібно. Якщо ви бачите помилку початкового налаштування pnpm/corepack, установіть `pnpm` вручну (або знову увімкніть `corepack`) і повторно запустіть оновлення. +- Перевірте: [Усунення несправностей](/uk/gateway/troubleshooting) - Запитайте в Discord: [https://discord.gg/clawd](https://discord.gg/clawd) ## Пов’язане - [Огляд встановлення](/uk/install) — усі способи встановлення - [Doctor](/uk/gateway/doctor) — перевірки стану після оновлень -- [Міграція](/uk/install/migrating) — посібники з міграції для основних версій +- [Міграція](/uk/install/migrating) — посібники з міграції між основними версіями