---
read_when:
    - Запуск або налаштування онбордингу CLI
    - Налаштування нового комп’ютера
sidebarTitle: 'Onboarding: CLI'
summary: 'CLI-онбординг: кероване налаштування Gateway, робочого простору, каналів і Skills'
title: Початкове налаштування (CLI)
x-i18n:
    generated_at: "2026-04-28T11:26:45Z"
    model: gpt-5.5
    provider: openai
    source_hash: 9e9ee3af82ab9f4a1af5d20e3680eb932a9428cb914bbc08c9a2bf83c94ec158
    source_path: start/wizard.md
    workflow: 16
---

CLI-онбординг — **рекомендований** спосіб налаштувати OpenClaw на macOS,
Linux або Windows (через WSL2; наполегливо рекомендовано).
Він налаштовує локальний Gateway або підключення до віддаленого Gateway, а також канали, Skills
і типові параметри робочого простору в одному керованому процесі.

```bash
openclaw onboard
```

<Info>
Найшвидший перший чат: відкрийте інтерфейс керування (налаштування каналу не потрібне). Виконайте
`openclaw dashboard` і спілкуйтеся в браузері. Документація: [Панель керування](/uk/web/dashboard).
</Info>

Щоб переналаштувати пізніше:

```bash
openclaw configure
openclaw agents add <name>
```

<Note>
`--json` не означає неінтерактивний режим. Для скриптів використовуйте `--non-interactive`.
</Note>

<Tip>
CLI-онбординг містить крок вебпошуку, де можна вибрати провайдера,
наприклад Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search,
Ollama Web Search, Perplexity, SearXNG або Tavily. Деякі провайдери потребують
API-ключ, а інші працюють без ключа. Це також можна налаштувати пізніше за допомогою
`openclaw configure --section web`. Документація: [Вебінструменти](/uk/tools/web).
</Tip>

## QuickStart чи розширений режим

Онбординг починається з вибору між **QuickStart** (типові параметри) і **розширеним режимом** (повний контроль).

<Tabs>
  <Tab title="QuickStart (типові параметри)">
    - Локальний Gateway (loopback)
    - Типовий робочий простір (або наявний робочий простір)
    - Порт Gateway **18789**
    - Автентифікація Gateway **Token** (згенерований автоматично, навіть на loopback)
    - Типова політика інструментів для нових локальних налаштувань: `tools.profile: "coding"` (наявний явно заданий профіль зберігається)
    - Типова ізоляція DM: локальний онбординг записує `session.dmScope: "per-channel-peer"`, якщо значення не задано. Докладніше: [Довідник із налаштування CLI](/uk/start/wizard-cli-reference#outputs-and-internals)
    - Експонування через Tailscale **вимкнено**
    - DM у Telegram + WhatsApp типово використовують **список дозволених** (вам буде запропоновано ввести номер телефону)

  </Tab>
  <Tab title="Розширений режим (повний контроль)">
    - Відкриває кожен крок (режим, робочий простір, Gateway, канали, daemon, Skills).

  </Tab>
</Tabs>

## Що налаштовує онбординг

**Локальний режим (типовий)** проводить вас через такі кроки:

1. **Модель/автентифікація** — виберіть будь-якого підтримуваного провайдера або процес автентифікації (API-ключ, OAuth або ручну автентифікацію, специфічну для провайдера), включно з Custom Provider
   (OpenAI-сумісний, Anthropic-сумісний або автоматичне визначення Unknown). Виберіть типову модель.
   Примітка щодо безпеки: якщо цей агент запускатиме інструменти або оброблятиме вміст Webhook/hooks, віддавайте перевагу найсильнішій доступній моделі останнього покоління й тримайте політику інструментів суворою. Слабші/старіші рівні легше піддаються prompt injection.
   Для неінтерактивних запусків `--secret-input-mode ref` зберігає посилання на основі env в auth profiles замість відкритих значень API-ключів.
   У неінтерактивному режимі `ref` env var провайдера має бути задана; передавання inline-прапорів ключа без цієї env var швидко завершується помилкою.
   В інтерактивних запусках вибір режиму посилання на секрет дає змогу вказати або змінну середовища, або налаштоване посилання провайдера (`file` або `exec`), зі швидкою preflight-перевіркою перед збереженням.
   Для Anthropic інтерактивний онбординг/configure пропонує **Anthropic Claude CLI** як бажаний локальний шлях і **API-ключ Anthropic** як рекомендований production-шлях. Anthropic setup-token також залишається доступним як підтримуваний шлях автентифікації токеном.
2. **Робочий простір** — розташування файлів агента (типово `~/.openclaw/workspace`). Створює початкові bootstrap-файли.
3. **Gateway** — порт, адреса прив’язки, режим автентифікації, експонування через Tailscale.
   В інтерактивному режимі токена виберіть типове зберігання токена відкритим текстом або ввімкніть SecretRef.
   Шлях SecretRef для неінтерактивного токена: `--gateway-token-ref-env <ENV_VAR>`.
4. **Канали** — вбудовані й bundled канали чату, такі як BlueBubbles, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp тощо.
5. **Daemon** — встановлює LaunchAgent (macOS), користувацький unit systemd (Linux/WSL2) або нативне Windows Scheduled Task із резервним варіантом через Startup-folder для користувача.
   Якщо для автентифікації токеном потрібен токен і `gateway.auth.token` керується SecretRef, встановлення daemon перевіряє його, але не зберігає розв’язаний токен у метаданих середовища supervisor service.
   Якщо для автентифікації токеном потрібен токен і налаштований token SecretRef не розв’язано, встановлення daemon блокується з практичними вказівками.
   Якщо налаштовано і `gateway.auth.token`, і `gateway.auth.password`, а `gateway.auth.mode` не задано, встановлення daemon блокується, доки режим не буде задано явно.
6. **Перевірка стану** — запускає Gateway і перевіряє, що він працює.
7. **Skills** — встановлює рекомендовані Skills і необов’язкові залежності.

<Note>
Повторний запуск онбордингу **не** видаляє нічого, якщо ви явно не виберете **Reset** (або не передасте `--reset`).
CLI `--reset` типово застосовується до конфігурації, облікових даних і сеансів; використовуйте `--reset-scope full`, щоб включити робочий простір.
Якщо конфігурація недійсна або містить застарілі ключі, онбординг спершу попросить виконати `openclaw doctor`.
</Note>

**Віддалений режим** лише налаштовує локальний клієнт для підключення до Gateway в іншому місці.
Він **не** встановлює й не змінює нічого на віддаленому хості.

## Додати іншого агента

Використовуйте `openclaw agents add <name>`, щоб створити окремого агента з власним робочим простором,
сеансами й auth profiles. Запуск без `--workspace` запускає онбординг.

Що він задає:

- `agents.list[].name`
- `agents.list[].workspace`
- `agents.list[].agentDir`

Примітки:

- Типові робочі простори мають вигляд `~/.openclaw/workspace-<agentId>`.
- Додайте `bindings`, щоб маршрутизувати вхідні повідомлення (онбординг може це зробити).
- Неінтерактивні прапори: `--model`, `--agent-dir`, `--bind`, `--non-interactive`.

## Повний довідник

Докладний покроковий розбір і вихідні дані конфігурації див. у
[Довіднику з налаштування CLI](/uk/start/wizard-cli-reference).
Неінтерактивні приклади див. у [Автоматизації CLI](/uk/start/wizard-cli-automation).
Глибший технічний довідник, включно з деталями RPC, див. у
[Довіднику з онбордингу](/uk/reference/wizard).

## Пов’язана документація

- Довідник команд CLI: [`openclaw onboard`](/uk/cli/onboard)
- Огляд онбордингу: [Огляд онбордингу](/uk/start/onboarding-overview)
- Онбординг застосунку macOS: [Онбординг](/uk/start/onboarding)
- Ритуал першого запуску агента: [Bootstrap агента](/uk/start/bootstrapping)
