chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
0b6a084464
commit
d64d50dd24
File diff suppressed because it is too large
Load Diff
@ -1,47 +1,48 @@
|
||||
---
|
||||
read_when:
|
||||
- Пошук статусу companion app для Linux
|
||||
- Планування покриття платформ або внеску в розробку
|
||||
summary: Підтримка Linux + статус companion app
|
||||
title: Linux App
|
||||
- Шукаю статус супутнього застосунку для Linux
|
||||
- Планування покриття платформ або внесків
|
||||
- Налагодження Linux OOM-kill або коду виходу 137 на VPS чи в контейнері
|
||||
summary: Підтримка Linux + статус супутнього застосунку
|
||||
title: Застосунок Linux
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T18:09:53Z"
|
||||
generated_at: "2026-04-23T04:54:39Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 5dbfc89eb65e04347479fc6c9a025edec902fb0c544fb8d5bd09c24558ea03b1
|
||||
source_hash: c56151406517a1259e66626b8f4b48c16917b10580e7626463afd8a68dc286f7
|
||||
source_path: platforms/linux.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Linux App
|
||||
# Застосунок Linux
|
||||
|
||||
Gateway повністю підтримується на Linux. **Node — рекомендоване runtime-середовище**.
|
||||
Bun не рекомендується для Gateway (помилки WhatsApp/Telegram).
|
||||
Gateway повністю підтримується на Linux. **Node — рекомендоване середовище виконання**.
|
||||
Bun не рекомендується для Gateway (баги WhatsApp/Telegram).
|
||||
|
||||
Нативні companion apps для Linux заплановані. Якщо ви хочете допомогти створити такий застосунок, внески вітаються.
|
||||
Власні супутні застосунки для Linux заплановані. Внески вітаються, якщо ви хочете допомогти створити такий застосунок.
|
||||
|
||||
## Швидкий шлях для початківців (VPS)
|
||||
|
||||
1. Установіть Node 24 (рекомендовано; Node 22 LTS, зараз `22.14+`, також працює для сумісності)
|
||||
1. Встановіть Node 24 (рекомендовано; Node 22 LTS, наразі `22.14+`, усе ще працює для сумісності)
|
||||
2. `npm i -g openclaw@latest`
|
||||
3. `openclaw onboard --install-daemon`
|
||||
4. Із вашого ноутбука: `ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`
|
||||
5. Відкрийте `http://127.0.0.1:18789/` і пройдіть автентифікацію за допомогою налаштованого shared secret (типово token; password, якщо ви встановили `gateway.auth.mode: "password"`)
|
||||
5. Відкрийте `http://127.0.0.1:18789/` і пройдіть автентифікацію за допомогою налаштованого спільного секрету (типово токен; пароль, якщо ви встановили `gateway.auth.mode: "password"`)
|
||||
|
||||
Повний гайд для Linux server: [Linux Server](/vps). Покроковий приклад VPS: [exe.dev](/install/exe-dev)
|
||||
Повний посібник із Linux Server: [Linux Server](/uk/vps). Покроковий приклад VPS: [exe.dev](/uk/install/exe-dev)
|
||||
|
||||
## Встановлення
|
||||
|
||||
- [Початок роботи](/start/getting-started)
|
||||
- [Встановлення та оновлення](/install/updating)
|
||||
- Необов’язкові потоки: [Bun (експериментально)](/install/bun), [Nix](/install/nix), [Docker](/install/docker)
|
||||
- [Початок роботи](/uk/start/getting-started)
|
||||
- [Встановлення й оновлення](/uk/install/updating)
|
||||
- Додаткові варіанти: [Bun (experimental)](/uk/install/bun), [Nix](/uk/install/nix), [Docker](/uk/install/docker)
|
||||
|
||||
## Gateway
|
||||
|
||||
- [Runbook Gateway](/gateway)
|
||||
- [Конфігурація](/gateway/configuration)
|
||||
- [Інструкція з експлуатації Gateway](/uk/gateway)
|
||||
- [Конфігурація](/uk/gateway/configuration)
|
||||
|
||||
## Встановлення сервісу Gateway (CLI)
|
||||
## Встановлення служби Gateway (CLI)
|
||||
|
||||
Використайте один із цих варіантів:
|
||||
|
||||
@ -61,7 +62,7 @@ openclaw gateway install
|
||||
openclaw configure
|
||||
```
|
||||
|
||||
Коли буде запит, виберіть **Gateway service**.
|
||||
Коли з’явиться запит, виберіть **Служба Gateway**.
|
||||
|
||||
Відновлення/міграція:
|
||||
|
||||
@ -69,12 +70,13 @@ openclaw configure
|
||||
openclaw doctor
|
||||
```
|
||||
|
||||
## Керування системою (користувацький unit systemd)
|
||||
## Керування системою (користувацький модуль systemd)
|
||||
|
||||
OpenClaw за замовчуванням встановлює користувацький сервіс systemd **user**. Для спільних або постійно увімкнених серверів використовуйте **system** service. Команди `openclaw gateway install` і
|
||||
`openclaw onboard --install-daemon` уже генерують для вас поточний канонічний unit;
|
||||
пишіть його вручну лише тоді, коли вам потрібне кастомне налаштування system/service-manager.
|
||||
Повні вказівки щодо сервісу містяться в [runbook Gateway](/gateway).
|
||||
OpenClaw типово встановлює користувацьку службу systemd. Використовуйте системну
|
||||
службу для спільних або постійно активних серверів. `openclaw gateway install` і
|
||||
`openclaw onboard --install-daemon` уже генерують для вас поточний канонічний модуль;
|
||||
створюйте його вручну лише тоді, коли вам потрібне нетипове налаштування
|
||||
system/service-manager. Повні вказівки щодо служби наведено в [інструкції з експлуатації Gateway](/uk/gateway).
|
||||
|
||||
Мінімальне налаштування:
|
||||
|
||||
@ -104,3 +106,41 @@ WantedBy=default.target
|
||||
```
|
||||
systemctl --user enable --now openclaw-gateway[-<profile>].service
|
||||
```
|
||||
|
||||
## Тиск на пам’ять і OOM-kill
|
||||
|
||||
У Linux ядро вибирає жертву OOM, коли на хості, у VM або cgroup контейнера
|
||||
закінчується пам’ять. Gateway може бути невдалою жертвою, оскільки він утримує
|
||||
довгоживучі сесії та з’єднання каналів. Тому OpenClaw, коли це можливо,
|
||||
зміщує пріоритет так, щоб тимчасові дочірні процеси вбивалися раніше за Gateway.
|
||||
|
||||
Для відповідних запусків дочірніх процесів у Linux OpenClaw запускає дочірній
|
||||
процес через коротку обгортку `/bin/sh`, яка підвищує власний `oom_score_adj`
|
||||
дочірнього процесу до `1000`, а потім виконує `exec` реальної команди. Це
|
||||
непривілейована операція, оскільки дочірній процес лише підвищує ймовірність
|
||||
власного OOM-kill.
|
||||
|
||||
Поверхні дочірніх процесів, які охоплюються, включають:
|
||||
|
||||
- дочірні процеси команд, керовані supervisor,
|
||||
- дочірні процеси PTY shell,
|
||||
- дочірні процеси сервера MCP stdio,
|
||||
- процеси браузера/Chrome, запущені OpenClaw.
|
||||
|
||||
Обгортка працює лише в Linux і пропускається, якщо `/bin/sh` недоступний. Вона
|
||||
також пропускається, якщо в середовищі дочірнього процесу встановлено `OPENCLAW_CHILD_OOM_SCORE_ADJ=0`, `false`,
|
||||
`no` або `off`.
|
||||
|
||||
Щоб перевірити дочірній процес:
|
||||
|
||||
```bash
|
||||
cat /proc/<child-pid>/oom_score_adj
|
||||
```
|
||||
|
||||
Очікуване значення для охоплених дочірніх процесів — `1000`. Процес Gateway має
|
||||
зберігати свій звичайний показник, зазвичай `0`.
|
||||
|
||||
Це не замінює звичайне налаштування пам’яті. Якщо VPS або контейнер регулярно
|
||||
завершує дочірні процеси, збільште ліміт пам’яті, зменште паралелізм або
|
||||
додайте жорсткіші обмеження ресурсів, наприклад systemd `MemoryMax=` або
|
||||
ліміти пам’яті на рівні контейнера.
|
||||
|
||||
@ -1,25 +1,25 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете запустити Gateway на сервері Linux або хмарному VPS
|
||||
- Вам потрібен короткий огляд посібників із розміщення
|
||||
- Вам потрібне загальне налаштування сервера Linux для OpenClaw
|
||||
- Ви хочете запустити Gateway на Linux-сервері або хмарному VPS
|
||||
- Вам потрібен короткий огляд посібників із хостингу
|
||||
- Вам потрібне загальне налаштування Linux-сервера для OpenClaw
|
||||
sidebarTitle: Linux Server
|
||||
summary: Запустіть OpenClaw на сервері Linux або хмарному VPS — вибір провайдера, архітектура та налаштування продуктивності
|
||||
title: Сервер Linux
|
||||
summary: Запуск OpenClaw на Linux-сервері або хмарному VPS — вибір провайдера, архітектура та налаштування продуктивності
|
||||
title: Linux-сервер
|
||||
x-i18n:
|
||||
generated_at: "2026-04-13T13:14:21Z"
|
||||
generated_at: "2026-04-23T04:54:32Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: e623f4c770132e01628d66bfb8cd273bbef6dad633b812496c90da5e3e0f1383
|
||||
source_hash: 759428cf20204207a5505a73c880aa776ddd0eabf969fc0dcf444fc8ce6991b2
|
||||
source_path: vps.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Сервер Linux
|
||||
# Linux-сервер
|
||||
|
||||
Запустіть Gateway OpenClaw на будь-якому сервері Linux або хмарному VPS. Ця сторінка допоможе вам
|
||||
вибрати провайдера, пояснює, як працюють хмарні розгортання, і охоплює загальні
|
||||
налаштування Linux, які застосовуються всюди.
|
||||
Запустіть Gateway OpenClaw на будь-якому Linux-сервері або хмарному VPS. Ця сторінка допоможе вам
|
||||
вибрати провайдера, пояснює, як працюють хмарні розгортання, і охоплює загальне
|
||||
налаштування Linux, яке застосовується всюди.
|
||||
|
||||
## Вибір провайдера
|
||||
|
||||
@ -32,47 +32,47 @@ x-i18n:
|
||||
<Card title="Hetzner" href="/uk/install/hetzner">Docker на VPS Hetzner</Card>
|
||||
<Card title="Hostinger" href="/uk/install/hostinger">VPS із налаштуванням в один клік</Card>
|
||||
<Card title="GCP" href="/uk/install/gcp">Compute Engine</Card>
|
||||
<Card title="Azure" href="/uk/install/azure">Віртуальна машина Linux</Card>
|
||||
<Card title="exe.dev" href="/uk/install/exe-dev">Віртуальна машина з HTTPS-проксі</Card>
|
||||
<Card title="Raspberry Pi" href="/uk/install/raspberry-pi">ARM на власному хостингу</Card>
|
||||
<Card title="Azure" href="/uk/install/azure">Linux VM</Card>
|
||||
<Card title="exe.dev" href="/uk/install/exe-dev">VM із HTTPS-проксі</Card>
|
||||
<Card title="Raspberry Pi" href="/uk/install/raspberry-pi">ARM із самостійним хостингом</Card>
|
||||
</CardGroup>
|
||||
|
||||
**AWS (EC2 / Lightsail / безкоштовний рівень)** також добре працює.
|
||||
Доступне відеооглядове керівництво від спільноти за адресою
|
||||
**AWS (EC2 / Lightsail / free tier)** також добре підходить.
|
||||
Відеоогляд від спільноти доступний за посиланням
|
||||
[x.com/techfrenAJ/status/2014934471095812547](https://x.com/techfrenAJ/status/2014934471095812547)
|
||||
(ресурс спільноти — може стати недоступним).
|
||||
|
||||
## Як працюють хмарні налаштування
|
||||
|
||||
- **Gateway працює на VPS** і керує станом + робочим простором.
|
||||
- Ви підключаєтеся з ноутбука або телефона через **Control UI** чи **Tailscale/SSH**.
|
||||
- Сприймайте VPS як джерело істини та регулярно **створюйте резервні копії** стану + робочого простору.
|
||||
- Безпечний варіант за замовчуванням: тримайте Gateway на loopback-інтерфейсі та отримуйте доступ через SSH-тунель або Tailscale Serve.
|
||||
Якщо ви прив’язуєтеся до `lan` або `tailnet`, обов’язково використовуйте `gateway.auth.token` або `gateway.auth.password`.
|
||||
- **Gateway працює на VPS** і зберігає стан + робочий простір.
|
||||
- Ви підключаєтеся зі свого ноутбука або телефона через **Control UI** або **Tailscale/SSH**.
|
||||
- Вважайте VPS джерелом істини та регулярно **створюйте резервні копії** стану + робочого простору.
|
||||
- Безпечний варіант за замовчуванням: тримайте Gateway на loopback і отримуйте до нього доступ через SSH-тунель або Tailscale Serve.
|
||||
Якщо ви прив’язуєте його до `lan` або `tailnet`, обов’язково використовуйте `gateway.auth.token` або `gateway.auth.password`.
|
||||
|
||||
Пов’язані сторінки: [Віддалений доступ до Gateway](/uk/gateway/remote), [Центр платформ](/uk/platforms).
|
||||
|
||||
## Спільний агент компанії на VPS
|
||||
|
||||
Запуск одного агента для команди — це припустимий варіант, якщо всі користувачі перебувають у межах однакової моделі довіри, а агент використовується лише для бізнесу.
|
||||
Запуск одного агента для команди — цілком прийнятний варіант, якщо всі користувачі перебувають в одній межі довіри, а агент використовується лише для бізнесу.
|
||||
|
||||
- Тримайте його в окремому середовищі виконання (VPS/VM/контейнер + окремий користувач ОС/облікові записи).
|
||||
- Тримайте його в окремому середовищі виконання (VPS/VM/контейнер + окремий користувач або облікові записи ОС).
|
||||
- Не входьте в цьому середовищі до особистих облікових записів Apple/Google або особистих профілів браузера/менеджера паролів.
|
||||
- Якщо користувачі є взаємно недовіреними, розділяйте за gateway/хостом/користувачем ОС.
|
||||
- Якщо користувачі є потенційними противниками один для одного, розділяйте їх за gateway/хостом/користувачем ОС.
|
||||
|
||||
Деталі моделі безпеки: [Безпека](/uk/gateway/security).
|
||||
Подробиці моделі безпеки: [Безпека](/uk/gateway/security).
|
||||
|
||||
## Використання Node із VPS
|
||||
## Використання вузлів із VPS
|
||||
|
||||
Ви можете тримати Gateway у хмарі та під’єднувати **Node** на своїх локальних пристроях
|
||||
(Mac/iOS/Android/headless). Node надають локальні можливості екрана/камери/canvas і `system.run`,
|
||||
тоді як Gateway залишається у хмарі.
|
||||
Ви можете тримати Gateway у хмарі та підключати **вузли** на своїх локальних пристроях
|
||||
(Mac/iOS/Android/headless). Вузли надають локальні можливості screen/camera/canvas і `system.run`,
|
||||
тоді як Gateway залишається в хмарі.
|
||||
|
||||
Документація: [Node](/uk/nodes), [CLI Node](/cli/nodes).
|
||||
Документація: [Вузли](/uk/nodes), [CLI вузлів](/cli/nodes).
|
||||
|
||||
## Налаштування запуску для малих VM і ARM-хостів
|
||||
|
||||
Якщо команди CLI здаються повільними на малопотужних VM (або ARM-хостах), увімкніть кеш компіляції модулів Node:
|
||||
Якщо команди CLI працюють повільно на малопотужних VM (або ARM-хостах), увімкніть кеш компіляції модулів Node:
|
||||
|
||||
```bash
|
||||
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
|
||||
@ -83,14 +83,14 @@ EOF
|
||||
source ~/.bashrc
|
||||
```
|
||||
|
||||
- `NODE_COMPILE_CACHE` пришвидшує повторний запуск команд.
|
||||
- `NODE_COMPILE_CACHE` пришвидшує повторні запуски команд.
|
||||
- `OPENCLAW_NO_RESPAWN=1` усуває додаткові накладні витрати запуску через шлях самоперезапуску.
|
||||
- Перший запуск команди прогріває кеш; наступні запуски швидші.
|
||||
- Для особливостей Raspberry Pi дивіться [Raspberry Pi](/uk/install/raspberry-pi).
|
||||
- Перший запуск команди прогріває кеш; наступні запуски працюють швидше.
|
||||
- Докладніше саме для Raspberry Pi див. [Raspberry Pi](/uk/install/raspberry-pi).
|
||||
|
||||
### Контрольний список налаштування systemd (необов’язково)
|
||||
|
||||
Для VM-хостів, що використовують `systemd`, варто розглянути таке:
|
||||
Для VM-хостів, які використовують `systemd`, розгляньте таке:
|
||||
|
||||
- Додайте змінні середовища сервісу для стабільного шляху запуску:
|
||||
- `OPENCLAW_NO_RESPAWN=1`
|
||||
@ -99,7 +99,7 @@ source ~/.bashrc
|
||||
- `Restart=always`
|
||||
- `RestartSec=2`
|
||||
- `TimeoutStartSec=90`
|
||||
- Віддавайте перевагу дискам на SSD для шляхів стану/кешу, щоб зменшити штрафи холодного запуску через випадковий I/O.
|
||||
- Віддавайте перевагу дискам на SSD для шляхів стану/кешу, щоб зменшити штрафи холодного старту через випадковий I/O.
|
||||
|
||||
Для стандартного шляху `openclaw onboard --install-daemon` відредагуйте користувацький unit:
|
||||
|
||||
@ -116,8 +116,11 @@ RestartSec=2
|
||||
TimeoutStartSec=90
|
||||
```
|
||||
|
||||
Якщо натомість ви навмисно встановили системний unit, відредагуйте
|
||||
Якщо ви навмисно встановили системний unit, натомість редагуйте
|
||||
`openclaw-gateway.service` через `sudo systemctl edit openclaw-gateway.service`.
|
||||
|
||||
Як політики `Restart=` допомагають автоматизованому відновленню:
|
||||
[systemd може автоматизувати відновлення сервісу](https://www.redhat.com/en/blog/systemd-automate-recovery).
|
||||
Як політики `Restart=` допомагають автоматичному відновленню:
|
||||
[systemd може автоматизувати відновлення сервісів](https://www.redhat.com/en/blog/systemd-automate-recovery).
|
||||
|
||||
Про поведінку OOM у Linux, вибір жертви серед дочірніх процесів і діагностику `exit 137`
|
||||
див. [Тиск на пам’ять Linux і завершення через OOM](/uk/platforms/linux#memory-pressure-and-oom-kills).
|
||||
|
||||
Loading…
Reference in New Issue
Block a user