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

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

```bash
openclaw onboard
```

<Info>
Найшвидший перший чат: відкрийте Control UI (налаштування каналу не потрібне). Виконайте
`openclaw dashboard` і спілкуйтеся в браузері. Документація: [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 (defaults)">
    - Локальний 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="Advanced (full control)">
    - Відкриває кожен крок (режим, робочий простір, Gateway, канали, демон, Skills).

  </Tab>
</Tabs>

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

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

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

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

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

## Додайте ще одного агента

Використовуйте `openclaw agents add <name>`, щоб створити окремого агента з власним робочим простором,
сесіями та профілями автентифікації. Запуск без `--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)
- Ритуал першого запуску агента: [Початкове налаштування агента](/uk/start/bootstrapping)