Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Онбординг CLI — це рекомендований спосіб налаштувати OpenClaw на macOS, Linux або Windows (через WSL2; настійно рекомендовано). Він налаштовує локальний Gateway або підключення до віддаленого Gateway, а також канали, Skills і типові параметри робочого простору в одному покроковому процесі. 
openclaw onboard
Найшвидший перший чат: відкрийте Control UI (налаштування каналу не потрібне). Виконайте openclaw dashboard і спілкуйтеся в браузері. Документація: Dashboard.
Щоб змінити налаштування пізніше: 
openclaw configure
openclaw agents add <name>
--json не означає неінтерактивний режим. Для скриптів використовуйте --non-interactive.
Онбординг CLI містить крок вебпошуку, де можна вибрати провайдера, наприклад Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG або Tavily. Деякі провайдери потребують API-ключ, а інші працюють без ключа. Це також можна налаштувати пізніше за допомогою openclaw configure --section web. Документація: Вебінструменти.

​
QuickStart чи Розширений

Онбординг починається з вибору між QuickStart (типові налаштування) і Розширений (повний контроль).
  • Локальний Gateway (loopback)
  • Типовий робочий простір (або наявний робочий простір)
  • Порт Gateway 18789
  • Автентифікація Gateway Token (створюється автоматично, навіть на loopback)
  • Типова політика інструментів для нових локальних налаштувань: tools.profile: "coding" (наявний явний профіль зберігається)
  • Типова ізоляція DM: локальний онбординг записує session.dmScope: "per-channel-peer", якщо значення не задане. Докладніше: Довідник із налаштування CLI
  • Експозиція Tailscale Вимкнено
  • DM у Telegram + WhatsApp типово використовують список дозволених (вам буде запропоновано ввести номер телефону)

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

Локальний режим (типово) проводить вас такими кроками:
  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 і необов’язкові залежності.
Повторний запуск онбордингу не стирає нічого, якщо ви явно не виберете Скинути (або не передасте --reset). CLI --reset типово стосується конфігурації, облікових даних і сесій; використовуйте --reset-scope full, щоб включити робочий простір. Якщо конфігурація недійсна або містить застарілі ключі, онбординг попросить спочатку виконати openclaw doctor.
Віддалений режим лише налаштовує локальний клієнт на підключення до 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. Неінтерактивні приклади дивіться в Автоматизації CLI. Глибший технічний довідник, зокрема деталі RPC, дивіться в Довіднику з онбордингу.

​
Пов’язані документи