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-04-15 14:10:11 +00:00
parent a170452e4b
commit 97f26ad9b2
3 changed files with 308 additions and 303 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

186
docs/uk/providers/ollama.md
View File

@ -5,20 +5,20 @@ read_when:
summary: Запустіть OpenClaw з Ollama (хмарні та локальні моделі)
title: Ollama
x-i18n:
generated_at: "2026-04-12T11:08:31Z"
generated_at: "2026-04-15T14:08:17Z"
model: gpt-5.4
provider: openai
source_hash: ec796241b884ca16ec7077df4f3f1910e2850487bb3ea94f8fdb37c77e02b219
source_hash: 098e083e0fc484bddb5270eb630c55d7832039b462d1710372b6afece5cefcdf
source_path: providers/ollama.md
workflow: 15
---
# Ollama
Ollama — це локальне середовище виконання LLM, яке спрощує запуск моделей з відкритим кодом на вашій машині. OpenClaw інтегрується з нативним API Ollama (`/api/chat`), підтримує потокову передачу та виклик інструментів, а також може автоматично виявляти локальні моделі Ollama, якщо ви ввімкнете це через `OLLAMA_API_KEY` (або профіль автентифікації) і не визначите явний запис `models.providers.ollama`.
OpenClaw інтегрується з нативним API Ollama (`/api/chat`) для розміщених хмарних моделей і локальних/самостійно розміщених серверів Ollama. Ви можете використовувати Ollama у трьох режимах: `Cloud + Local` через доступний хост Ollama, `Cloud only` через `https://ollama.com` або `Local only` через доступний хост Ollama.
<Warning>
**Користувачі віддаленого Ollama**: Не використовуйте OpenAI-сумісну URL-адресу `/v1` (`http://host:11434/v1`) з OpenClaw. Це ламає виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте нативну URL-адресу API Ollama: `baseUrl: "http://host:11434"` (без `/v1`).
**Користувачі віддаленого Ollama**: Не використовуйте OpenAI-сумісний URL `/v1` (`http://host:11434/v1`) з OpenClaw. Це порушує виклик інструментів, і моделі можуть виводити сирий JSON інструментів як звичайний текст. Натомість використовуйте URL нативного API Ollama: `baseUrl: "http://host:11434"` (без `/v1`).
</Warning>
## Початок роботи
@ -27,7 +27,7 @@ Ollama — це локальне середовище виконання LLM, я
<Tabs>
<Tab title="Онбординг (рекомендовано)">
**Найкраще для:** найшвидшого шляху до робочого налаштування Ollama з автоматичним виявленням моделей.
**Найкраще для:** найшвидшого способу налаштувати робочу хмарну або локальну конфігурацію Ollama.
<Steps>
<Step title="Запустіть онбординг">
@ -37,14 +37,13 @@ Ollama — це локальне середовище виконання LLM, я
Виберіть **Ollama** зі списку провайдерів.
</Step>
<Step title="Виберіть свій режим">
- **Cloud + Local** — хмарні моделі та локальні моделі разом
- **Local** — лише локальні моделі
Якщо ви виберете **Cloud + Local** і не ввійшли на ollama.com, онбординг відкриє у браузері процес входу.
<Step title="Виберіть режим">
- **Cloud + Local** — локальний хост Ollama плюс хмарні моделі, що маршрутизуються через цей хост
- **Cloud only** — розміщені моделі Ollama через `https://ollama.com`
- **Local only** — лише локальні моделі
</Step>
<Step title="Виберіть модель">
Онбординг виявляє доступні моделі та пропонує типові варіанти. Він автоматично завантажує вибрану модель, якщо вона недоступна локально.
`Cloud only` запитує `OLLAMA_API_KEY` і пропонує типові хмарні значення за замовчуванням. `Cloud + Local` і `Local only` запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель, якщо вона ще недоступна. `Cloud + Local` також перевіряє, чи виконано вхід на цьому хості Ollama для доступу до хмари.
</Step>
<Step title="Переконайтеся, що модель доступна">
```bash
@ -61,7 +60,7 @@ Ollama — це локальне середовище виконання LLM, я
--accept-risk
```
За потреби вкажіть власну базову URL-адресу або модель:
За потреби вкажіть власний базовий URL або модель:
```bash
openclaw onboard --non-interactive \
@ -74,13 +73,15 @@ Ollama — це локальне середовище виконання LLM, я
</Tab>
<Tab title="Ручне налаштування">
**Найкраще для:** повного контролю над інсталяцією, завантаженням моделей і конфігурацією.
**Найкраще для:** повного контролю над хмарною або локальною конфігурацією.
<Steps>
<Step title="Встановіть Ollama">
Завантажте з [ollama.com/download](https://ollama.com/download).
<Step title="Виберіть хмарний або локальний режим">
- **Cloud + Local**: встановіть Ollama, виконайте вхід через `ollama signin` і маршрутизуйте хмарні запити через цей хост
- **Cloud only**: використовуйте `https://ollama.com` з `OLLAMA_API_KEY`
- **Local only**: встановіть Ollama з [ollama.com/download](https://ollama.com/download)
</Step>
<Step title="Завантажте локальну модель">
<Step title="Завантажте локальну модель (лише Local only)">
```bash
ollama pull gemma4
# або
@ -89,31 +90,27 @@ Ollama — це локальне середовище виконання LLM, я
ollama pull llama3.3
```
</Step>
<Step title="Увійдіть для хмарних моделей (необов’язково)">
Якщо ви також хочете хмарні моделі:
```bash
ollama signin
```
</Step>
<Step title="Увімкніть Ollama для OpenClaw">
Встановіть будь-яке значення для API key (Ollama не потребує справжнього ключа):
Для `Cloud only` використовуйте ваш справжній `OLLAMA_API_KEY`. Для конфігурацій на основі хоста підійде будь-яке значення-заповнювач:
```bash
# Встановити змінну середовища
# Cloud
export OLLAMA_API_KEY="your-ollama-api-key"
# Local-only
export OLLAMA_API_KEY="ollama-local"
# Або налаштувати у вашому файлі конфігурації
openclaw config set models.providers.ollama.apiKey "ollama-local"
# Або налаштуйте у своєму конфігураційному файлі
openclaw config set models.providers.ollama.apiKey "OLLAMA_API_KEY"
```
</Step>
<Step title="Перегляньте та встановіть вашу модель">
<Step title="Перегляньте та встановіть свою модель">
```bash
openclaw models list
openclaw models set ollama/gemma4
```
Або встановіть типову модель у конфігурації:
Або встановіть значення за замовчуванням у конфігурації:
```json5
{
@ -134,20 +131,25 @@ Ollama — це локальне середовище виконання LLM, я
<Tabs>
<Tab title="Cloud + Local">
Хмарні моделі дають змогу запускати моделі, розміщені в хмарі, поряд із вашими локальними моделями. Приклади: `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud` -- для них **не** потрібен локальний `ollama pull`.
`Cloud + Local` використовує доступний хост Ollama як точку керування і для локальних, і для хмарних моделей. Це рекомендований Ollama гібридний сценарій.
Під час налаштування виберіть режим **Cloud + Local**. Майстер перевіряє, чи ви ввійшли в систему, і за потреби відкриває у браузері процес входу. Якщо автентифікацію неможливо перевірити, майстер повертається до типових локальних моделей.
Використовуйте **Cloud + Local** під час налаштування. OpenClaw запитує базовий URL Ollama, виявляє локальні моделі з цього хоста та перевіряє, чи виконано вхід на хості для доступу до хмари через `ollama signin`. Якщо на хості виконано вхід, OpenClaw також пропонує типові розміщені хмарні моделі, такі як `kimi-k2.5:cloud`, `minimax-m2.7:cloud` і `glm-5.1:cloud`.
Ви також можете увійти безпосередньо на [ollama.com/signin](https://ollama.com/signin).
OpenClaw наразі пропонує такі типові хмарні варіанти: `kimi-k2.5:cloud`, `minimax-m2.7:cloud`, `glm-5.1:cloud`.
Якщо на хості ще не виконано вхід, OpenClaw залишає налаштування лише локальним, доки ви не виконаєте `ollama signin`.
</Tab>
<Tab title="Лише локально">
У режимі лише локальних моделей OpenClaw виявляє моделі з локального екземпляра Ollama. Вхід у хмару не потрібен.
<Tab title="Cloud only">
`Cloud only` працює через розміщений API Ollama за адресою `https://ollama.com`.
OpenClaw наразі пропонує `gemma4` як типову локальну модель.
Використовуйте **Cloud only** під час налаштування. OpenClaw запитує `OLLAMA_API_KEY`, встановлює `baseUrl: "https://ollama.com"` і заповнює список розміщених хмарних моделей. Цей шлях **не** потребує локального сервера Ollama або `ollama signin`.
</Tab>
<Tab title="Local only">
У режимі лише локального використання OpenClaw виявляє моделі з налаштованого екземпляра Ollama. Цей шлях призначений для локальних або самостійно розміщених серверів Ollama.
Наразі OpenClaw пропонує `gemma4` як локальну модель за замовчуванням.
</Tab>
</Tabs>
@ -156,19 +158,19 @@ Ollama — це локальне середовище виконання LLM, я
Коли ви встановлюєте `OLLAMA_API_KEY` (або профіль автентифікації) і **не** визначаєте `models.providers.ollama`, OpenClaw виявляє моделі з локального екземпляра Ollama за адресою `http://127.0.0.1:11434`.
| Поведінка | Деталі |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Запит каталогу | Виконує запити до `/api/tags` |
| Виявлення можливостей | Використовує найкращі доступні запити `/api/show`, щоб зчитати `contextWindow` і виявити можливості (зокрема vision) |
| Vision-моделі | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як такі, що підтримують зображення (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення до запиту |
| Виявлення reasoning | Позначає `reasoning` за евристикою назви моделі (`r1`, `reasoning`, `think`) |
| Обмеження токенів | Встановлює `maxTokens` на типове максимальне обмеження токенів Ollama, яке використовує OpenClaw |
| Вартість | Встановлює всі вартості в `0` |
| Поведінка | Докладно |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Запит каталогу | Виконує запити до `/api/tags` |
| Визначення можливостей | Використовує найкращі зусилля для запитів `/api/show`, щоб зчитати `contextWindow` і визначити можливості (зокрема vision) |
| Vision-моделі | Моделі з можливістю `vision`, про яку повідомляє `/api/show`, позначаються як такі, що підтримують зображення (`input: ["text", "image"]`), тому OpenClaw автоматично додає зображення до запиту |
| Визначення reasoning | Позначає `reasoning` за евристикою назви моделі (`r1`, `reasoning`, `think`) |
| Ліміти токенів | Встановлює `maxTokens` на типовий максимальний ліміт токенів Ollama, який використовує OpenClaw |
| Вартість | Встановлює всі вартості в `0` |
Це дає змогу уникнути ручного додавання моделей і водночас зберігати каталог узгодженим із локальним екземпляром Ollama.
Це дає змогу уникнути ручного додавання моделей, водночас зберігаючи каталог узгодженим із локальним екземпляром Ollama.
```bash
# Переглянути, які моделі доступні
# Перегляньте, які моделі доступні
ollama list
openclaw models list
```
@ -182,45 +184,45 @@ ollama pull mistral
Нова модель буде автоматично виявлена та стане доступною для використання.
<Note>
Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і вам потрібно визначити моделі вручну. Дивіться розділ про явну конфігурацію нижче.
Якщо ви явно задаєте `models.providers.ollama`, автоматичне виявлення пропускається, і ви маєте визначити моделі вручну. Дивіться розділ явної конфігурації нижче.
</Note>
## Конфігурація
<Tabs>
<Tab title="Базова (неявне виявлення)">
Найпростіший спосіб увімкнути Ollama — через змінну середовища:
Найпростіший спосіб увімкнути режим лише локального використання — через змінну середовища:
```bash
export OLLAMA_API_KEY="ollama-local"
```
<Tip>
Якщо встановлено `OLLAMA_API_KEY`, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності.
Якщо `OLLAMA_API_KEY` встановлено, ви можете не вказувати `apiKey` у записі провайдера, і OpenClaw підставить його для перевірок доступності.
</Tip>
</Tab>
<Tab title="Явна (ручні моделі)">
Використовуйте явну конфігурацію, коли Ollama працює на іншому хості/порту, ви хочете примусово задати певні розміри контекстного вікна або списки моделей, або вам потрібні повністю ручні визначення моделей.
Використовуйте явну конфігурацію, якщо вам потрібне розміщене хмарне налаштування, Ollama працює на іншому хості або порту, ви хочете примусово задати конкретні контекстні вікна чи списки моделей, або вам потрібні повністю ручні визначення моделей.
```json5
{
models: {
providers: {
ollama: {
baseUrl: "http://ollama-host:11434",
apiKey: "ollama-local",
baseUrl: "https://ollama.com",
apiKey: "OLLAMA_API_KEY",
api: "ollama",
models: [
{
id: "gpt-oss:20b",
name: "GPT-OSS 20B",
id: "kimi-k2.5:cloud",
name: "kimi-k2.5:cloud",
reasoning: false,
input: ["text"],
input: ["text", "image"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 8192,
maxTokens: 8192 * 10
contextWindow: 128000,
maxTokens: 8192
}
]
}
@ -231,8 +233,8 @@ ollama pull mistral
</Tab>
<Tab title="Власна базова URL-адреса">
Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому визначте моделі вручну):
<Tab title="Власний базовий URL">
Якщо Ollama працює на іншому хості або порту (явна конфігурація вимикає автоматичне виявлення, тому моделі потрібно визначати вручну):
```json5
{
@ -240,7 +242,7 @@ ollama pull mistral
providers: {
ollama: {
apiKey: "ollama-local",
baseUrl: "http://ollama-host:11434", // Без /v1 — використовуйте нативну URL-адресу API Ollama
baseUrl: "http://ollama-host:11434", // Без /v1 - використовуйте URL нативного API Ollama
api: "ollama", // Вкажіть явно, щоб гарантувати нативну поведінку виклику інструментів
},
},
@ -249,7 +251,7 @@ ollama pull mistral
```
<Warning>
Не додавайте `/v1` до URL-адреси. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів ненадійний. Використовуйте базову URL-адресу Ollama без суфікса шляху.
Не додавайте `/v1` до URL. Шлях `/v1` використовує OpenAI-сумісний режим, у якому виклик інструментів ненадійний. Використовуйте базовий URL Ollama без суфікса шляху.
</Warning>
</Tab>
@ -272,17 +274,17 @@ ollama pull mistral
}
```
## Ollama Web Search
## Вебпошук Ollama
OpenClaw підтримує **Ollama Web Search** як вбудований провайдер `web_search`.
OpenClaw підтримує **Вебпошук Ollama** як вбудований провайдер `web_search`.
| Властивість | Деталі |
| ----------- | -------------------------------------------------------------------------------------------------------------------- |
| Властивість | Докладно |
| ----------- | ----------------------------------------------------------------------------------------------------------------- |
| Хост | Використовує налаштований хост Ollama (`models.providers.ollama.baseUrl`, якщо задано, інакше `http://127.0.0.1:11434`) |
| Автентифікація | Без ключа |
| Вимога | Ollama має бути запущений, і потрібно виконати вхід через `ollama signin` |
| Автентифікація | Без ключа |
| Вимога | Ollama має працювати, і в ньому має бути виконано вхід через `ollama signin` |
Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або задайте:
Виберіть **Ollama Web Search** під час `openclaw onboard` або `openclaw configure --section web`, або встановіть:
```json5
{
@ -297,7 +299,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
```
<Note>
Повний опис налаштування та деталей поведінки дивіться в [Ollama Web Search](/uk/tools/ollama-search).
Повні відомості про налаштування та поведінку дивіться в [Ollama Web Search](/uk/tools/ollama-search).
</Note>
## Розширена конфігурація
@ -305,10 +307,10 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
<AccordionGroup>
<Accordion title="Застарілий OpenAI-сумісний режим">
<Warning>
**Виклик інструментів ненадійний в OpenAI-сумісному режимі.** Використовуйте цей режим лише тоді, коли вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів.
**Виклик інструментів ненадійний в OpenAI-сумісному режимі.** Використовуйте цей режим лише якщо вам потрібен формат OpenAI для проксі й ви не залежите від нативної поведінки виклику інструментів.
</Warning>
Якщо вам все ж потрібно використовувати OpenAI-сумісну кінцеву точку (наприклад, за проксі, який підтримує лише формат OpenAI), явно задайте `api: "openai-completions"`:
Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку замість цього (наприклад, за проксі, який підтримує лише формат OpenAI), явно встановіть `api: "openai-completions"`:
```json5
{
@ -317,7 +319,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
ollama: {
baseUrl: "http://ollama-host:11434/v1",
api: "openai-completions",
injectNumCtxForOpenAICompat: true, // default: true
injectNumCtxForOpenAICompat: true, // за замовчуванням: true
apiKey: "ollama-local",
models: [...]
}
@ -326,9 +328,9 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
}
```
У цьому режимі потокова передача та виклик інструментів можуть не підтримуватися одночасно. Можливо, вам доведеться вимкнути потокову передачу через `params: { streaming: false }` у конфігурації моделі.
Цей режим може не підтримувати одночасно потокову передачу та виклик інструментів. Можливо, вам доведеться вимкнути потокову передачу за допомогою `params: { streaming: false }` у конфігурації моделі.
Коли `api: "openai-completions"` використовується з Ollama, OpenClaw типово додає `options.num_ctx`, щоб Ollama не переходив мовчки до контекстного вікна 4096. Якщо ваш проксі/апстрим відхиляє невідомі поля `options`, вимкніть цю поведінку:
Коли `api: "openai-completions"` використовується з Ollama, OpenClaw за замовчуванням додає `options.num_ctx`, щоб Ollama не переходив непомітно до контекстного вікна 4096. Якщо ваш проксі або upstream відхиляє невідомі поля `options`, вимкніть цю поведінку:
```json5
{
@ -349,7 +351,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Контекстні вікна">
Для автоматично виявлених моделей OpenClaw використовує розмір контекстного вікна, який повідомляє Ollama, а якщо він недоступний — повертається до типового контекстного вікна Ollama, яке використовує OpenClaw.
Для автоматично виявлених моделей OpenClaw використовує контекстне вікно, про яке повідомляє Ollama, якщо воно доступне; інакше використовується типове контекстне вікно Ollama, яке застосовує OpenClaw.
Ви можете перевизначити `contextWindow` і `maxTokens` у явній конфігурації провайдера:
@ -374,29 +376,29 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Моделі reasoning">
OpenClaw типово вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning.
OpenClaw за замовчуванням вважає моделі з назвами на кшталт `deepseek-r1`, `reasoning` або `think` такими, що підтримують reasoning.
```bash
ollama pull deepseek-r1:32b
```
Додаткова конфігурація не потрібна -- OpenClaw позначає їх автоматично.
Жодна додаткова конфігурація не потрібна — OpenClaw позначає їх автоматично.
</Accordion>
<Accordion title="Вартість моделей">
Ollama є безкоштовним і працює локально, тому вартість усіх моделей встановлена в $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
Ollama є безкоштовним і працює локально, тому для всіх моделей вартість встановлено в $0. Це стосується як автоматично виявлених, так і вручну визначених моделей.
</Accordion>
<Accordion title="Ембедінги пам’яті">
Вбудований Plugin Ollama реєструє провайдер ембедінгів пам’яті для
[пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштовану базову URL-адресу Ollama
та API key.
Вбудований Plugin Ollama реєструє провайдера ембедінгів пам’яті для
[пошуку в пам’яті](/uk/concepts/memory). Він використовує налаштований базовий URL Ollama
та API-ключ.
| Властивість | Значення |
| --------------- | ------------------- |
| Типова модель | `nomic-embed-text` |
| Автозавантаження | Так — модель ембедінгів завантажується автоматично, якщо її немає локально |
| Властивість | Значення |
| ------------- | ------------------- |
| Типова модель | `nomic-embed-text` |
| Автозавантаження | Так — модель ембедінгів автоматично завантажується, якщо її немає локально |
Щоб вибрати Ollama як провайдера ембедінгів для пошуку в пам’яті:
@ -413,7 +415,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Конфігурація потокової передачі">
Інтеграція Ollama в OpenClaw типово використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодна спеціальна конфігурація не потрібна.
Інтеграція Ollama в OpenClaw за замовчуванням використовує **нативний API Ollama** (`/api/chat`), який повністю підтримує одночасно потокову передачу та виклик інструментів. Жодна спеціальна конфігурація не потрібна.
<Tip>
Якщо вам потрібно використовувати OpenAI-сумісну кінцеву точку, дивіться розділ "Застарілий OpenAI-сумісний режим" вище. У цьому режимі потокова передача та виклик інструментів можуть не працювати одночасно.
@ -432,7 +434,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
ollama serve
```
Перевірте, що API доступний:
Переконайтеся, що API доступний:
```bash
curl http://localhost:11434/api/tags
@ -441,7 +443,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="Немає доступних моделей">
Якщо ваша модель не відображається у списку, або завантажте її локально, або визначте її явно в `models.providers.ollama`.
Якщо вашу модель не вказано у списку, або завантажте її локально, або явно визначте її в `models.providers.ollama`.
```bash
ollama list # Переглянути, що встановлено
@ -453,7 +455,7 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
</Accordion>
<Accordion title="У з’єднанні відмовлено">
Перевірте, що Ollama працює на правильному порту:
Перевірте, що Ollama запущено на правильному порту:
```bash
# Перевірити, чи запущено Ollama
@ -474,13 +476,13 @@ OpenClaw підтримує **Ollama Web Search** як вбудований пр
<CardGroup cols={2}>
<Card title="Провайдери моделей" href="/uk/concepts/model-providers" icon="layers">
Огляд усіх провайдерів, посилань на моделі та поведінки failover.
Огляд усіх провайдерів, посилань на моделі та поведінки перемикання при відмові.
</Card>
<Card title="Вибір моделі" href="/uk/concepts/models" icon="brain">
Як вибирати та налаштовувати моделі.
</Card>
<Card title="Ollama Web Search" href="/uk/tools/ollama-search" icon="magnifying-glass">
Повні відомості про налаштування та поведінку вебпошуку на базі Ollama.
Повні відомості про налаштування та поведінку вебпошуку на основі Ollama.
</Card>
<Card title="Конфігурація" href="/uk/gateway/configuration" icon="gear">
Повний довідник із конфігурації.

189
docs/uk/reference/wizard.md
View File

@ -4,13 +4,13 @@ read_when:
- Автоматизація онбордингу в неінтерактивному режимі
- Налагодження поведінки онбордингу
sidebarTitle: Onboarding Reference
summary: 'Повний довідник з онбордингу в CLI: кожен крок, прапорець і поле конфігурації'
summary: 'Повний довідник з CLI-онбордингу: кожен крок, прапорець і поле конфігурації'
title: Довідник з онбордингу
x-i18n:
generated_at: "2026-04-06T15:32:00Z"
generated_at: "2026-04-15T14:08:02Z"
model: gpt-5.4
provider: openai
source_hash: a142b9ec4323fabb9982d05b64375d2b4a4007dffc910acbee3a38ff871a7236
source_hash: 1db3ff789422617634e6624f9d12c18b6a6c573721226b9c0fa6f6b7956ef33d
source_path: reference/wizard.md
workflow: 15
---
@ -18,132 +18,133 @@ x-i18n:
# Довідник з онбордингу
Це повний довідник для `openclaw onboard`.
Огляд високого рівня див. у [Onboarding (CLI)](/uk/start/wizard).
Огляд високого рівня див. у [Онбординг (CLI)](/uk/start/wizard).
## Докладно про потік (локальний режим)
## Деталі процесу (локальний режим)
<Steps>
<Step title="Виявлення наявної конфігурації">
- Якщо існує `~/.openclaw/openclaw.json`, виберіть **Keep / Modify / Reset**.
- Повторний запуск онбордингу **не** стирає нічого, якщо ви явно не виберете **Reset**
- Якщо `~/.openclaw/openclaw.json` існує, виберіть **Зберегти / Змінити / Скинути**.
- Повторний запуск онбордингу **не** стирає нічого, якщо ви явно не виберете **Скинути**
(або не передасте `--reset`).
- CLI `--reset` типово використовує `config+creds+sessions`; використовуйте `--reset-scope full`,
- CLI `--reset` за замовчуванням використовує `config+creds+sessions`; використовуйте `--reset-scope full`,
щоб також видалити workspace.
- Якщо конфігурація недійсна або містить застарілі ключі, майстер зупиняється і просить
вас запустити `openclaw doctor`, перш ніж продовжувати.
- Reset використовує `trash` (ніколи не `rm`) і пропонує такі області:
- Якщо конфігурація невалідна або містить застарілі ключі, майстер зупиняється і просить
вас запустити `openclaw doctor` перед продовженням.
- Скидання використовує `trash` (ніколи не `rm`) і пропонує області:
- Лише конфігурація
- Конфігурація + облікові дані + сеанси
- Повний скидання (також видаляє workspace)
- Конфігурація + облікові дані + сесії
- Повне скидання (також видаляє workspace)
</Step>
<Step title="Модель/автентифікація">
- **API-ключ Anthropic**: використовує `ANTHROPIC_API_KEY`, якщо він наявний, або запитує ключ, а потім зберігає його для використання демоном.
- **API-ключ Anthropic**: бажаний варіант Anthropic assistant в onboarding/configure.
- **Anthropic setup-token**: усе ще доступний в onboarding/configure, хоча OpenClaw тепер надає перевагу повторному використанню Claude CLI, коли це можливо.
- **Підписка OpenAI Code (Codex) (Codex CLI)**: якщо існує `~/.codex/auth.json`, онбординг може повторно використати його. Повторно використані облікові дані Codex CLI і далі керуються Codex CLI; після завершення строку дії OpenClaw спочатку знову читає це джерело і, коли постачальник може його оновити, записує оновлені облікові дані назад у сховище Codex замість того, щоб перебирати керування на себе.
- **Ключ API Anthropic**: використовує `ANTHROPIC_API_KEY`, якщо він наявний, або запитує ключ, а потім зберігає його для використання демоном.
- **Ключ API Anthropic**: бажаний вибір помічника Anthropic в онбордингу/налаштуванні.
- **Anthropic setup-token**: усе ще доступний в онбордингу/налаштуванні, хоча OpenClaw тепер надає перевагу повторному використанню Claude CLI, коли це можливо.
- **Підписка OpenAI Code (Codex) (Codex CLI)**: якщо `~/.codex/auth.json` існує, онбординг може повторно використати її. Повторно використані облікові дані Codex CLI і далі керуються Codex CLI; після завершення строку дії OpenClaw спочатку знову читає це джерело і, коли провайдер може їх оновити, записує оновлені облікові дані назад у сховище Codex замість того, щоб самостійно брати їх під своє керування.
- **Підписка OpenAI Code (Codex) (OAuth)**: потік через браузер; вставте `code#state`.
- Встановлює `agents.defaults.model` у `openai-codex/gpt-5.4`, коли модель не задана або має вигляд `openai/*`.
- **API-ключ OpenAI**: використовує `OPENAI_API_KEY`, якщо він наявний, або запитує ключ, а потім зберігає його в профілях автентифікації.
- Встановлює `agents.defaults.model` у `openai/gpt-5.4`, коли модель не задана, має вигляд `openai/*` або `openai-codex/*`.
- **API-ключ xAI (Grok)**: запитує `XAI_API_KEY` і налаштовує xAI як постачальника моделей.
- Встановлює `agents.defaults.model` у `openai-codex/gpt-5.4`, якщо модель не задана або має вигляд `openai/*`.
- **Ключ API OpenAI**: використовує `OPENAI_API_KEY`, якщо він наявний, або запитує ключ, а потім зберігає його в профілях автентифікації.
- Встановлює `agents.defaults.model` у `openai/gpt-5.4`, якщо модель не задана, має вигляд `openai/*` або `openai-codex/*`.
- **Ключ API xAI (Grok)**: запитує `XAI_API_KEY` і налаштовує xAI як провайдера моделей.
- **OpenCode**: запитує `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`, отримайте його на https://opencode.ai/auth) і дає змогу вибрати каталог Zen або Go.
- **Ollama**: запитує базову URL-адресу Ollama, пропонує режим **Cloud + Local** або **Local**, виявляє доступні моделі та автоматично завантажує вибрану локальну модель, якщо це потрібно.
- **Ollama**: спочатку пропонує **Cloud + Local**, **Лише Cloud** або **Лише Local**. `Cloud only` запитує `OLLAMA_API_KEY` і використовує `https://ollama.com`; режими з підтримкою хоста запитують базовий URL Ollama, виявляють доступні моделі та автоматично завантажують вибрану локальну модель за потреби; `Cloud + Local` також перевіряє, чи цей хост Ollama увійшов у cloud-доступ.
- Докладніше: [Ollama](/uk/providers/ollama)
- **API key**: зберігає ключ за вас.
- **Vercel AI Gateway (багатомодельний proxy)**: запитує `AI_GATEWAY_API_KEY`.
- **Ключ API**: зберігає ключ за вас.
- **Vercel AI Gateway (багатомодельний проксі)**: запитує `AI_GATEWAY_API_KEY`.
- Докладніше: [Vercel AI Gateway](/uk/providers/vercel-ai-gateway)
- **Cloudflare AI Gateway**: запитує Account ID, Gateway ID і `CLOUDFLARE_AI_GATEWAY_API_KEY`.
- Докладніше: [Cloudflare AI Gateway](/uk/providers/cloudflare-ai-gateway)
- **MiniMax**: конфігурація записується автоматично; типовим хостинговим значенням є `MiniMax-M2.7`.
Налаштування з API-ключем використовує `minimax/...`, а налаштування з OAuth — `minimax-portal/...`.
- **MiniMax**: конфігурація записується автоматично; hosted-значення за замовчуванням — `MiniMax-M2.7`.
Налаштування через ключ API використовує `minimax/...`, а налаштування через OAuth —
`minimax-portal/...`.
- Докладніше: [MiniMax](/uk/providers/minimax)
- **StepFun**: конфігурація автоматично записується для стандартного StepFun або Step Plan на китайських чи глобальних кінцевих точках.
- Стандарт зараз включає `step-3.5-flash`, а Step Plan також включає `step-3.5-flash-2603`.
- **StepFun**: конфігурація записується автоматично для стандартного StepFun або Step Plan на китайських чи глобальних ендпойнтах.
- Наразі стандартний набір містить `step-3.5-flash`, а Step Plan також містить `step-3.5-flash-2603`.
- Докладніше: [StepFun](/uk/providers/stepfun)
- **Synthetic (сумісний з Anthropic)**: запитує `SYNTHETIC_API_KEY`.
- Докладніше: [Synthetic](/uk/providers/synthetic)
- **Moonshot (Kimi K2)**: конфігурація записується автоматично.
- **Kimi Coding**: конфігурація записується автоматично.
- Докладніше: [Moonshot AI (Kimi + Kimi Coding)](/uk/providers/moonshot)
- **Skip**: автентифікація поки не налаштована.
- Виберіть типову модель із виявлених варіантів (або введіть provider/model вручну). Для найкращої якості та нижчого ризику ін’єкцій у prompt вибирайте найсильнішу модель останнього покоління, доступну у вашому стеку постачальників.
- Онбординг запускає перевірку моделі й попереджає, якщо налаштована модель невідома або для неї бракує автентифікації.
- Режим зберігання API-ключів типово використовує plaintext-значення в профілях автентифікації. Використовуйте `--secret-input-mode ref`, щоб натомість зберігати посилання на основі env (наприклад, `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`).
- Профілі автентифікації розміщуються в `~/.openclaw/agents/<agentId>/agent/auth-profiles.json` (API-ключі + OAuth). `~/.openclaw/credentials/oauth.json` — лише застаріле джерело імпорту.
- **Пропустити**: автентифікацію ще не налаштовано.
- Виберіть модель за замовчуванням із виявлених варіантів (або введіть provider/model вручну). Для найкращої якості та нижчого ризику prompt injection вибирайте найсильнішу модель останнього покоління, доступну у вашому стеку провайдерів.
- Онбординг запускає перевірку моделі та попереджає, якщо налаштована модель невідома або бракує автентифікації.
- Режим зберігання ключів API за замовчуванням — це значення профілю автентифікації у відкритому тексті. Використовуйте `--secret-input-mode ref`, щоб натомість зберігати посилання на env (наприклад, `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`).
- Профілі автентифікації зберігаються в `~/.openclaw/agents/<agentId>/agent/auth-profiles.json` (ключі API + OAuth). `~/.openclaw/credentials/oauth.json` — це застаріле джерело лише для імпорту.
- Докладніше: [/concepts/oauth](/uk/concepts/oauth)
<Note>
Порада для безголових серверів: завершіть OAuth на машині з браузером, а потім скопіюйте
Порада для headless/server: завершіть OAuth на машині з браузером, а потім скопіюйте
`auth-profiles.json` цього агента (наприклад,
`~/.openclaw/agents/<agentId>/agent/auth-profiles.json` або відповідний
шлях `$OPENCLAW_STATE_DIR/...`) на хост gateway. `credentials/oauth.json`
шлях `$OPENCLAW_STATE_DIR/...`) на хост Gateway. `credentials/oauth.json`
є лише застарілим джерелом імпорту.
</Note>
</Step>
<Step title="Workspace">
- Типово `~/.openclaw/workspace` (можна налаштувати).
- Ініціалізує файли workspace, потрібні для ритуалу початкового запуску агента.
- Повну структуру workspace та посібник із резервного копіювання див. тут: [Agent workspace](/uk/concepts/agent-workspace)
- За замовчуванням `~/.openclaw/workspace` (можна налаштувати).
- Створює у workspace файли, потрібні для ритуалу початкового запуску агента.
- Повна структура workspace + довідник із резервного копіювання: [Робочий простір агента](/uk/concepts/agent-workspace)
</Step>
<Step title="Gateway">
- Порт, bind, режим автентифікації, відкриття через Tailscale.
- Рекомендація щодо автентифікації: зберігайте **Token** навіть для loopback, щоб локальні WS-клієнти мали проходити автентифікацію.
- Порт, bind, режим автентифікації, експонування через Tailscale.
- Рекомендація щодо автентифікації: залишайте **Token** навіть для loopback, щоб локальні WS-клієнти мали проходити автентифікацію.
- У режимі token інтерактивне налаштування пропонує:
- **Згенерувати/зберегти plaintext token** (типово)
- **Використовувати SecretRef** (opt-in)
- Quickstart повторно використовує наявні SecretRef `gateway.auth.token` через постачальників `env`, `file` і `exec` для bootstrap probe/dashboard під час онбордингу.
- Якщо цей SecretRef налаштовано, але його не вдається розв’язати, онбординг завершується помилкою на ранньому етапі з чітким повідомленням щодо виправлення замість тихого погіршення runtime-автентифікації.
- У режимі password інтерактивне налаштування також підтримує зберігання у plaintext або через SecretRef.
- Шлях SecretRef token у неінтерактивному режимі: `--gateway-token-ref-env <ENV_VAR>`.
- Потребує непорожньої змінної середовища в оточенні процесу онбордингу.
- **Згенерувати/зберегти token у відкритому тексті** (типово)
- **Використати SecretRef** (опційно)
- Quickstart повторно використовує наявні SecretRef `gateway.auth.token` у провайдерах `env`, `file` і `exec` для probe/dashboard bootstrap під час онбордингу.
- Якщо цей SecretRef налаштовано, але його неможливо розв’язати, онбординг завершується помилкою на ранньому етапі з чітким повідомленням про виправлення замість тихого погіршення автентифікації під час виконання.
- У режимі password інтерактивне налаштування також підтримує зберігання у відкритому тексті або через SecretRef.
- Шлях SecretRef для token у неінтерактивному режимі: `--gateway-token-ref-env <ENV_VAR>`.
- Вимагає непорожню змінну середовища в середовищі процесу онбордингу.
- Не можна поєднувати з `--gateway-token`.
- Вимикайте автентифікацію лише якщо ви повністю довіряєте кожному локальному процесу.
- Прив’язки не до loopback усе одно вимагають автентифікації.
- Bind не до loopback усе одно вимагає автентифікації.
</Step>
<Step title="Канали">
- [WhatsApp](/uk/channels/whatsapp): необов’язковий вхід через QR.
- [Telegram](/uk/channels/telegram): токен бота.
- [Discord](/uk/channels/discord): токен бота.
- [Google Chat](/uk/channels/googlechat): JSON облікового запису служби + webhook audience.
- [Mattermost](/uk/channels/mattermost) (плагін): токен бота + базова URL-адреса.
- [Telegram](/uk/channels/telegram): token бота.
- [Discord](/uk/channels/discord): token бота.
- [Google Chat](/uk/channels/googlechat): JSON service account + webhook audience.
- [Mattermost](/uk/channels/mattermost) (Plugin): token бота + базовий URL.
- [Signal](/uk/channels/signal): необов’язкове встановлення `signal-cli` + конфігурація облікового запису.
- [BlueBubbles](/uk/channels/bluebubbles): **рекомендовано для iMessage**; URL-адреса сервера + пароль + webhook.
- [iMessage](/uk/channels/imessage): застарілий шлях CLI `imsg` + доступ до БД.
- Безпека DM: типово використовується pairing. Перше DM надсилає код; підтвердіть через `openclaw pairing approve <channel> <code>` або використовуйте allowlists.
- [BlueBubbles](/uk/channels/bluebubbles): **рекомендовано для iMessage**; URL сервера + пароль + webhook.
- [iMessage](/uk/channels/imessage): застарілий шлях до `imsg` CLI + доступ до БД.
- Безпека приватних повідомлень: за замовчуванням використовується pairing. Перше приватне повідомлення надсилає код; схваліть його через `openclaw pairing approve <channel> <code>` або використовуйте allowlist.
</Step>
<Step title="Вебпошук">
- Виберіть підтримуваного постачальника, наприклад Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG або Tavily (або пропустіть).
- Постачальники з API можуть використовувати змінні середовища або наявну конфігурацію для швидкого налаштування; постачальники без ключа натомість використовують свої специфічні передумови.
- Пропустіть за допомогою `--skip-search`.
- Виберіть підтримуваного провайдера, наприклад Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG або Tavily (або пропустіть).
- Провайдери з API можуть використовувати змінні середовища або наявну конфігурацію для швидкого налаштування; провайдери без ключів використовують натомість власні передумови.
- Пропустити: `--skip-search`.
- Налаштувати пізніше: `openclaw configure --section web`.
</Step>
<Step title="Встановлення демона">
- macOS: LaunchAgent
- Потребує активної користувацької сесії; для безголового режиму використовуйте власний LaunchDaemon (не постачається).
- Потрібна сесія користувача, що увійшов у систему; для headless використовуйте власний LaunchDaemon (не постачається).
- Linux (і Windows через WSL2): systemd user unit
- Онбординг намагається ввімкнути lingering через `loginctl enable-linger <user>`, щоб Gateway залишався запущеним після виходу з сеансу.
- Може запросити sudo (записує у `/var/lib/systemd/linger`); спочатку пробує без sudo.
- **Вибір runtime:** Node (рекомендовано; обов’язково для WhatsApp/Telegram). Bun **не рекомендовано**.
- Якщо для автентифікації token потрібен token і `gateway.auth.token` керується через SecretRef, встановлення демона перевіряє його, але не зберігає розв’язані plaintext-значення token у метаданих середовища служби супервізора.
- Якщо для автентифікації token потрібен token, а налаштований SecretRef token не розв’язується, встановлення демона блокується з практичними підказками.
- Якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не задано, встановлення демона блокується, доки режим не буде явно вказано.
- Онбординг намагається ввімкнути lingering через `loginctl enable-linger <user>`, щоб Gateway залишався активним після виходу із системи.
- Може запросити sudo (записує в `/var/lib/systemd/linger`); спочатку пробує без sudo.
- **Вибір runtime:** Node (рекомендовано; потрібен для WhatsApp/Telegram). Bun **не рекомендовано**.
- Якщо автентифікація token вимагає token, а `gateway.auth.token` керується через SecretRef, встановлення демона перевіряє його, але не зберігає розв’язані значення token у відкритому тексті в метаданих середовища служби супервізора.
- Якщо автентифікація token вимагає token, а налаштований token SecretRef не розв’язується, встановлення демона блокується з практичними вказівками.
- Якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не задано, встановлення демона блокується, доки режим не буде задано явно.
</Step>
<Step title="Перевірка стану">
- Запускає Gateway (за потреби) і виконує `openclaw health`.
- Порада: `openclaw status --deep` додає живу перевірку стану gateway до виводу status, зокрема probe каналів, коли вони підтримуються (потрібен доступний gateway).
- Порада: `openclaw status --deep` додає live-probe стану Gateway до виводу статусу, зокрема probe каналів, коли це підтримується (потрібен доступний Gateway).
</Step>
<Step title="Skills (рекомендовано)">
- Зчитує доступні Skills і перевіряє вимоги.
- Дає змогу вибрати менеджер node: **npm / pnpm** (bun не рекомендовано).
- Дає змогу вибрати менеджер Node: **npm / pnpm** (bun не рекомендовано).
- Встановлює необов’язкові залежності (деякі використовують Homebrew на macOS).
</Step>
<Step title="Завершення">
- Підсумок + наступні кроки, зокрема застосунки для iOS/Android/macOS для додаткових функцій.
- Підсумок + наступні кроки, зокрема застосунки iOS/Android/macOS для додаткових можливостей.
</Step>
</Steps>
<Note>
Якщо графічний інтерфейс не виявлено, онбординг друкує інструкції для переспрямування портів SSH для Control UI замість відкриття браузера.
Якщо ресурси Control UI відсутні, онбординг намагається зібрати їх; резервний варіант — `pnpm ui:build` (автоматично встановлює UI-залежності).
Якщо GUI не виявлено, онбординг виводить інструкції з SSH port-forward для Control UI замість відкриття браузера.
Якщо ресурси Control UI відсутні, онбординг намагається їх зібрати; резервний варіант — `pnpm ui:build` (автоматично встановлює залежності UI).
</Note>
## Неінтерактивний режим
@ -164,7 +165,7 @@ openclaw onboard --non-interactive \
Додайте `--json` для машинозчитуваного підсумку.
SecretRef token gateway у неінтерактивному режимі:
Gateway token SecretRef у неінтерактивному режимі:
```bash
export OPENCLAW_GATEWAY_TOKEN="your-token"
@ -175,16 +176,16 @@ openclaw onboard --non-interactive \
--gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN
```
`--gateway-token` і `--gateway-token-ref-env` є взаємовиключними.
`--gateway-token` і `--gateway-token-ref-env` взаємовиключні.
<Note>
`--json` **не** означає неінтерактивний режим. Для скриптів використовуйте `--non-interactive` (і `--workspace`).
</Note>
Приклади команд для конкретних постачальників наведені в [CLI Automation](/uk/start/wizard-cli-automation#provider-specific-examples).
Командні приклади для конкретних провайдерів наведено в [Автоматизація CLI](/uk/start/wizard-cli-automation#provider-specific-examples).
Використовуйте цю довідкову сторінку для семантики прапорців і порядку кроків.
### Додавання агента (неінтерактивно)
### Додати агента (неінтерактивно)
```bash
openclaw agents add work \
@ -197,22 +198,22 @@ openclaw agents add work \
## RPC майстра Gateway
Gateway надає потік онбордингу через RPC (`wizard.start`, `wizard.next`, `wizard.cancel`, `wizard.status`).
Клієнти (застосунок macOS, Control UI) можуть відображати кроки, не реалізуючи повторно логіку онбордингу.
Gateway надає процес онбордингу через RPC (`wizard.start`, `wizard.next`, `wizard.cancel`, `wizard.status`).
Клієнти (застосунок macOS, Control UI) можуть відображати кроки без повторної реалізації логіки онбордингу.
## Налаштування Signal (`signal-cli`)
## Налаштування Signal (signal-cli)
Онбординг може встановлювати `signal-cli` з релізів GitHub:
Онбординг може встановити `signal-cli` з GitHub releases:
- Завантажує відповідний asset релізу.
- Завантажує відповідний release asset.
- Зберігає його в `~/.openclaw/tools/signal-cli/<version>/`.
- Записує `channels.signal.cliPath` у вашу конфігурацію.
Примітки:
- Збірки JVM потребують **Java 21**.
- Якщо доступні, використовуються native-збірки.
- Windows використовує WSL2; встановлення signal-cli дотримується linux-потоку всередині WSL.
- Збірки JVM вимагають **Java 21**.
- Нативні збірки використовуються, коли вони доступні.
- Windows використовує WSL2; встановлення signal-cli виконується за Linux-сценарієм усередині WSL.
## Що записує майстер
@ -220,14 +221,14 @@ Gateway надає потік онбордингу через RPC (`wizard.start
- `agents.defaults.workspace`
- `agents.defaults.model` / `models.providers` (якщо вибрано Minimax)
- `tools.profile` (локальний онбординг типово встановлює `"coding"`, якщо значення не задано; наявні явні значення зберігаються)
- `tools.profile` (локальний онбординг за замовчуванням встановлює `"coding"`, якщо значення не задано; наявні явно вказані значення зберігаються)
- `gateway.*` (mode, bind, auth, tailscale)
- `session.dmScope` (докладно про поведінку: [CLI Setup Reference](/uk/start/wizard-cli-reference#outputs-and-internals))
- `session.dmScope` (деталі поведінки: [Довідник із налаштування CLI](/uk/start/wizard-cli-reference#outputs-and-internals))
- `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
- Channel allowlists (Slack/Discord/Matrix/Microsoft Teams), якщо ви погодилися на них під час підказок (імена за можливості розв’язуються в ID).
- Списки дозволених каналів (Slack/Discord/Matrix/Microsoft Teams), якщо ви погоджуєтеся на це під час підказок (імена за можливості зіставляються з ID).
- `skills.install.nodeManager`
- `setup --node-manager` приймає `npm`, `pnpm` або `bun`.
- Ручна конфігурація все ще може використовувати `yarn`, якщо напряму встановити `skills.install.nodeManager`.
- У ручній конфігурації все ще можна використовувати `yarn`, безпосередньо встановивши `skills.install.nodeManager`.
- `wizard.lastRunAt`
- `wizard.lastRunVersion`
- `wizard.lastRunCommit`
@ -236,16 +237,16 @@ Gateway надає потік онбордингу через RPC (`wizard.start
`openclaw agents add` записує `agents.list[]` і необов’язкові `bindings`.
Облікові дані WhatsApp розміщуються в `~/.openclaw/credentials/whatsapp/<accountId>/`.
Сеанси зберігаються в `~/.openclaw/agents/<agentId>/sessions/`.
Облікові дані WhatsApp зберігаються в `~/.openclaw/credentials/whatsapp/<accountId>/`.
Сесії зберігаються в `~/.openclaw/agents/<agentId>/sessions/`.
Деякі канали постачаються як plugins. Коли ви вибираєте один із них під час налаштування, онбординг
Деякі канали постачаються як Plugin. Коли ви вибираєте один із них під час налаштування, онбординг
запропонує встановити його (npm або локальний шлях), перш ніж його можна буде налаштувати.
## Пов’язана документація
- Огляд онбордингу: [Onboarding (CLI)](/uk/start/wizard)
- Онбординг у застосунку macOS: [Onboarding](/uk/start/onboarding)
- Довідник із конфігурації: [Gateway configuration](/uk/gateway/configuration)
- Постачальники: [WhatsApp](/uk/channels/whatsapp), [Telegram](/uk/channels/telegram), [Discord](/uk/channels/discord), [Google Chat](/uk/channels/googlechat), [Signal](/uk/channels/signal), [BlueBubbles](/uk/channels/bluebubbles) (iMessage), [iMessage](/uk/channels/imessage) (застарілий)
- Skills: [Skills](/uk/tools/skills), [Skills config](/uk/tools/skills-config)
- Огляд онбордингу: [Онбординг (CLI)](/uk/start/wizard)
- Онбординг застосунку macOS: [Онбординг](/uk/start/onboarding)
- Довідник із конфігурації: [Конфігурація Gateway](/uk/gateway/configuration)
- Провайдери: [WhatsApp](/uk/channels/whatsapp), [Telegram](/uk/channels/telegram), [Discord](/uk/channels/discord), [Google Chat](/uk/channels/googlechat), [Signal](/uk/channels/signal), [BlueBubbles](/uk/channels/bluebubbles) (iMessage), [iMessage](/uk/channels/imessage) (застаріле)
- Skills: [Skills](/uk/tools/skills), [Конфігурація Skills](/uk/tools/skills-config)

236
docs/uk/start/wizard-cli-reference.md
View File

@ -1,118 +1,118 @@
---
read_when:
- Потрібна детальна поведінка для openclaw onboard
- Вам потрібна детальна поведінка для `openclaw onboard`
- Ви налагоджуєте результати онбордингу або інтегруєте клієнти онбордингу
sidebarTitle: CLI reference
summary: Повний довідник щодо процесу налаштування CLI, налаштування auth/моделей, результатів і внутрішньої логіки
title: Довідник з налаштування CLI
summary: Повний довідник щодо потоку налаштування CLI, налаштування автентифікації/моделі, вихідних даних і внутрішньої реалізації
title: Довідник із налаштування CLI
x-i18n:
generated_at: "2026-04-05T18:18:40Z"
generated_at: "2026-04-15T14:08:05Z"
model: gpt-5.4
provider: openai
source_hash: 92f379b34a2b48c68335dae4f759117c770f018ec51b275f4f40421c6b3abb23
source_hash: 61ca679caca3b43fa02388294007f89db22d343e49e10b61d8d118cd8fbb7369
source_path: start/wizard-cli-reference.md
workflow: 15
---
# Довідник з налаштування CLI
# Довідник із налаштування CLI
Ця сторінка — повний довідник для `openclaw onboard`.
Короткий посібник див. у [Onboarding (CLI)](/start/wizard).
Ця сторінка є повним довідником для `openclaw onboard`.
Короткий посібник дивіться в [Онбординг (CLI)](/uk/start/wizard).
## Що робить майстер
Локальний режим (типово) проводить вас через:
Локальний режим (типовий) проводить вас через:
- Налаштування моделі та auth (OAuth для підписки OpenAI Code, Anthropic Claude CLI або API key, а також варіанти для MiniMax, GLM, Ollama, Moonshot, StepFun і AI Gateway)
- Налаштування моделі та автентифікації (OAuth підписки OpenAI Code, Anthropic Claude CLI або API-ключ, а також варіанти MiniMax, GLM, Ollama, Moonshot, StepFun і AI Gateway)
- Розташування робочого простору та bootstrap-файли
- Налаштування Gateway (порт, bind, auth, tailscale)
- Налаштування Gateway (порт, bind, автентифікація, Tailscale)
- Канали та провайдери (Telegram, WhatsApp, Discord, Google Chat, Mattermost, Signal, BlueBubbles та інші вбудовані channel plugins)
- Встановлення демона (LaunchAgent, systemd user unit або нативне Windows Scheduled Task із запасним варіантом через Startup folder)
- Перевірка стану
- Встановлення демона (LaunchAgent, systemd user unit або нативне Windows Scheduled Task із резервним варіантом через папку Startup)
- Перевірка справності
- Налаштування Skills
Віддалений режим налаштовує цю машину для підключення до gateway в іншому місці.
Віддалений режим налаштовує цю машину на підключення до Gateway в іншому місці.
Він не встановлює та не змінює нічого на віддаленому хості.
## Деталі локального процесу
## Подробиці локального потоку
<Steps>
<Step title="Виявлення наявної конфігурації">
- Якщо `~/.openclaw/openclaw.json` існує, виберіть Keep, Modify або Reset.
- Повторний запуск майстра нічого не стирає, якщо ви явно не виберете Reset (або не передасте `--reset`).
- CLI `--reset` типово використовує `config+creds+sessions`; використайте `--reset-scope full`, щоб також видалити робочий простір.
- Якщо конфігурація недійсна або містить застарілі ключі, майстер зупиняється й просить запустити `openclaw doctor`, перш ніж продовжити.
- Reset використовує `trash` і пропонує такі області:
- Якщо існує `~/.openclaw/openclaw.json`, виберіть Зберегти, Змінити або Скинути.
- Повторний запуск майстра нічого не стирає, якщо ви явно не виберете Скинути (або не передасте `--reset`).
- CLI `--reset` типово використовує `config+creds+sessions`; щоб також видалити робочий простір, використовуйте `--reset-scope full`.
- Якщо конфігурація недійсна або містить застарілі ключі, майстер зупиняється й просить вас запустити `openclaw doctor` перед продовженням.
- Скидання використовує `trash` і пропонує області:
- Лише конфігурація
- Конфігурація + облікові дані + сесії
- Повне скидання (також видаляє робочий простір)
</Step>
<Step title="Модель і auth">
- Повна матриця варіантів наведена в [Варіанти auth і моделей](#auth-and-model-options).
<Step title="Модель і автентифікація">
- Повна матриця варіантів наведена в [Параметри автентифікації та моделі](#auth-and-model-options).
</Step>
<Step title="Робочий простір">
- Типово `~/.openclaw/workspace` (можна змінити).
- Ініціалізує файли робочого простору, потрібні для bootstrap-ритуалу першого запуску.
- Типово `~/.openclaw/workspace` (можна налаштувати).
- Створює файли робочого простору, потрібні для bootstrap-ритуалу першого запуску.
- Структура робочого простору: [Робочий простір агента](/uk/concepts/agent-workspace).
</Step>
<Step title="Gateway">
- Запитує порт, bind, режим auth і експонування через tailscale.
- Рекомендовано: залишити token auth увімкненим навіть для loopback, щоб локальні WS-клієнти мусили проходити автентифікацію.
- Запитує порт, bind, режим автентифікації та доступність через Tailscale.
- Рекомендовано: залишати автентифікацію за токеном увімкненою навіть для loopback, щоб локальні WS-клієнти мусили автентифікуватися.
- У режимі токена інтерактивне налаштування пропонує:
- **Згенерувати/зберегти plaintext token** (типово)
- **Використати SecretRef** (за бажанням)
- У режимі пароля інтерактивне налаштування також підтримує зберігання у plaintext або через SecretRef.
- Неінтерактивний шлях для SecretRef токена: `--gateway-token-ref-env <ENV_VAR>`.
- **Згенерувати/зберегти відкритий токен** (типово)
- **Використати SecretRef** (необов’язково)
- У режимі пароля інтерактивне налаштування також підтримує збереження у відкритому вигляді або через SecretRef.
- Шлях SecretRef для неінтерактивного режиму токена: `--gateway-token-ref-env <ENV_VAR>`.
- Потребує непорожньої змінної середовища в середовищі процесу онбордингу.
- Не може поєднуватися з `--gateway-token`.
- Вимикайте auth лише якщо повністю довіряєте кожному локальному процесу.
- Bind не на loopback однаково потребує auth.
- Не можна поєднувати з `--gateway-token`.
- Вимикайте автентифікацію лише якщо повністю довіряєте кожному локальному процесу.
- Bind не лише на loopback однаково вимагає автентифікації.
</Step>
<Step title="Канали">
- [WhatsApp](/uk/channels/whatsapp): необов’язковий QR-логін
- [WhatsApp](/uk/channels/whatsapp): необов’язковий вхід через QR
- [Telegram](/uk/channels/telegram): токен бота
- [Discord](/uk/channels/discord): токен бота
- [Google Chat](/uk/channels/googlechat): JSON service account + webhook audience
- [Google Chat](/uk/channels/googlechat): JSON сервісного облікового запису + аудиторія Webhook
- [Mattermost](/uk/channels/mattermost): токен бота + базовий URL
- [Signal](/uk/channels/signal): необов’язкове встановлення `signal-cli` + конфігурація облікового запису
- [BlueBubbles](/uk/channels/bluebubbles): рекомендовано для iMessage; URL сервера + пароль + webhook
- [iMessage](/uk/channels/imessage): застарілий шлях до CLI `imsg` + доступ до БД
- Безпека DM: типово використовується pairing. Перше DM надсилає код; схваліть через
- [BlueBubbles](/uk/channels/bluebubbles): рекомендовано для iMessage; URL сервера + пароль + Webhook
- [iMessage](/uk/channels/imessage): застарілий шлях CLI `imsg` + доступ до БД
- Безпека DM: типово використовується прив’язка. Перше DM надсилає код; схваліть його через
`openclaw pairing approve <channel> <code>` або використовуйте allowlist.
</Step>
<Step title="Встановлення демона">
- macOS: LaunchAgent
- Потребує сеансу користувача, який увійшов у систему; для headless використовуйте власний LaunchDaemon (не постачається).
- Потребує сесії користувача з входом; для headless використовуйте власний LaunchDaemon (не постачається).
- Linux і Windows через WSL2: systemd user unit
- Майстер намагається виконати `loginctl enable-linger <user>`, щоб gateway залишався запущеним після виходу з системи.
- Може попросити sudo (записує в `/var/lib/systemd/linger`); спершу пробує без sudo.
- Майстер намагається виконати `loginctl enable-linger <user>`, щоб Gateway залишався активним після виходу з системи.
- Може запросити sudo (записує в `/var/lib/systemd/linger`); спочатку пробує без sudo.
- Нативний Windows: спочатку Scheduled Task
- Якщо створення завдання заборонено, OpenClaw переходить до per-user login item у Startup folder і негайно запускає gateway.
- Scheduled Tasks залишаються пріоритетними, бо забезпечують кращий статус supervisor.
- Якщо створення завдання заборонено, OpenClaw переходить на резервний варіант із per-user елементом входу в папці Startup і відразу запускає Gateway.
- Scheduled Tasks залишаються кращим варіантом, бо забезпечують кращий статус супервізора.
- Вибір середовища виконання: Node (рекомендовано; обов’язково для WhatsApp і Telegram). Bun не рекомендується.
</Step>
<Step title="Перевірка стану">
- Запускає gateway (за потреби) і виконує `openclaw health`.
- `openclaw status --deep` додає до виводу статусу live-перевірку стану gateway, включно з перевірками каналів, коли вони підтримуються.
<Step title="Перевірка справності">
- Запускає Gateway (за потреби) і виконує `openclaw health`.
- `openclaw status --deep` додає до виводу статусу перевірку справності живого Gateway, включно з перевірками каналів, коли це підтримується.
</Step>
<Step title="Skills">
- Зчитує доступні Skills і перевіряє вимоги.
- Дозволяє вибрати менеджер node: npm, pnpm або bun.
- Дозволяє вибрати менеджер Node: npm, pnpm або bun.
- Встановлює необов’язкові залежності (деякі використовують Homebrew на macOS).
</Step>
<Step title="Завершення">
- Підсумок і наступні кроки, включно з варіантами для iOS, Android і macOS app.
- Підсумок і наступні кроки, включно з варіантами для застосунків iOS, Android і macOS.
</Step>
</Steps>
<Note>
Якщо GUI не виявлено, майстер виводить інструкції з переадресації SSH-порту для Control UI замість відкриття браузера.
Якщо ресурси Control UI відсутні, майстер намагається їх зібрати; запасний варіант — `pnpm ui:build` (автоматично встановлює залежності UI).
Якщо GUI не виявлено, майстер виводить інструкції з SSH-переадресації порту для Control UI замість відкриття браузера.
Якщо ресурси Control UI відсутні, майстер намагається їх зібрати; резервний варіант — `pnpm ui:build` (автоматично встановлює залежності UI).
</Note>
## Деталі віддаленого режиму
## Подробиці віддаленого режиму
Віддалений режим налаштовує цю машину для підключення до gateway в іншому місці.
Віддалений режим налаштовує цю машину на підключення до Gateway в іншому місці.
<Info>
Віддалений режим не встановлює та не змінює нічого на віддаленому хості.
@ -120,49 +120,49 @@ x-i18n:
Що ви налаштовуєте:
- URL віддаленого gateway (`ws://...`)
- Token, якщо віддалений gateway потребує auth (рекомендовано)
- URL віддаленого Gateway (`ws://...`)
- Токен, якщо віддалений Gateway вимагає автентифікації (рекомендовано)
<Note>
- Якщо gateway доступний лише через loopback, використовуйте SSH-тунелювання або tailnet.
- Якщо Gateway доступний лише через loopback, використовуйте SSH-тунелювання або tailnet.
- Підказки для виявлення:
- macOS: Bonjour (`dns-sd`)
- Linux: Avahi (`avahi-browse`)
</Note>
## Варіанти auth і моделей
## Параметри автентифікації та моделі
<AccordionGroup>
<Accordion title="API key Anthropic">
Використовує `ANTHROPIC_API_KEY`, якщо він присутній, або запитує ключ, а потім зберігає його для використання демоном.
<Accordion title="API-ключ Anthropic">
Використовує `ANTHROPIC_API_KEY`, якщо він наявний, або запитує ключ, а потім зберігає його для використання демоном.
</Accordion>
<Accordion title="Підписка OpenAI Code (повторне використання Codex CLI)">
Якщо `~/.codex/auth.json` існує, майстер може використати його повторно.
Якщо існує `~/.codex/auth.json`, майстер може повторно використати його.
Повторно використані облікові дані Codex CLI і далі керуються Codex CLI; після завершення строку дії OpenClaw
спочатку повторно зчитує це джерело і, коли провайдер може їх оновити, записує
спочатку знову читає це джерело і, коли провайдер може його оновити, записує
оновлені облікові дані назад у сховище Codex замість того, щоб брати керування
на себе.
ними на себе.
</Accordion>
<Accordion title="Підписка OpenAI Code (OAuth)">
Потік у браузері; вставте `code#state`.
Потік через браузер; вставте `code#state`.
Установлює `agents.defaults.model` у `openai-codex/gpt-5.4`, коли модель не задана або має вигляд `openai/*`.
Встановлює `agents.defaults.model` у `openai-codex/gpt-5.4`, коли модель не задана або має вигляд `openai/*`.
</Accordion>
<Accordion title="API key OpenAI">
Використовує `OPENAI_API_KEY`, якщо він присутній, або запитує ключ, а потім зберігає облікові дані в профілях auth.
<Accordion title="API-ключ OpenAI">
Використовує `OPENAI_API_KEY`, якщо він наявний, або запитує ключ, а потім зберігає облікові дані в профілях автентифікації.
Установлює `agents.defaults.model` у `openai/gpt-5.4`, коли модель не задана, має вигляд `openai/*` або `openai-codex/*`.
Встановлює `agents.defaults.model` у `openai/gpt-5.4`, коли модель не задана, має вигляд `openai/*` або `openai-codex/*`.
</Accordion>
<Accordion title="API key xAI (Grok)">
<Accordion title="API-ключ xAI (Grok)">
Запитує `XAI_API_KEY` і налаштовує xAI як провайдера моделі.
</Accordion>
<Accordion title="OpenCode">
Запитує `OPENCODE_API_KEY` (або `OPENCODE_ZEN_API_KEY`) і дозволяє вибрати каталог Zen або Go.
URL налаштування: [opencode.ai/auth](https://opencode.ai/auth).
</Accordion>
<Accordion title="API key (загальний)">
<Accordion title="API-ключ (загальний)">
Зберігає ключ для вас.
</Accordion>
<Accordion title="Vercel AI Gateway">
@ -170,11 +170,11 @@ x-i18n:
Докладніше: [Vercel AI Gateway](/uk/providers/vercel-ai-gateway).
</Accordion>
<Accordion title="Cloudflare AI Gateway">
Запитує ID облікового запису, ID gateway і `CLOUDFLARE_AI_GATEWAY_API_KEY`.
Запитує ID облікового запису, ID Gateway і `CLOUDFLARE_AI_GATEWAY_API_KEY`.
Докладніше: [Cloudflare AI Gateway](/uk/providers/cloudflare-ai-gateway).
</Accordion>
<Accordion title="MiniMax">
Конфігурація записується автоматично. Типова хостована модель — `MiniMax-M2.7`; налаштування через API key використовує
Конфігурація записується автоматично. Розміщений типово варіант — `MiniMax-M2.7`; налаштування через API-ключ використовує
`minimax/...`, а налаштування через OAuth — `minimax-portal/...`.
Докладніше: [MiniMax](/uk/providers/minimax).
</Accordion>
@ -188,82 +188,84 @@ x-i18n:
Докладніше: [Synthetic](/uk/providers/synthetic).
</Accordion>
<Accordion title="Ollama (Cloud і локальні відкриті моделі)">
Запитує базовий URL (типово `http://127.0.0.1:11434`), а потім пропонує режим Cloud + Local або Local.
Виявляє доступні моделі та пропонує типові варіанти.
Спочатку запитує `Cloud + Local`, `Cloud only` або `Local only`.
`Cloud only` використовує `OLLAMA_API_KEY` з `https://ollama.com`.
Режими з опорою на хост запитують базовий URL (типово `http://127.0.0.1:11434`), виявляють доступні моделі та пропонують типові варіанти.
`Cloud + Local` також перевіряє, чи цей хост Ollama увійшов у систему для доступу до cloud.
Докладніше: [Ollama](/uk/providers/ollama).
</Accordion>
<Accordion title="Moonshot і Kimi Coding">
Конфігурації Moonshot (Kimi K2) і Kimi Coding записуються автоматично.
Докладніше: [Moonshot AI (Kimi + Kimi Coding)](/uk/providers/moonshot).
</Accordion>
<Accordion title="Користувацький провайдер">
Працює з endpoints, сумісними з OpenAI та Anthropic.
<Accordion title="Власний провайдер">
Працює з endpoint, сумісними з OpenAI і Anthropic.
Інтерактивний онбординг підтримує такі самі варіанти зберігання API key, як і інші потоки API key провайдерів:
- **Вставити API key зараз** (plaintext)
- **Використати посилання на секрет** (env ref або налаштоване provider ref з попередньою перевіркою)
Інтерактивний онбординг підтримує ті самі варіанти збереження API-ключа, що й інші потоки API-ключів провайдерів:
- **Вставити API-ключ зараз** (у відкритому вигляді)
- **Використати secret reference** (посилання на env або налаштованого провайдера, з попередньою перевіркою)
Неінтерактивні прапорці:
Прапорці неінтерактивного режиму:
- `--auth-choice custom-api-key`
- `--custom-base-url`
- `--custom-model-id`
- `--custom-api-key` (необов’язково; використовує `CUSTOM_API_KEY`, якщо прапорець не задано)
- `--custom-api-key` (необов’язково; резервний варіант — `CUSTOM_API_KEY`)
- `--custom-provider-id` (необов’язково)
- `--custom-compatibility <openai|anthropic>` (необов’язково; типово `openai`)
</Accordion>
<Accordion title="Пропустити">
Залишає auth неналаштованим.
Залишає автентифікацію неналаштованою.
</Accordion>
</AccordionGroup>
Поведінка моделі:
- Виберіть типову модель із виявлених варіантів або вручну введіть провайдера та модель.
- Коли онбординг починається з вибору auth провайдера, засіб вибору моделі автоматично надає
перевагу цьому провайдеру. Для Volcengine і BytePlus така сама перевага
- Виберіть типову модель із виявлених варіантів або введіть провайдера й модель вручну.
- Коли онбординг починається з вибору автентифікації провайдера, засіб вибору моделі автоматично надає перевагу
цьому провайдеру. Для Volcengine і BytePlus та сама перевага
також поширюється на їхні варіанти coding-plan (`volcengine-plan/*`,
`byteplus-plan/*`).
- Якщо цей фільтр бажаного провайдера виявиться порожнім, засіб вибору повертається
до повного каталогу, а не показує порожній список моделей.
- Майстер виконує перевірку моделі та попереджає, якщо налаштована модель невідома або для неї відсутній auth.
- Якщо цей фільтр за пріоритетним провайдером буде порожнім, засіб вибору повертається
до повного каталогу замість того, щоб не показувати жодних моделей.
- Майстер запускає перевірку моделі та попереджає, якщо налаштована модель невідома або для неї відсутня автентифікація.
Шляхи до облікових даних і профілів:
- Профілі auth (API keys + OAuth): `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- Профілі автентифікації (API-ключі + OAuth): `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- Імпорт застарілого OAuth: `~/.openclaw/credentials/oauth.json`
Режим зберігання облікових даних:
- Типова поведінка онбордингу зберігає API keys як plaintext-значення в профілях auth.
- `--secret-input-mode ref` вмикає режим посилань замість зберігання plaintext-ключів.
В інтерактивному налаштуванні можна вибрати один із двох варіантів:
- Типова поведінка онбордингу зберігає API-ключі як відкриті значення в профілях автентифікації.
- `--secret-input-mode ref` вмикає режим посилань замість зберігання ключів у відкритому вигляді.
В інтерактивному налаштуванні можна вибрати один із варіантів:
- посилання на змінну середовища (наприклад, `keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" }`)
- налаштоване provider ref (`file` або `exec`) з псевдонімом провайдера + id
- посилання на налаштованого провайдера (`file` або `exec`) з псевдонімом провайдера та id
- Інтерактивний режим посилань виконує швидку попередню перевірку перед збереженням.
- Env refs: перевіряє назву змінної та непорожнє значення в поточному середовищі онбордингу.
- Provider refs: перевіряє конфігурацію провайдера та резолює запитаний id.
- Якщо попередня перевірка не проходить, онбординг показує помилку й дозволяє повторити спробу.
- У неінтерактивному режимі `--secret-input-mode ref` підтримує лише варіант із env.
- Env-посилання: перевіряє назву змінної та непорожнє значення в поточному середовищі онбордингу.
- Посилання на провайдера: перевіряє конфігурацію провайдера та розв’язує запитаний id.
- Якщо попередня перевірка не вдається, онбординг показує помилку й дозволяє повторити спробу.
- У неінтерактивному режимі `--secret-input-mode ref` підтримує лише варіант через env.
- Установіть змінну середовища провайдера в середовищі процесу онбордингу.
- Вбудовані прапорці ключів (наприклад, `--openai-api-key`) вимагають, щоб цю env-змінну було встановлено; інакше онбординг завершується швидкою помилкою.
- Для користувацьких провайдерів неінтерактивний режим `ref` зберігає `models.providers.<id>.apiKey` як `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`.
- У випадку такого користувацького провайдера `--custom-api-key` вимагає, щоб `CUSTOM_API_KEY` було встановлено; інакше онбординг завершується швидкою помилкою.
- Облікові дані auth gateway підтримують вибір між plaintext і SecretRef в інтерактивному налаштуванні:
- Режим токена: **Згенерувати/зберегти plaintext token** (типово) або **Використати SecretRef**.
- Режим пароля: plaintext або SecretRef.
- Неінтерактивний шлях для SecretRef токена: `--gateway-token-ref-env <ENV_VAR>`.
- Наявні налаштування з plaintext і далі працюють без змін.
- Вбудовані прапорці ключів (наприклад, `--openai-api-key`) вимагають, щоб цю змінну середовища було задано; інакше онбординг завершується з помилкою одразу.
- Для власних провайдерів неінтерактивний режим `ref` зберігає `models.providers.<id>.apiKey` як `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`.
- У випадку з таким власним провайдером `--custom-api-key` вимагає, щоб `CUSTOM_API_KEY` було задано; інакше онбординг завершується з помилкою одразу.
- Облікові дані автентифікації Gateway підтримують вибір між відкритим зберіганням і SecretRef в інтерактивному налаштуванні:
- Режим токена: **Згенерувати/зберегти відкритий токен** (типово) або **Використати SecretRef**.
- Режим пароля: відкритий вигляд або SecretRef.
- Шлях SecretRef для неінтерактивного режиму токена: `--gateway-token-ref-env <ENV_VAR>`.
- Наявні налаштування з відкритим зберіганням і далі працюють без змін.
<Note>
Порада для headless і серверних середовищ: завершіть OAuth на машині з браузером, а потім скопіюйте
Порада для headless і серверів: завершіть OAuth на машині з браузером, а потім скопіюйте
`auth-profiles.json` цього агента (наприклад,
`~/.openclaw/agents/<agentId>/agent/auth-profiles.json` або відповідний
шлях `$OPENCLAW_STATE_DIR/...`) на хост gateway. `credentials/oauth.json`
є лише джерелом для імпорту застарілих даних.
`~/.openclaw/agents/<agentId>/agent/auth-profiles.json` або відповідний шлях
`$OPENCLAW_STATE_DIR/...`) на хост Gateway. `credentials/oauth.json`
є лише застарілим джерелом імпорту.
</Note>
## Результати та внутрішня логіка
## Вихідні дані та внутрішня реалізація
Типові поля в `~/.openclaw/openclaw.json`:
@ -273,10 +275,10 @@ x-i18n:
- `gateway.*` (mode, bind, auth, tailscale)
- `session.dmScope` (локальний онбординг типово встановлює `per-channel-peer`, якщо значення не задано; наявні явні значення зберігаються)
- `channels.telegram.botToken`, `channels.discord.token`, `channels.matrix.*`, `channels.signal.*`, `channels.imessage.*`
- Allowlist каналів (Slack, Discord, Matrix, Microsoft Teams), якщо ви вмикаєте їх під час підказок (імена резолюються в ID, коли це можливо)
- Allowlist каналів (Slack, Discord, Matrix, Microsoft Teams), якщо ви погоджуєтеся під час запитів (імена за можливості зіставляються з ID)
- `skills.install.nodeManager`
- Прапорець `setup --node-manager` приймає `npm`, `pnpm` або `bun`.
- Ручна конфігурація все ще може пізніше встановити `skills.install.nodeManager: "yarn"`.
- Ручна конфігурація все одно може пізніше встановити `skills.install.nodeManager: "yarn"`.
- `wizard.lastRunAt`
- `wizard.lastRunVersion`
- `wizard.lastRunCommit`
@ -290,7 +292,7 @@ x-i18n:
<Note>
Деякі канали постачаються як plugins. Якщо їх вибрано під час налаштування, майстер
запропонує встановити plugin (npm або локальний шлях) перед конфігурацією каналу.
пропонує встановити plugin (npm або локальний шлях) перед конфігурацією каналу.
</Note>
RPC майстра Gateway:
@ -300,19 +302,19 @@ RPC майстра Gateway:
- `wizard.cancel`
- `wizard.status`
Клієнти (macOS app і Control UI) можуть відображати кроки без повторної реалізації логіки онбордингу.
Клієнти (застосунок macOS і Control UI) можуть відображати кроки без повторної реалізації логіки онбордингу.
Поведінка налаштування Signal:
- Завантажує відповідний release asset
- Завантажує відповідний ресурс релізу
- Зберігає його в `~/.openclaw/tools/signal-cli/<version>/`
- Записує `channels.signal.cliPath` у конфігурацію
- Збірки JVM потребують Java 21
- За наявності використовуються нативні збірки
- Windows використовує WSL2 і дотримується Linux-процесу signal-cli всередині WSL
- Нативні збірки використовуються, коли вони доступні
- Windows використовує WSL2 і дотримується Linux-потоку `signal-cli` всередині WSL
## Пов’язані документи
- Хаб онбордингу: [Onboarding (CLI)](/start/wizard)
- Автоматизація та скрипти: [Автоматизація CLI](/start/wizard-cli-automation)
- Центр онбордингу: [Онбординг (CLI)](/uk/start/wizard)
- Автоматизація та скрипти: [Автоматизація CLI](/uk/start/wizard-cli-automation)
- Довідник команд: [`openclaw onboard`](/cli/onboard)