chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
680137c4dc
commit
99ed974a0a
2023
docs/uk/help/faq.md
2023
docs/uk/help/faq.md
File diff suppressed because it is too large
Load Diff
@ -1,15 +1,15 @@
|
||||
---
|
||||
read_when:
|
||||
- Вам потрібен спосіб встановлення, відмінний від швидкого старту Getting Started
|
||||
- Вам потрібен спосіб встановлення, відмінний від короткого посібника Getting Started
|
||||
- Ви хочете розгорнути на хмарній платформі
|
||||
- Вам потрібно оновити, перенести або видалити
|
||||
summary: Встановлення OpenClaw — скрипт встановлення, npm/pnpm/bun, зі source, Docker та інше
|
||||
title: Встановлення
|
||||
summary: Встановити OpenClaw — скрипт встановлення, npm/pnpm/bun, зі source, Docker та інше
|
||||
title: Встановити
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T18:07:51Z"
|
||||
generated_at: "2026-04-19T06:50:09Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: eca17c76a2a66166b3d8cda9dc3144ab920d30ad0ed2a220eb9389d7a383ba5d
|
||||
source_hash: ad0a5fdbbf13dcaf2fed6840f35aa22b2e9e458509509f98303c8d87c2556a6f
|
||||
source_path: install/index.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -18,7 +18,7 @@ x-i18n:
|
||||
|
||||
## Рекомендовано: скрипт встановлення
|
||||
|
||||
Найшвидший спосіб встановлення. Він визначає вашу ОС, встановлює Node за потреби, встановлює OpenClaw і запускає onboarding.
|
||||
Найшвидший спосіб встановлення. Він визначає вашу ОС, за потреби встановлює Node, встановлює OpenClaw і запускає онбординг.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="macOS / Linux / WSL2">
|
||||
@ -33,7 +33,7 @@ x-i18n:
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
Щоб встановити без запуску onboarding:
|
||||
Щоб встановити без запуску онбордингу:
|
||||
|
||||
<Tabs>
|
||||
<Tab title="macOS / Linux / WSL2">
|
||||
@ -48,27 +48,27 @@ x-i18n:
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
Усі прапорці та параметри для CI/automation див. у [Внутрішня будова інсталятора](/install/installer).
|
||||
Усі прапорці та параметри для CI/автоматизації дивіться в [Внутрішні механізми інсталятора](/uk/install/installer).
|
||||
|
||||
## Системні вимоги
|
||||
|
||||
- **Node 24** (рекомендовано) або Node 22.14+ — скрипт встановлення обробляє це автоматично
|
||||
- **macOS, Linux або Windows** — підтримуються як нативний Windows, так і WSL2; WSL2 стабільніший. Див. [Windows](/platforms/windows).
|
||||
- **macOS, Linux або Windows** — підтримуються як нативний Windows, так і WSL2; WSL2 стабільніший. Див. [Windows](/uk/platforms/windows).
|
||||
- `pnpm` потрібен лише якщо ви збираєте зі source
|
||||
|
||||
## Альтернативні способи встановлення
|
||||
|
||||
### Інсталятор з локальним префіксом (`install-cli.sh`)
|
||||
### Інсталятор із локальним префіксом (`install-cli.sh`)
|
||||
|
||||
Використовуйте це, якщо хочете зберігати OpenClaw і Node під локальним префіксом, таким як
|
||||
`~/.openclaw`, не покладаючись на загальносистемне встановлення Node:
|
||||
Використовуйте це, якщо хочете, щоб OpenClaw і Node зберігалися в локальному префіксі, наприклад
|
||||
`~/.openclaw`, без залежності від системного встановлення Node:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://openclaw.ai/install-cli.sh | bash
|
||||
```
|
||||
|
||||
Типово він підтримує встановлення через npm, а також встановлення з git checkout у межах того самого
|
||||
процесу з локальним префіксом. Повний довідник: [Внутрішня будова інсталятора](/install/installer#install-clish).
|
||||
За замовчуванням він підтримує встановлення через npm, а також встановлення з git checkout у межах того самого
|
||||
потоку з префіксом. Повний довідник: [Внутрішні механізми інсталятора](/uk/install/installer#install-clish).
|
||||
|
||||
### npm, pnpm або bun
|
||||
|
||||
@ -89,7 +89,7 @@ curl -fsSL https://openclaw.ai/install-cli.sh | bash
|
||||
```
|
||||
|
||||
<Note>
|
||||
pnpm вимагає явного схвалення для пакетів зі скриптами збирання. Після першого встановлення виконайте `pnpm approve-builds -g`.
|
||||
pnpm вимагає явного схвалення для пакетів зі скриптами збірки. Після першого встановлення виконайте `pnpm approve-builds -g`.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
@ -100,13 +100,13 @@ curl -fsSL https://openclaw.ai/install-cli.sh | bash
|
||||
```
|
||||
|
||||
<Note>
|
||||
Bun підтримується для глобального шляху встановлення CLI. Для runtime Gateway Node як і раніше залишається рекомендованим runtime для daemon.
|
||||
Bun підтримується для шляху глобального встановлення CLI. Для середовища виконання Gateway рекомендованим середовищем виконання демона залишається Node.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
<Accordion title="Troubleshooting: sharp build errors (npm)">
|
||||
<Accordion title="Усунення проблем: помилки збірки sharp (npm)">
|
||||
Якщо `sharp` завершується помилкою через глобально встановлений libvips:
|
||||
|
||||
```bash
|
||||
@ -122,12 +122,12 @@ SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
|
||||
```bash
|
||||
git clone https://github.com/openclaw/openclaw.git
|
||||
cd openclaw
|
||||
pnpm install && pnpm ui:build && pnpm build
|
||||
pnpm install && pnpm build && pnpm ui:build
|
||||
pnpm link --global
|
||||
openclaw onboard --install-daemon
|
||||
```
|
||||
|
||||
Або пропустіть link і використовуйте `pnpm openclaw ...` зсередини репозиторію. Повні dev-процеси див. у [Налаштування](/start/setup).
|
||||
Або пропустіть link і використовуйте `pnpm openclaw ...` всередині репозиторію. Повні робочі процеси розробки дивіться в [Налаштування](/uk/start/setup).
|
||||
|
||||
### Встановлення з GitHub main
|
||||
|
||||
@ -138,82 +138,82 @@ npm install -g github:openclaw/openclaw#main
|
||||
### Контейнери та менеджери пакетів
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Docker" href="/install/docker" icon="container">
|
||||
<Card title="Docker" href="/uk/install/docker" icon="container">
|
||||
Контейнеризовані або headless-розгортання.
|
||||
</Card>
|
||||
<Card title="Podman" href="/install/podman" icon="container">
|
||||
Rootless-контейнерна альтернатива Docker.
|
||||
<Card title="Podman" href="/uk/install/podman" icon="container">
|
||||
Rootless-альтернатива Docker.
|
||||
</Card>
|
||||
<Card title="Nix" href="/install/nix" icon="snowflake">
|
||||
<Card title="Nix" href="/uk/install/nix" icon="snowflake">
|
||||
Декларативне встановлення через Nix flake.
|
||||
</Card>
|
||||
<Card title="Ansible" href="/install/ansible" icon="server">
|
||||
Автоматизоване підготовлення інфраструктури.
|
||||
<Card title="Ansible" href="/uk/install/ansible" icon="server">
|
||||
Автоматизоване підготовлення парку систем.
|
||||
</Card>
|
||||
<Card title="Bun" href="/install/bun" icon="zap">
|
||||
Використання лише CLI через runtime Bun.
|
||||
<Card title="Bun" href="/uk/install/bun" icon="zap">
|
||||
Використання лише CLI через середовище виконання Bun.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Перевірка встановлення
|
||||
|
||||
```bash
|
||||
openclaw --version # confirm the CLI is available
|
||||
openclaw doctor # check for config issues
|
||||
openclaw gateway status # verify the Gateway is running
|
||||
openclaw --version # підтвердити, що CLI доступний
|
||||
openclaw doctor # перевірити проблеми конфігурації
|
||||
openclaw gateway status # перевірити, що Gateway запущено
|
||||
```
|
||||
|
||||
Якщо ви хочете керований запуск після встановлення:
|
||||
Якщо після встановлення ви хочете керований запуск:
|
||||
|
||||
- macOS: LaunchAgent через `openclaw onboard --install-daemon` або `openclaw gateway install`
|
||||
- Linux/WSL2: systemd user service через ті самі команди
|
||||
- Нативний Windows: спочатку Scheduled Task, із резервним варіантом per-user login item у теці Startup, якщо створення завдання відхилено
|
||||
- Linux/WSL2: користувацька служба systemd через ті самі команди
|
||||
- Нативний Windows: спочатку Scheduled Task, із резервним варіантом елемента входу в систему в папці Startup для конкретного користувача, якщо створення завдання заборонено
|
||||
|
||||
## Хостинг і розгортання
|
||||
|
||||
Розгорніть OpenClaw на хмарному сервері або VPS:
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="VPS" href="/vps">Будь-який Linux VPS</Card>
|
||||
<Card title="Docker VM" href="/install/docker-vm-runtime">Спільні кроки для Docker</Card>
|
||||
<Card title="Kubernetes" href="/install/kubernetes">K8s</Card>
|
||||
<Card title="Fly.io" href="/install/fly">Fly.io</Card>
|
||||
<Card title="Hetzner" href="/install/hetzner">Hetzner</Card>
|
||||
<Card title="GCP" href="/install/gcp">Google Cloud</Card>
|
||||
<Card title="Azure" href="/install/azure">Azure</Card>
|
||||
<Card title="Railway" href="/install/railway">Railway</Card>
|
||||
<Card title="Render" href="/install/render">Render</Card>
|
||||
<Card title="Northflank" href="/install/northflank">Northflank</Card>
|
||||
<Card title="VPS" href="/uk/vps">Будь-який Linux VPS</Card>
|
||||
<Card title="Docker VM" href="/uk/install/docker-vm-runtime">Спільні кроки для Docker</Card>
|
||||
<Card title="Kubernetes" href="/uk/install/kubernetes">K8s</Card>
|
||||
<Card title="Fly.io" href="/uk/install/fly">Fly.io</Card>
|
||||
<Card title="Hetzner" href="/uk/install/hetzner">Hetzner</Card>
|
||||
<Card title="GCP" href="/uk/install/gcp">Google Cloud</Card>
|
||||
<Card title="Azure" href="/uk/install/azure">Azure</Card>
|
||||
<Card title="Railway" href="/uk/install/railway">Railway</Card>
|
||||
<Card title="Render" href="/uk/install/render">Render</Card>
|
||||
<Card title="Northflank" href="/uk/install/northflank">Northflank</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Оновлення, перенесення або видалення
|
||||
|
||||
<CardGroup cols={3}>
|
||||
<Card title="Updating" href="/install/updating" icon="refresh-cw">
|
||||
<Card title="Оновлення" href="/uk/install/updating" icon="refresh-cw">
|
||||
Підтримуйте OpenClaw в актуальному стані.
|
||||
</Card>
|
||||
<Card title="Migrating" href="/install/migrating" icon="arrow-right">
|
||||
Перенесіть на нову машину.
|
||||
<Card title="Перенесення" href="/uk/install/migrating" icon="arrow-right">
|
||||
Перехід на нову машину.
|
||||
</Card>
|
||||
<Card title="Uninstall" href="/install/uninstall" icon="trash-2">
|
||||
Повністю видаліть OpenClaw.
|
||||
<Card title="Видалення" href="/uk/install/uninstall" icon="trash-2">
|
||||
Повністю видалити OpenClaw.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
## Усунення несправностей: `openclaw` не знайдено
|
||||
## Усунення проблем: `openclaw` не знайдено
|
||||
|
||||
Якщо встановлення пройшло успішно, але `openclaw` не знаходиться у вашому терміналі:
|
||||
Якщо встановлення виконалося успішно, але `openclaw` не знаходиться у вашому терміналі:
|
||||
|
||||
```bash
|
||||
node -v # Node installed?
|
||||
npm prefix -g # Where are global packages?
|
||||
echo "$PATH" # Is the global bin dir in PATH?
|
||||
node -v # Node встановлено?
|
||||
npm prefix -g # Де розташовані глобальні пакети?
|
||||
echo "$PATH" # Чи є глобальний каталог bin у PATH?
|
||||
```
|
||||
|
||||
Якщо `$(npm prefix -g)/bin` немає у вашому `$PATH`, додайте його до файлу запуску shell (`~/.zshrc` або `~/.bashrc`):
|
||||
Якщо `$(npm prefix -g)/bin` відсутній у вашому `$PATH`, додайте його до файлу запуску оболонки (`~/.zshrc` або `~/.bashrc`):
|
||||
|
||||
```bash
|
||||
export PATH="$(npm prefix -g)/bin:$PATH"
|
||||
```
|
||||
|
||||
Потім відкрийте новий термінал. Докладніше див. у [Налаштування Node](/install/node).
|
||||
Потім відкрийте новий термінал. Докладніше дивіться в [Налаштування Node](/uk/install/node).
|
||||
|
||||
@ -1,40 +1,40 @@
|
||||
---
|
||||
read_when:
|
||||
- Встановлення OpenClaw на Windows
|
||||
- Вибір між нативним Windows і WSL2
|
||||
- Пошук інформації про стан супутнього застосунку для Windows
|
||||
summary: 'Підтримка Windows: нативний шлях встановлення та через WSL2, служба та поточні застереження'
|
||||
- Вибір між власним Windows і WSL2
|
||||
- Пошук статусу супутнього застосунку для Windows
|
||||
summary: 'Підтримка Windows: власні шляхи встановлення та через WSL2, демон і поточні застереження'
|
||||
title: Windows
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T18:11:13Z"
|
||||
generated_at: "2026-04-19T06:50:05Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 7d9819206bdd65cf03519c1bc73ed0c7889b0ab842215ea94343262300adfd14
|
||||
source_hash: 1e7451c785a1d75c809522ad93e2c44a00b211f77f14c5c489fd0b01840d3fe2
|
||||
source_path: platforms/windows.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Windows
|
||||
|
||||
OpenClaw підтримує як **нативний Windows**, так і **WSL2**. WSL2 — стабільніший шлях, і його рекомендовано для повного досвіду використання: CLI, Gateway та інструментарій працюють усередині Linux з повною сумісністю. Нативний Windows підходить для основних сценаріїв CLI і Gateway, з деякими застереженнями, наведеними нижче.
|
||||
OpenClaw підтримує як **власний Windows**, так і **WSL2**. WSL2 — це стабільніший шлях, рекомендований для повноцінного використання: CLI, Gateway і супутні інструменти працюють усередині Linux із повною сумісністю. Власний Windows підходить для базового використання CLI і Gateway, з деякими застереженнями, наведеними нижче.
|
||||
|
||||
Нативні супутні застосунки для Windows заплановані.
|
||||
Супутні застосунки для Windows заплановані.
|
||||
|
||||
## WSL2 (рекомендовано)
|
||||
|
||||
- [Початок роботи](/start/getting-started) (використовуйте всередині WSL)
|
||||
- [Встановлення та оновлення](/uk/install/updating)
|
||||
- [Початок роботи](/uk/start/getting-started) (використовуйте всередині WSL)
|
||||
- [Встановлення й оновлення](/uk/install/updating)
|
||||
- Офіційний посібник із WSL2 (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install)
|
||||
|
||||
## Стан нативного Windows
|
||||
## Статус власного Windows
|
||||
|
||||
Сценарії CLI для нативного Windows покращуються, але WSL2 все ще є рекомендованим шляхом.
|
||||
Потоки CLI для власного Windows покращуються, але WSL2 усе ще залишається рекомендованим шляхом.
|
||||
|
||||
Що сьогодні добре працює на нативному Windows:
|
||||
Що сьогодні добре працює у власному Windows:
|
||||
|
||||
- інсталятор із вебсайту через `install.ps1`
|
||||
- інсталятор із сайту через `install.ps1`
|
||||
- локальне використання CLI, наприклад `openclaw --version`, `openclaw doctor` і `openclaw plugins list --json`
|
||||
- вбудовані перевірки local-agent/provider, наприклад:
|
||||
- вбудований локальний smoke-тест agent/provider, наприклад:
|
||||
|
||||
```powershell
|
||||
openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."
|
||||
@ -42,31 +42,31 @@ openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOW
|
||||
|
||||
Поточні застереження:
|
||||
|
||||
- `openclaw onboard --non-interactive` досі очікує доступний локальний шлюз, якщо не передати `--skip-health`
|
||||
- `openclaw onboard --non-interactive --install-daemon` і `openclaw gateway install` спочатку намагаються використовувати Windows Scheduled Tasks
|
||||
- якщо створення Scheduled Task заборонено, OpenClaw переходить до резервного варіанта з елементом входу per-user у папці Startup і негайно запускає шлюз
|
||||
- якщо сам `schtasks` зависає або перестає відповідати, OpenClaw тепер швидко перериває цей шлях і переходить до резервного варіанта замість того, щоб зависнути назавжди
|
||||
- Scheduled Tasks усе ще є бажаним варіантом, коли вони доступні, оскільки вони забезпечують кращий стан наглядача
|
||||
- `openclaw onboard --non-interactive` досі очікує доступний локальний gateway, якщо не передати `--skip-health`
|
||||
- `openclaw onboard --non-interactive --install-daemon` і `openclaw gateway install` спочатку намагаються використати Windows Scheduled Tasks
|
||||
- якщо створення Scheduled Task заборонене, OpenClaw переключається на елемент автозапуску під час входу через Startup folder для поточного користувача і негайно запускає gateway
|
||||
- якщо сам `schtasks` зависає або перестає відповідати, OpenClaw тепер швидко перериває цей шлях і переходить до резервного варіанту замість того, щоб зависати назавжди
|
||||
- Scheduled Tasks усе ще є пріоритетним варіантом, коли вони доступні, оскільки забезпечують кращий статус супервізора
|
||||
|
||||
Якщо вам потрібен лише нативний CLI, без встановлення служби шлюзу, використовуйте один із цих варіантів:
|
||||
Якщо вам потрібен лише власний CLI, без встановлення служби gateway, використовуйте один із цих варіантів:
|
||||
|
||||
```powershell
|
||||
openclaw onboard --non-interactive --skip-health
|
||||
openclaw gateway run
|
||||
```
|
||||
|
||||
Якщо ж вам потрібен керований автозапуск у нативному Windows:
|
||||
Якщо ж вам потрібен керований автозапуск у власному Windows:
|
||||
|
||||
```powershell
|
||||
openclaw gateway install
|
||||
openclaw gateway status --json
|
||||
```
|
||||
|
||||
Якщо створення Scheduled Task заблоковано, резервний режим служби все одно автоматично запускається після входу через папку Startup поточного користувача.
|
||||
Якщо створення Scheduled Task заблоковане, резервний режим служби все одно автоматично запускається після входу через Startup folder поточного користувача.
|
||||
|
||||
## Gateway
|
||||
|
||||
- [Посібник із Gateway](/uk/gateway)
|
||||
- [Інструкція з Gateway](/uk/gateway)
|
||||
- [Конфігурація](/uk/gateway/configuration)
|
||||
|
||||
## Встановлення служби Gateway (CLI)
|
||||
@ -89,9 +89,9 @@ openclaw gateway install
|
||||
openclaw configure
|
||||
```
|
||||
|
||||
Коли буде запит, виберіть **Gateway service**.
|
||||
Коли з’явиться запит, виберіть **Gateway service**.
|
||||
|
||||
Виправлення/міграція:
|
||||
Відновлення/міграція:
|
||||
|
||||
```
|
||||
openclaw doctor
|
||||
@ -99,9 +99,9 @@ openclaw doctor
|
||||
|
||||
## Автозапуск Gateway до входу в Windows
|
||||
|
||||
Для безголових конфігурацій переконайтеся, що весь ланцюжок завантаження працює, навіть коли ніхто не входить у Windows.
|
||||
Для безголових конфігурацій переконайтеся, що весь ланцюжок запуску виконується, навіть коли ніхто не входить у Windows.
|
||||
|
||||
### 1) Зберігайте роботу служб користувача без входу
|
||||
### 1) Залишайте користувацькі служби активними без входу
|
||||
|
||||
Усередині WSL:
|
||||
|
||||
@ -109,7 +109,7 @@ openclaw doctor
|
||||
sudo loginctl enable-linger "$(whoami)"
|
||||
```
|
||||
|
||||
### 2) Установіть службу користувача шлюзу OpenClaw
|
||||
### 2) Встановіть користувацьку службу gateway OpenClaw
|
||||
|
||||
Усередині WSL:
|
||||
|
||||
@ -140,9 +140,12 @@ systemctl --user is-enabled openclaw-gateway.service
|
||||
systemctl --user status openclaw-gateway.service --no-pager
|
||||
```
|
||||
|
||||
## Додатково: відкриття служб WSL у LAN (portproxy)
|
||||
## Додатково: відкриття сервісів WSL у LAN (portproxy)
|
||||
|
||||
WSL має власну віртуальну мережу. Якщо іншому комп’ютеру потрібно звернутися до служби, що працює **всередині WSL** (SSH, локальний сервер TTS або Gateway), ви маєте переспрямувати порт Windows на поточну IP-адресу WSL. IP-адреса WSL змінюється після перезапусків, тому може знадобитися оновлювати правило переспрямування.
|
||||
WSL має власну віртуальну мережу. Якщо іншій машині потрібно підключитися до сервісу,
|
||||
що працює **всередині WSL** (SSH, локальний сервер TTS або Gateway), ви маєте
|
||||
перенаправити порт Windows на поточну IP-адресу WSL. IP-адреса WSL змінюється після перезапусків,
|
||||
тому може знадобитися оновлювати правило перенаправлення.
|
||||
|
||||
Приклад (PowerShell **від імені адміністратора**):
|
||||
|
||||
@ -175,27 +178,29 @@ netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.
|
||||
|
||||
Примітки:
|
||||
|
||||
- SSH з іншого комп’ютера має бути спрямований на **IP-адресу хоста Windows** (наприклад: `ssh user@windows-host -p 2222`).
|
||||
- Віддалені вузли мають вказувати на **доступну** URL-адресу Gateway (не `127.0.0.1`); використовуйте `openclaw status --all` для перевірки.
|
||||
- SSH з іншої машини має підключатися до **IP-адреси хоста Windows** (наприклад: `ssh user@windows-host -p 2222`).
|
||||
- Віддалені nodes мають вказувати на **доступний** URL Gateway (не `127.0.0.1`); використовуйте
|
||||
`openclaw status --all` для перевірки.
|
||||
- Використовуйте `listenaddress=0.0.0.0` для доступу з LAN; `127.0.0.1` залишає доступ лише локальним.
|
||||
- Якщо ви хочете автоматизувати це, зареєструйте Scheduled Task для запуску кроку оновлення під час входу в систему.
|
||||
- Якщо ви хочете автоматизувати це, зареєструйте Scheduled Task для запуску
|
||||
кроку оновлення під час входу в систему.
|
||||
|
||||
## Покрокове встановлення WSL2
|
||||
|
||||
### 1) Установіть WSL2 + Ubuntu
|
||||
### 1) Встановіть WSL2 + Ubuntu
|
||||
|
||||
Відкрийте PowerShell (Admin):
|
||||
|
||||
```powershell
|
||||
wsl --install
|
||||
# Або явно виберіть дистрибутив:
|
||||
# Or pick a distro explicitly:
|
||||
wsl --list --online
|
||||
wsl --install -d Ubuntu-24.04
|
||||
```
|
||||
|
||||
Перезавантажте систему, якщо Windows попросить.
|
||||
|
||||
### 2) Увімкніть systemd (потрібно для встановлення Gateway)
|
||||
### 2) Увімкніть systemd (потрібно для встановлення gateway)
|
||||
|
||||
У вашому терміналі WSL:
|
||||
|
||||
@ -206,33 +211,44 @@ systemd=true
|
||||
EOF
|
||||
```
|
||||
|
||||
Потім із PowerShell:
|
||||
Потім у PowerShell:
|
||||
|
||||
```powershell
|
||||
wsl --shutdown
|
||||
```
|
||||
|
||||
Знову відкрийте Ubuntu, а потім перевірте:
|
||||
Знову відкрийте Ubuntu, потім перевірте:
|
||||
|
||||
```bash
|
||||
systemctl --user status
|
||||
```
|
||||
|
||||
### 3) Установіть OpenClaw (усередині WSL)
|
||||
### 3) Встановіть OpenClaw (усередині WSL)
|
||||
|
||||
Дотримуйтесь потоку Linux Getting Started всередині WSL:
|
||||
Для звичайного першого налаштування всередині WSL дотримуйтеся Linux-процесу з розділу Початок роботи:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/openclaw/openclaw.git
|
||||
cd openclaw
|
||||
pnpm install
|
||||
pnpm ui:build # автоматично встановлює залежності UI під час першого запуску
|
||||
pnpm build
|
||||
openclaw onboard
|
||||
pnpm ui:build
|
||||
pnpm openclaw onboard --install-daemon
|
||||
```
|
||||
|
||||
Повний посібник: [Початок роботи](/start/getting-started)
|
||||
Якщо ви розробляєте із сирцевого коду замість першого проходження onboarding, використовуйте
|
||||
цикл розробки з сирцевого коду з [Налаштування](/uk/start/setup):
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
# First run only (or after resetting local OpenClaw config/workspace)
|
||||
pnpm openclaw setup
|
||||
pnpm gateway:watch
|
||||
```
|
||||
|
||||
Повний посібник: [Початок роботи](/uk/start/getting-started)
|
||||
|
||||
## Супутній застосунок для Windows
|
||||
|
||||
У нас ще немає супутнього застосунку для Windows. Вітаються внески, якщо ви хочете допомогти зробити це можливим.
|
||||
У нас ще немає супутнього застосунку для Windows. Ми будемо раді внескам, якщо ви хочете
|
||||
допомогти зробити це можливим.
|
||||
|
||||
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Налаштування нової машини
|
||||
- Ви хочете “latest + greatest” без шкоди для свого особистого налаштування
|
||||
- Ви хочете отримати «найновіше й найкраще», не ламаючи своє особисте налаштування.
|
||||
summary: Розширене налаштування та робочі процеси розробки для OpenClaw
|
||||
title: Налаштування
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T18:18:07Z"
|
||||
generated_at: "2026-04-19T06:50:06Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: be4e280dde7f3a224345ca557ef2fb35a9c9db8520454ff63794ac6f8d4e71e7
|
||||
source_hash: 773cdbef5f38b069303b5e13fca5fcdc28f082746869f17b8b92aab1610b95a8
|
||||
source_path: start/setup.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -16,36 +16,36 @@ x-i18n:
|
||||
# Налаштування
|
||||
|
||||
<Note>
|
||||
Якщо ви налаштовуєте все вперше, почніть із [Getting Started](/start/getting-started).
|
||||
Подробиці онбордингу дивіться в [Onboarding (CLI)](/start/wizard).
|
||||
Якщо ви налаштовуєте все вперше, почніть із [Початок роботи](/uk/start/getting-started).
|
||||
Докладніше про онбординг дивіться в [Онбординг (CLI)](/uk/start/wizard).
|
||||
</Note>
|
||||
|
||||
## TL;DR
|
||||
## Коротко
|
||||
|
||||
- **Користувацькі налаштування зберігаються поза репозиторієм:** `~/.openclaw/workspace` (робочий простір) + `~/.openclaw/openclaw.json` (конфігурація).
|
||||
- **Стабільний робочий процес:** установіть застосунок macOS і дозвольте йому запускати вбудований Gateway.
|
||||
- **Робочий процес на bleeding edge:** запускайте Gateway самостійно через `pnpm gateway:watch`, а потім дозвольте застосунку macOS підключитися в режимі Local.
|
||||
- **Персоналізація зберігається поза репозиторієм:** `~/.openclaw/workspace` (workspace) + `~/.openclaw/openclaw.json` (config).
|
||||
- **Стабільний робочий процес:** встановіть застосунок macOS; дозвольте йому запускати вбудований Gateway.
|
||||
- **Найновіший робочий процес:** запускайте Gateway самостійно через `pnpm gateway:watch`, а потім дозвольте застосунку macOS підключитися в режимі Local.
|
||||
|
||||
## Передумови (зі source-коду)
|
||||
## Передумови (зі source)
|
||||
|
||||
- Рекомендовано Node 24 (Node 22 LTS, наразі `22.14+`, також підтримується)
|
||||
- Бажано `pnpm` (або Bun, якщо ви свідомо використовуєте [робочий процес Bun](/uk/install/bun))
|
||||
- Docker (необов’язково; лише для контейнеризованого налаштування/e2e — див. [Docker](/uk/install/docker))
|
||||
|
||||
## Стратегія кастомізації (щоб оновлення не шкодили)
|
||||
## Стратегія персоналізації (щоб оновлення не шкодили)
|
||||
|
||||
Якщо ви хочете “100% tailored to me” _і_ простих оновлень, зберігайте свою кастомізацію в:
|
||||
Якщо ви хочете «100% налаштовано під мене» _і_ прості оновлення, зберігайте свої налаштування в:
|
||||
|
||||
- **Конфігурації:** `~/.openclaw/openclaw.json` (щось на кшталт JSON/JSON5)
|
||||
- **Робочому просторі:** `~/.openclaw/workspace` (skills, prompts, memories; зробіть його приватним git-репозиторієм)
|
||||
- **Config:** `~/.openclaw/openclaw.json` (щось на кшталт JSON/JSON5)
|
||||
- **Workspace:** `~/.openclaw/workspace` (Skills, prompts, memories; зробіть це приватним git-репозиторієм)
|
||||
|
||||
Одноразове bootstrap-налаштування:
|
||||
Одноразове початкове налаштування:
|
||||
|
||||
```bash
|
||||
openclaw setup
|
||||
```
|
||||
|
||||
Зсередини цього репозиторію використовуйте локальну точку входу CLI:
|
||||
Усередині цього репозиторію використовуйте локальний запис CLI:
|
||||
|
||||
```bash
|
||||
openclaw setup
|
||||
@ -55,7 +55,7 @@ openclaw setup
|
||||
|
||||
## Запуск Gateway з цього репозиторію
|
||||
|
||||
Після `pnpm build` ви можете запускати зібраний CLI напряму:
|
||||
Після `pnpm build` ви можете запускати запакований CLI напряму:
|
||||
|
||||
```bash
|
||||
node openclaw.mjs gateway --port 18789 --verbose
|
||||
@ -63,10 +63,10 @@ node openclaw.mjs gateway --port 18789 --verbose
|
||||
|
||||
## Стабільний робочий процес (спочатку застосунок macOS)
|
||||
|
||||
1. Установіть і запустіть **OpenClaw.app** (рядок меню).
|
||||
1. Встановіть і запустіть **OpenClaw.app** (рядок меню).
|
||||
2. Завершіть чекліст онбордингу/дозволів (запити TCC).
|
||||
3. Переконайтеся, що Gateway перебуває в режимі **Local** і запущений (застосунок керує ним).
|
||||
4. Підключіть поверхні (наприклад: WhatsApp):
|
||||
3. Переконайтеся, що Gateway у режимі **Local** і запущений (застосунок керує ним).
|
||||
4. Підключіть канали (приклад: WhatsApp):
|
||||
|
||||
```bash
|
||||
openclaw channels login
|
||||
@ -78,17 +78,17 @@ openclaw channels login
|
||||
openclaw health
|
||||
```
|
||||
|
||||
Якщо у вашій збірці онбординг недоступний:
|
||||
Якщо онбординг недоступний у вашій збірці:
|
||||
|
||||
- Запустіть `openclaw setup`, потім `openclaw channels login`, а потім вручну запустіть Gateway (`openclaw gateway`).
|
||||
|
||||
## Робочий процес на bleeding edge (Gateway у терміналі)
|
||||
## Найновіший робочий процес (Gateway у терміналі)
|
||||
|
||||
Мета: працювати над TypeScript Gateway, отримати hot reload і зберегти підключення UI застосунку macOS.
|
||||
Мета: працювати з Gateway на TypeScript, отримати гаряче перезавантаження та зберегти підключений UI застосунку macOS.
|
||||
|
||||
### 0) (Необов’язково) Також запускайте застосунок macOS із source-коду
|
||||
### 0) (Необов’язково) Також запускайте застосунок macOS зі source
|
||||
|
||||
Якщо ви теж хочете мати застосунок macOS на bleeding edge:
|
||||
Якщо ви також хочете використовувати застосунок macOS у найновішому режимі:
|
||||
|
||||
```bash
|
||||
./scripts/restart-mac.sh
|
||||
@ -98,16 +98,22 @@ openclaw health
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
# Лише під час першого запуску (або після скидання локальних config/workspace OpenClaw)
|
||||
pnpm openclaw setup
|
||||
pnpm gateway:watch
|
||||
```
|
||||
|
||||
`gateway:watch` запускає gateway у режимі спостереження та перезавантажує його при релевантних змінах source-коду,
|
||||
конфігурації та метаданих комплектних плагінів.
|
||||
`gateway:watch` запускає gateway у режимі watch і перезавантажує його після відповідних змін у source,
|
||||
config і метаданих вбудованих Plugin.
|
||||
`pnpm openclaw setup` — це одноразовий крок ініціалізації локальних config/workspace для свіжого checkout.
|
||||
`pnpm gateway:watch` не перебудовує `dist/control-ui`, тому після змін у `ui/` повторно запускайте `pnpm ui:build` або використовуйте `pnpm ui:dev` під час розробки Control UI.
|
||||
|
||||
Якщо ви свідомо використовуєте робочий процес Bun, еквівалентні команди такі:
|
||||
|
||||
```bash
|
||||
bun install
|
||||
# Лише під час першого запуску (або після скидання локальних config/workspace OpenClaw)
|
||||
bun run openclaw setup
|
||||
bun run gateway:watch
|
||||
```
|
||||
|
||||
@ -120,60 +126,60 @@ bun run gateway:watch
|
||||
|
||||
### 3) Перевірте
|
||||
|
||||
- У застосунку статус Gateway має показувати **“Using existing gateway …”**
|
||||
- У застосунку статус Gateway має показувати **«Using existing gateway …»**
|
||||
- Або через CLI:
|
||||
|
||||
```bash
|
||||
openclaw health
|
||||
```
|
||||
|
||||
### Поширені пастки
|
||||
### Поширені підводні камені
|
||||
|
||||
- **Неправильний порт:** WS Gateway типово використовує `ws://127.0.0.1:18789`; застосунок і CLI мають використовувати той самий порт.
|
||||
- **Де зберігається стан:**
|
||||
- Стан каналів/провайдерів: `~/.openclaw/credentials/`
|
||||
- Профілі автентифікації моделей: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- Профілі auth моделей: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- Сесії: `~/.openclaw/agents/<agentId>/sessions/`
|
||||
- Журнали: `/tmp/openclaw/`
|
||||
- Логи: `/tmp/openclaw/`
|
||||
|
||||
## Карта зберігання облікових даних
|
||||
|
||||
Використовуйте це під час налагодження автентифікації або щоб вирішити, що слід резервно копіювати:
|
||||
Використовуйте це під час налагодження auth або щоб вирішити, що саме варто резервувати:
|
||||
|
||||
- **WhatsApp**: `~/.openclaw/credentials/whatsapp/<accountId>/creds.json`
|
||||
- **Токен бота Telegram**: config/env або `channels.telegram.tokenFile` (лише звичайний файл; симлінки відхиляються)
|
||||
- **Токен бота Discord**: config/env або SecretRef (провайдери env/file/exec)
|
||||
- **Токен Telegram-бота**: config/env або `channels.telegram.tokenFile` (лише звичайний файл; symlink відхиляються)
|
||||
- **Токен Discord-бота**: config/env або SecretRef (провайдери env/file/exec)
|
||||
- **Токени Slack**: config/env (`channels.slack.*`)
|
||||
- **Списки дозволених для сполучення**:
|
||||
- `~/.openclaw/credentials/<channel>-allowFrom.json` (типовий акаунт)
|
||||
- `~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json` (нетипові акаунти)
|
||||
- **Профілі автентифікації моделей**: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- **Корисне навантаження секретів із файловим бекендом (необов’язково)**: `~/.openclaw/secrets.json`
|
||||
- **Allowlist для парування**:
|
||||
- `~/.openclaw/credentials/<channel>-allowFrom.json` (обліковий запис за замовчуванням)
|
||||
- `~/.openclaw/credentials/<channel>-<accountId>-allowFrom.json` (облікові записи не за замовчуванням)
|
||||
- **Профілі auth моделей**: `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
|
||||
- **Payload секретів, що зберігається у файлі (необов’язково)**: `~/.openclaw/secrets.json`
|
||||
- **Імпорт застарілого OAuth**: `~/.openclaw/credentials/oauth.json`
|
||||
Докладніше: [Безпека](/uk/gateway/security#credential-storage-map).
|
||||
|
||||
## Оновлення (без руйнування вашого налаштування)
|
||||
## Оновлення (не руйнуючи ваше налаштування)
|
||||
|
||||
- Зберігайте `~/.openclaw/workspace` і `~/.openclaw/` як “ваші дані”; не розміщуйте особисті prompts/конфігурацію в репозиторії `openclaw`.
|
||||
- Оновлення source-коду: `git pull` + обраний вами крок встановлення пакетного менеджера (`pnpm install` типово; `bun install` для робочого процесу Bun) + продовжуйте використовувати відповідну команду `gateway:watch`.
|
||||
- Зберігайте `~/.openclaw/workspace` і `~/.openclaw/` як «ваші дані»; не кладіть особисті prompts/config у репозиторій `openclaw`.
|
||||
- Оновлення source: `git pull` + вибраний вами крок встановлення пакетного менеджера (`pnpm install` за замовчуванням; `bun install` для робочого процесу Bun) + і далі використовуйте відповідну команду `gateway:watch`.
|
||||
|
||||
## Linux (сервіс користувача systemd)
|
||||
## Linux (сервіс systemd користувача)
|
||||
|
||||
Установлення на Linux використовують сервіс systemd **user**. Типово systemd зупиняє користувацькі
|
||||
сервіси під час виходу з системи/бездіяльності, що вимикає Gateway. Онбординг намагається увімкнути
|
||||
linger за вас (може запитати sudo). Якщо це все ще вимкнено, виконайте:
|
||||
Встановлення Linux використовують **користувацький** сервіс systemd. Типово systemd зупиняє
|
||||
користувацькі сервіси під час виходу з системи/бездіяльності, що зупиняє Gateway. Онбординг намагається
|
||||
увімкнути lingering за вас (може попросити sudo). Якщо це все ще вимкнено, виконайте:
|
||||
|
||||
```bash
|
||||
sudo loginctl enable-linger $USER
|
||||
```
|
||||
|
||||
Для завжди увімкнених або багатокористувацьких серверів розгляньте **system**-сервіс замість
|
||||
користувацького сервісу (linger не потрібен). Див. [операційний посібник Gateway](/uk/gateway) щодо приміток про systemd.
|
||||
Для серверів, що мають працювати постійно або обслуговувати кількох користувачів, розгляньте **системний** сервіс замість
|
||||
користувацького сервісу (lingering не потрібен). Див. [Інструкцію з експлуатації Gateway](/uk/gateway) щодо приміток про systemd.
|
||||
|
||||
## Пов’язана документація
|
||||
## Пов’язані документи
|
||||
|
||||
- [Операційний посібник Gateway](/uk/gateway) (прапорці, супервізія, порти)
|
||||
- [Конфігурація Gateway](/uk/gateway/configuration) (схема конфігурації + приклади)
|
||||
- [Discord](/uk/channels/discord) і [Telegram](/uk/channels/telegram) (теги відповідей + налаштування replyToMode)
|
||||
- [Налаштування помічника OpenClaw](/start/openclaw)
|
||||
- [Застосунок macOS](/uk/platforms/macos) (життєвий цикл gateway)
|
||||
- [Інструкція з експлуатації Gateway](/uk/gateway) (прапорці, супервізія, порти)
|
||||
- [Конфігурація Gateway](/uk/gateway/configuration) (схема config + приклади)
|
||||
- [Discord](/uk/channels/discord) і [Telegram](/uk/channels/telegram) (теги відповіді + налаштування replyToMode)
|
||||
- [Налаштування асистента OpenClaw](/uk/start/openclaw)
|
||||
- [застосунок macOS](/uk/platforms/macos) (життєвий цикл gateway)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user