Поширені запитання: початкове налаштування

Скористайтеся локальним ШІ-агентом, який може бачити ваш комп’ютер. Більшість випадків «не можу продовжити» спричинені проблемами локальної конфігурації або середовища, які віддалений помічник не може перевірити, тому це ефективніше, ніж запитувати в Discord.

• Claude Code: https://www.anthropic.com/claude-code/
• OpenAI Codex: https://openai.com/codex/

Надайте агенту повну копію вихідного коду за допомогою модифікованого встановлення (git), щоб він міг прочитати код і документацію та врахувати точну версію, яку ви використовуєте:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Попросіть агента покроково спланувати й проконтролювати виправлення, а потім виконати лише необхідні команди — менші відмінності легше перевіряти.

Надайте ці результати, коли звертаєтеся по допомогу (у Discord або в задачі GitHub):

Знайшли справжню помилку або виправлення? Створіть задачу або надішліть PR: Задачі / Запити на злиття.

Короткий цикл налагодження: Перші 60 секунд, якщо щось не працює. Документація зі встановлення: Встановлення, Прапорці інсталятора, Оновлення.

У режимі завдань часові позначки наступного виконання оновлюються лише після завершення справжнього запуску Heartbeat. Пропущені запуски не позначають завдання як виконані.

Документація: Heartbeat, Автоматизація.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon

Із вихідного коду (для учасників розробки/розробників):

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm buildpnpm ui:buildopenclaw onboard

Ще немає глобального встановлення? Натомість запустіть pnpm openclaw onboard. Якщо ресурси Control UI відсутні, під час початкового налаштування система намагається зібрати їх самостійно, а в разі невдачі використовує pnpm ui:build.

Одразу після налаштування відкривається браузер із чистою (без токена) URL-адресою панелі керування, а посилання виводиться в підсумку. Не закривайте цю вкладку; якщо вона не відкрилася, скопіюйте та вставте виведену URL-адресу на тому самому комп’ютері.

Localhost (той самий комп’ютер):

• Відкрийте http://127.0.0.1:18789/.
• Якщо з’явиться запит на автентифікацію за допомогою спільного секрету, вставте налаштований токен або пароль у налаштування Control UI.
• Джерело токена: gateway.auth.token (або OPENCLAW_GATEWAY_TOKEN).
• Джерело пароля: gateway.auth.password (або OPENCLAW_GATEWAY_PASSWORD).
• Спільний секрет ще не налаштовано? Запустіть openclaw doctor --generate-gateway-token (або openclaw doctor --fix --generate-gateway-token).

Не на localhost:

• Tailscale Serve (рекомендовано): залиште прив’язку до loopback, запустіть openclaw gateway --tailscale serve, відкрийте https://<magicdns>/. З gateway.auth.allowTailscale: true заголовки ідентичності задовольняють вимоги автентифікації Control UI/WebSocket (не потрібно вставляти спільний секрет; передбачається довірений хост Gateway); API HTTP усе одно потребують автентифікації за допомогою спільного секрету, якщо навмисно не використовується приватний вхідний трафік none або HTTP-автентифікація довіреного проксі. Одночасні спроби Serve з неправильною автентифікацією від одного клієнта серіалізуються до того, як обмежувач невдалих автентифікацій їх зареєструє, тому вже під час другої невдалої повторної спроби може з’явитися retry later.
• Прив’язка Tailnet: запустіть openclaw gateway --bind tailnet --token "<token>" (або налаштуйте автентифікацію паролем), відкрийте http://<tailscale-ip>:18789/, вставте відповідний спільний секрет у налаштування панелі керування.
• Зворотний проксі з урахуванням ідентичності: залиште Gateway за довіреним проксі, установіть gateway.auth.mode: "trusted-proxy", відкрийте URL-адресу проксі. Для loopback-проксі на тому самому хості потрібно явно вказати gateway.auth.trustedProxy.allowLoopback: true.
• Тунель SSH: ssh -N -L 18789:127.0.0.1:18789 user@gateway-host, потім відкрийте http://127.0.0.1:18789/. Автентифікація за допомогою спільного секрету також застосовується через тунель; якщо з’явиться запит, вставте налаштований токен або пароль.

Відомості про режими прив’язки та автентифікацію див. в розділах Панель керування і Вебінтерфейси.

Вони керують різними рівнями:

• approvals.exec — пересилає запити на схвалення до чатів призначення.
• channels.<channel>.execApprovals — робить цей канал нативним клієнтом схвалення для схвалень exec.

Політика exec хоста все одно залишається справжнім бар’єром схвалення; конфігурація чату визначає лише те, де з’являються запити та як люди на них відповідають.

Обидві конфігурації рідко потрібні одночасно:

• Якщо чат уже підтримує команди та відповіді, /approve у тому самому чаті працює через спільний шлях.
• Коли підтримуваний нативний канал може безпечно визначити осіб, які схвалюють, OpenClaw автоматично вмикає нативні схвалення з пріоритетом особистих повідомлень, якщо channels.<channel>.execApprovals.enabled не задано або має значення "auto".
• Коли доступні нативні картки/кнопки схвалення, цей інтерфейс є основним; згадуйте ручну команду /approve лише тоді, коли результат інструмента повідомляє, що схвалення через чат недоступні.
• Використовуйте approvals.exec лише тоді, коли запити також мають надходити до інших чатів або явно визначених операційних кімнат.
• Використовуйте channels.<channel>.execApprovals.target: "channel" або "both" лише тоді, коли запити на схвалення потрібно публікувати назад у вихідній кімнаті/темі.
• Схвалення plugin є окремими: за замовчуванням /approve у тому самому чаті, необов’язкове пересилання approvals.plugin, і лише деякі нативні канали зберігають нативне опрацювання також для них.

Коротко: пересилання призначене для маршрутизації, а конфігурація нативного клієнта — для розширеного UX, специфічного для каналу. Див. Схвалення exec.

Потрібен Node 22.22.3+, 24.15+ або 25.9+ (рекомендовано Node 24). pnpm — менеджер пакетів репозиторію. Bun може встановлювати залежності та запускати пакетні скрипти, але не може запускати CLI OpenClaw або Gateway, оскільки в ньому немає node:sqlite.

Так, але спочатку перевірте обсяг оперативної пам’яті: Pi 5 і Pi 4 (2 GB+) — оптимальні варіанти; Pi 3B+ (1 GB) працює, але повільно; Pi Zero 2 W (512 MB) не рекомендовано.

Абсолютний мінімум: 1 GB оперативної пам’яті, 1 ядро, 500 MB вільного місця на диску, 64-розрядна ОС. Оскільки на Pi працює лише Gateway (моделі звертаються до хмарних API), навіть Pi зі скромними характеристиками витримує навантаження.

Невеликий Pi/VPS також може розміщувати лише Gateway, а вузли можна сполучити на ноутбуці/телефоні для локального доступу до екрана/камери/полотна або виконання команд. Див. Вузли.

Повна покрокова інструкція з налаштування: Raspberry Pi.

• Використовуйте 64-розрядну ОС; не використовуйте 32-розрядну Raspberry Pi OS.
• Додайте swap на платах із 2 GB або меншим обсягом пам’яті.
• Для кращої швидкодії та довговічності віддавайте перевагу USB SSD, а не SD-картці.
• Віддавайте перевагу модифікованому встановленню (git), щоб переглядати журнали й швидко оновлювати систему.
• Почніть без каналів/навичок і додавайте їх по одному.
• Дивні помилки бінарних файлів («exec format error») зазвичай означають відсутність збірки ARM64 для необов’язкового інструмента навички.

Повний посібник: Raspberry Pi. Також див. Linux.

Цей екран залежить від доступності й автентифікації Gateway. Під час першого запуску TUI також автоматично надсилає «Прокинься, друже!», якщо налаштовано постачальника моделей. Якщо налаштування моделі/автентифікації пропущено, під час початкового налаштування з’являється примітка «Відсутня автентифікація моделі» й відкривається TUI без надсилання повідомлень — додайте постачальника за допомогою openclaw configure --section model. Якщо відображається рядок пробудження без відповіді, а кількість токенів залишається 0, агент не запускався.

1. Перезапустіть Gateway:

openclaw gateway restart

2. Перевірте стан і автентифікацію:

openclaw statusopenclaw models statusopenclaw logs --follow

3. Усе ще зависає? Запустіть:

openclaw doctor

Якщо Gateway віддалений, переконайтеся, що з’єднання через тунель/Tailscale активне, а UI вказує на правильний Gateway. Див. Віддалений доступ.

Так. Скопіюйте каталог стану та робочий простір, а потім один раз запустіть Doctor:

1. Установіть OpenClaw на новому комп’ютері.
2. Скопіюйте $OPENCLAW_STATE_DIR (за замовчуванням: ~/.openclaw) зі старого комп’ютера.
3. Скопіюйте робочий простір (за замовчуванням: ~/.openclaw/workspace).
4. Запустіть openclaw doctor і перезапустіть службу Gateway.

Це збереже конфігурацію, профілі автентифікації, облікові дані WhatsApp, сеанси та пам’ять — ваш бот залишиться без змін, якщо скопіювати обидва розташування. У віддаленому режимі сховище сеансів і робочий простір належать хосту Gateway.

Важливо: якщо лише зафіксувати/надіслати робочий простір до GitHub, буде створено резервну копію пам’яті та файлів початкового завантаження, але не історії сеансів чи даних автентифікації. Вони зберігаються в ~/.openclaw/ (наприклад, ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite).

Пов’язані розділи: Перенесення, Розташування даних на диску, Робочий простір агента, Doctor, Віддалений режим.

Перегляньте журнал змін на GitHub: https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md

Найновіші записи розташовано вгорі. Якщо верхній розділ має назву Не випущено, наступний розділ із датою відповідає останній випущеній версії. Записи згруповано за розділами Основне, Зміни та Виправлення (а також документація/інші розділи за потреби).

Деякі з’єднання Comcast/Xfinity помилково блокують docs.openclaw.ai через Xfinity Advanced Security. Вимкніть цю функцію або додайте docs.openclaw.ai до списку дозволених, а потім повторіть спробу. Допоможіть нам розблокувати сайт: https://spa.xfinity.com/check_url_status.

Усе ще заблоковано? Документація дзеркалюється на GitHub: https://github.com/openclaw/openclaw/tree/main/docs

Стабільна та бета-версія — це npm dist-tags, а не окремі гілки коду:

• latest = стабільна версія
• beta = рання збірка для тестування (повертається до latest, якщо бета-версія відсутня або старіша за поточний стабільний випуск)

Стабільний випуск зазвичай спочатку потрапляє до бета-версії, а потім окремий крок просування переміщує ту саму версію до latest без зміни номера версії. Супровідники також можуть публікувати безпосередньо до latest. Саме тому після просування бета- й стабільна версії можуть указувати на ту саму версію.

Перегляньте зміни: CHANGELOG.md.

Однорядкові команди встановлення та відмінності між бета- й dev-версіями наведено в наступному розділі.

Бета-версія — це npm dist-tag beta (після просування може збігатися з latest). Dev-версія — це рухома верхівка main (git); у разі публікації в npm вона використовує dist-tag dev.

Однорядкові команди (macOS/Linux):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Інсталятор для Windows (PowerShell): iwr -useb https://openclaw.ai/install.ps1 | iex

Докладніше: Канали розробки та Прапорці інсталятора.

Є два варіанти:

1. Канал dev (наявне встановлення):

openclaw update --channel dev

Ця команда перемикає на git checkout main, перебазовує його на upstream, збирає та встановлює CLI із цього checkout.

2. Змінюване встановлення (git) на новому комп’ютері:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Краще клонувати вручну:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build

Документація: Оновлення, Канали розробки, Установлення.

Орієнтовно:

• Установлення: 2-5 хвилин.
• Початкове налаштування QuickStart: кілька хвилин (локальний Gateway, автоматичний токен, стандартний робочий простір).
• Розширене/повне початкове налаштування: довше, якщо вхід до постачальника, сполучення каналу, встановлення демона, мережеві завантаження або Skills потребують додаткового налаштування.

Майстер одразу показує цей часовий план. Пропустіть необов’язкові кроки й поверніться до них пізніше за допомогою openclaw configure.

Процес завис? Див. розділ Я застряг вище.

Запустіть повторно з --verbose:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --beta --verbosecurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --verbose

install.ps1 не має окремого перемикача докладного виведення; натомість обгорніть його в Set-PSDebug -Trace 1 / -Trace 0. Повний довідник прапорців: Прапорці інсталятора.

Дві поширені проблеми у Windows:

1) помилка npm spawn git / git не знайдено

• Установіть Git for Windows і переконайтеся, що git додано до PATH.
• Закрийте й знову відкрийте PowerShell, а потім повторно запустіть інсталятор.

2) openclaw не розпізнано після встановлення

• Глобальної папки бінарних файлів npm немає в PATH.
• Перевірте її: npm config get prefix.
• Додайте цей каталог до користувацького PATH (суфікс \bin не потрібен; у більшості систем це %AppData%\npm).
• Закрийте й знову відкрийте PowerShell.

Віддаєте перевагу настільному застосунку? Використовуйте Windows Hub. Для налаштування лише через термінал підтримуються як інсталятор PowerShell, так і шляхи Gateway у WSL2. Документація: Windows.

Зазвичай причина полягає в невідповідності кодової сторінки консолі у власних оболонках Windows.

Ознаки: виведення system.run/exec відображає китайський текст у вигляді пошкоджених символів; та сама команда має правильний вигляд в іншому профілі термінала.

Обхідне рішення в PowerShell:

chcp 65001[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false)[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)$OutputEncoding = [System.Text.UTF8Encoding]::new($false)

Потім перезапустіть Gateway і повторіть спробу:

openclaw gateway restart

Проблема все ще відтворюється в останній версії OpenClaw? Стежте за нею або повідомте про неї: Проблема №30640.

Використовуйте змінюване встановлення (git), щоб мати повний вихідний код і документацію локально, а потім поставте запитання своєму боту (або Claude/Codex) із цієї папки, щоб він міг прочитати репозиторій і дати точну відповідь.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Докладніше: Установлення та Прапорці інсталятора.

• Швидке встановлення в Linux і встановлення служби: Linux.
• Повний покроковий посібник: Початок роботи.
• Інсталятор та оновлення: Установлення й оновлення.

Підійде будь-який VPS із Linux. Установіть на сервері, а потім підключайтеся до Gateway через SSH/Tailscale.

Посібники: exe.dev, Hetzner, Fly.io. Віддалений доступ: Віддалений Gateway.

Центр хостингу з поширеними постачальниками:

• Хостинг на VPS (усі постачальники в одному місці)
• Fly.io
• Hetzner
• exe.dev

У хмарі Gateway працює на сервері, а ви отримуєте до нього доступ із ноутбука або телефона через інтерфейс керування (або Tailscale/SSH). Ваш стан і робочий простір зберігаються на сервері, тому вважайте хост джерелом істини та створюйте його резервні копії.

Сполучайте вузли (Mac/iOS/Android/без інтерфейсу) із цим хмарним Gateway для локального використання екрана, камери чи полотна або виконання команд на ноутбуці, поки Gateway залишається у хмарі.

Центр: Платформи. Віддалений доступ: Віддалений Gateway. Вузли: Вузли, CLI вузлів.

Можна, але не рекомендовано. Процес оновлення може перезапустити Gateway (перервавши активний сеанс), може потребувати чистого git checkout і запитувати підтвердження. Безпечніше, щоб оператор запускав оновлення з оболонки.

openclaw updateopenclaw update statusopenclaw update --channel stable|extended-stable|beta|devopenclaw update --tag <dist-tag|version>openclaw update --no-restart

Автоматизація з агента:

openclaw update --yes --no-restartopenclaw gateway restart

Документація: Оновлення, Оновлення.

openclaw onboard — рекомендований спосіб налаштування. У локальному режимі він проводить через такі етапи:

1. Модель/автентифікація — OAuth постачальника, ключі API або ручна автентифікація (зокрема локальні варіанти на кшталт LM Studio); вибір стандартної моделі.
2. Робочий простір — розташування та початкові файли.
3. Gateway — порт, адреса прив’язування, режим автентифікації, доступ через Tailscale.
4. Канали — вбудовані канали чатів і канали офіційних plugin: iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp тощо.
5. Демон — LaunchAgent (macOS), користувацький модуль systemd (Linux/WSL2) або власне заплановане завдання Windows.
6. Перевірка справності — запускає Gateway і перевіряє, що він працює.
7. Skills — установлює рекомендовані навички та необов’язкові залежності.

Він заздалегідь повідомляє очікувану тривалість і попереджає, якщо налаштована модель невідома або дані автентифікації відсутні. Повний опис: Початкове налаштування (CLI).

Ні. Запускайте OpenClaw з ключами API (Anthropic/OpenAI/інших постачальників) або лише локальними моделями, щоб ваші дані залишалися на пристрої. Підписки (Claude Pro/Max, ChatGPT/Codex) — необов’язкові способи автентифікації в цих постачальників.

Для Anthropic: ключ API передбачає стандартну оплату за використання; Claude CLI повторно використовує наявний вхід Claude Code на тому самому хості. Наразі Anthropic розглядає неінтерактивний шлях claude -p Claude CLI як використання Agent SDK/програмний доступ, яке й надалі враховується в обмеженнях плану вашої підписки — перш ніж покладатися на поведінку підписки, перевірте актуальну документацію Anthropic щодо оплати. Для довготривалих хостів Gateway і спільної автоматизації ключ API Anthropic є передбачуванішим вибором.

OAuth OpenAI Codex (підписка ChatGPT/Codex) повністю підтримується для моделей агентів. OpenClaw також підтримує розміщені варіанти за передплатою, зокрема Qwen Cloud Coding Plan, MiniMax Coding Plan і Z.AI / GLM Coding Plan.

Документація: Anthropic, OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM), Локальні моделі, Моделі.

Так. OpenClaw підтримує повторне використання Claude CLI для планів Pro/Max/Team/Enterprise. Наразі Anthropic розглядає шлях claude -p, який використовує OpenClaw, як використання в межах плану підписки з урахуванням обмежень вашого плану, а не як окремий безплатний ліміт — див. Anthropic, щоб отримати актуальні відомості про оплату та посилання на власні статті підтримки Anthropic. Для найпередбачуванішого налаштування на сервері натомість використовуйте ключ API Anthropic.

Так, через повторне використання Claude CLI. Підхід Anthropic до оплати використання claude -p/Agent SDK змінювався з часом; див. Anthropic, щоб дізнатися про поточний стан і переглянути датовані посилання на статті підтримки Anthropic, перш ніж покладатися на конкретну модель оплати.

Anthropic setup-token автентифікація також досі підтримується як спосіб автентифікації за допомогою токена, але OpenClaw надає перевагу повторному використанню Claude CLI та claude -p, коли вони доступні. Для виробничих або багатокористувацьких навантажень API-ключ Anthropic залишається безпечнішим і передбачуванішим вибором. Інші розміщені варіанти на основі підписки: OpenAI, Qwen Cloud, MiniMax, Z.AI (GLM).

Вашу квоту/ліміт частоти запитів Anthropic вичерпано для поточного часового вікна. У Claude CLI зачекайте, доки вікно скинеться, або перейдіть на вищий тарифний план. Для API-ключа Anthropic перевірте використання й оплату в Anthropic Console та за потреби збільште ліміти.

Якщо повідомлення має конкретно вигляд Extra usage is required for long context requests, запит намагається використати контекстне вікно Anthropic розміром 1M (модель Claude 4.x із підтримкою 1M, доступну на рівні GA, або застарілу конфігурацію params.context1m: true), а ваші поточні облікові дані не дають права на оплату довгого контексту.

Установіть резервну модель, щоб OpenClaw продовжував відповідати, поки провайдер обмежує частоту запитів. Див. Моделі, OAuth і Для довгого контексту помилка Anthropic 429 вимагає додаткового використання.

Так. OpenClaw має вбудованого провайдера Amazon Bedrock (Converse). За наявності маркерів середовища AWS (AWS_ACCESS_KEY_ID, AWS_PROFILE, AWS_BEARER_TOKEN_BEDROCK) OpenClaw автоматично вмикає неявного провайдера Bedrock для виявлення моделей; інакше встановіть plugins.entries.amazon-bedrock.config.discovery.enabled: true або додайте запис провайдера вручну. Див. Amazon Bedrock і Провайдери моделей. OpenAI-сумісний проксі перед Bedrock також залишається прийнятним варіантом, якщо ви віддаєте перевагу керованому процесу роботи з ключами.

OpenClaw підтримує OpenAI Codex через OAuth (вхід у ChatGPT). Нове налаштування без основної моделі використовує саме openai/gpt-5.6-sol для автентифікації за підпискою ChatGPT/Codex разом із нативним виконанням через сервер застосунку Codex. Повторна автентифікація зберігає наявну явно вказану модель, зокрема openai/gpt-5.5. Якщо робочий простір Codex не надає GPT-5.6, явно виберіть openai/gpt-5.5; OpenClaw не переходить непомітно на слабшу модель. Застарілі посилання на моделі з префіксом Codex є застарілою конфігурацією, яку виправляє openclaw doctor --fix. Прямий доступ за API-ключем OpenAI залишається доступним для неагентних поверхонь API OpenAI, а через упорядкований профіль API-ключа openai — також для агентних моделей. Див. Провайдери моделей і Початкове налаштування (CLI).

openai — це поточний ідентифікатор провайдера та профілю автентифікації як для API-ключів OpenAI, так і для OAuth ChatGPT/Codex — OpenAI Codex інтегровано в нього. У старіших конфігураціях і попередженнях про міграцію ще може траплятися застарілий префікс openai-codex:

• openai/gpt-5.6-sol = нове налаштування підписки ChatGPT/Codex із нативним середовищем виконання Codex для звернень агента.
• openai/gpt-5.5 = явно підтримуваний вибір для наявної конфігурації або облікових записів без доступу до GPT-5.6.
• Застарілі посилання на моделі openai-codex/* = застарілий маршрут, який виправляє openclaw doctor --fix.
• openai/gpt-5.5 разом з упорядкованим профілем API-ключа openai = автентифікація за API-ключем для агентної моделі OpenAI.
• Застарілі ідентифікатори профілів автентифікації openai-codex = застарілі ідентифікатори, які мігрує openclaw doctor --fix.

Потрібна пряма оплата через OpenAI Platform? Установіть OPENAI_API_KEY. Потрібна автентифікація за підпискою ChatGPT/Codex? Виконайте openclaw models auth login --provider openai. Зберігайте посилання на моделі в канонічному провайдері openai/*. Нове налаштування підписки використовує саме openai/gpt-5.6-sol; doctor виправляє застарілі посилання з префіксом Codex, не змінюючи явно вибрану модель openai/gpt-5.5 на новішу.

Codex OAuth використовує керовані OpenAI вікна квот, що залежать від тарифного плану й можуть відрізнятися від доступних у вебсайті або застосунку ChatGPT навіть для того самого облікового запису.

openclaw models status показує видимі зараз вікна використання/квот провайдера, але не вигадує й не перетворює права доступу у вебверсії ChatGPT на прямий доступ до API. Для прямої оплати та лімітів OpenAI Platform використовуйте openai/* з API-ключем.

Так, повністю. OpenAI явно дозволяє використовувати OAuth підписки в зовнішніх інструментах і робочих процесах, як-от OpenClaw. Початкове налаштування може виконати процес OAuth за вас.

Див. OAuth, Провайдери моделей і Початкове налаштування (CLI).

Gemini CLI використовує процес автентифікації Plugin, а не ідентифікатор клієнта чи секрет у openclaw.json.

1. Установіть Gemini CLI локально, щоб gemini був у PATH:
   • Homebrew: brew install gemini-cli
   • npm: npm install -g @google/gemini-cli
2. Увімкніть Plugin: openclaw plugins enable google
3. Увійдіть: openclaw models auth login --provider google-gemini-cli --set-default
4. Модель за замовчуванням після входу: google/gemini-3.1-pro-preview (середовище виконання google-gemini-cli)
5. Запити не виконуються після входу? Установіть GOOGLE_CLOUD_PROJECT або GOOGLE_CLOUD_PROJECT_ID на хості Gateway і повторіть спробу.

Токени OAuth зберігаються у профілях автентифікації на хості Gateway. Докладніше: Google, Провайдери моделей.

Зазвичай ні. OpenClaw потребує великого контексту й надійного захисту; моделі для малих відеокарт обрізають контекст і оминають фільтри безпеки на боці провайдера. Якщо це необхідно, запускайте локально найбільшу збірку моделі, яку можете (LM Studio), — див. Локальні моделі. Менші/квантовані моделі підвищують ризик ін'єкцій у запити — див. Безпека.

Вибирайте кінцеві точки, закріплені за регіоном. OpenRouter пропонує розміщені у США варіанти для MiniMax, Kimi та GLM; виберіть розміщений у США варіант, щоб дані залишалися в регіоні. Anthropic/OpenAI можна й надалі вказувати разом із ними через models.mode: "merge", щоб резервні варіанти залишалися доступними зі збереженням вимог вибраного регіонального провайдера.

Ні. OpenClaw працює на macOS або Linux (у Windows через WSL2). Mac mini — популярний вибір постійно ввімкненого хоста, але також підійде невеликий VPS, домашній сервер або пристрій класу Raspberry Pi.

Mac потрібен лише для інструментів, доступних тільки на macOS. Для iMessage використовуйте iMessage з imsg на будь-якому Mac, на якому виконано вхід у Messages. Якщо Gateway працює на Linux або деінде, задайте для channels.imessage.cliPath SSH-обгортку, яка запускає imsg на цьому Mac. Для інших інструментів, доступних лише на macOS, запускайте Gateway на Mac або під'єднайте Node macOS.

Документація: iMessage, Node, Віддалений режим Mac.

Потрібен будь-який пристрій macOS, на якому виконано вхід у Messages, — не обов'язково Mac mini, підійде будь-який Mac. Використовуйте iMessage з imsg; Gateway може працювати на цьому Mac або деінде через SSH-обгортку cliPath.

Поширені конфігурації:

• Gateway на Linux/VPS, для channels.imessage.cliPath задано SSH-обгортку, яка запускає imsg на Mac, де виконано вхід у Messages.
• Усе на одному Mac для найпростішої конфігурації на одній машині.

Документація: iMessage, Node, Віддалений режим Mac.

Так. Mac mini може запускати Gateway, а MacBook Pro під'єднується як Node (пристрій-компаньйон). Node не запускають Gateway — вони додають можливості на кшталт екрана, камери, полотна та system.run на цьому пристрої.

Поширена схема: Gateway працює на постійно ввімкненому Mac mini; на MacBook Pro працює застосунок macOS або хост Node, спарений із Gateway. Перевірте за допомогою openclaw nodes status / openclaw nodes list.

Документація: Node, CLI Node.

Bun можна використовувати для встановлення залежностей або запуску скриптів пакета. CLI OpenClaw і Gateway потребують Node, оскільки канонічне сховище стану використовує node:sqlite; Bun не надає цього API.

channels.telegram.allowFrom — це ідентифікатор користувача Telegram відправника-людини (числовий), а не ім'я користувача бота. Під час налаштування запитуються лише числові ідентифікатори користувачів; openclaw doctor --fix може спробувати розпізнати застарілі записи @username.

Безпечніший спосіб (без стороннього бота): надішліть своєму боту приватне повідомлення, виконайте openclaw logs --follow, прочитайте from.id.

Офіційний Bot API: надішліть своєму боту приватне повідомлення, викличте https://api.telegram.org/bot<bot_token>/getUpdates, прочитайте message.from.id.

Сторонній спосіб (менш приватний): надішліть приватне повідомлення @userinfobot або @getidsbot.

Див. Керування доступом у Telegram.

Так, завдяки маршрутизації між кількома агентами. Прив'яжіть приватне повідомлення WhatsApp кожного відправника (peer: { kind: "direct", id: "+15551234567" }) до іншого agentId, надавши кожній особі власний робочий простір і сховище сеансів. Відповіді все одно надходитимуть з того самого облікового запису WhatsApp; керування доступом до приватних повідомлень (channels.whatsapp.dmPolicy / channels.whatsapp.allowFrom) є глобальним для кожного облікового запису. Див. Маршрутизація між кількома агентами і WhatsApp.

Так. Використовуйте маршрутизацію між кількома агентами: задайте кожному агенту власну модель за замовчуванням, а потім прив'яжіть вхідні маршрути (обліковий запис провайдера або конкретних співрозмовників) до відповідного агента. Приклад конфігурації: Маршрутизація між кількома агентами. Див. також Моделі і Конфігурація.

Так, через Linuxbrew:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.profileeval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"brew install <formula>

Під час запуску OpenClaw через systemd переконайтеся, що PATH служби містить /home/linuxbrew/.linuxbrew/bin (або ваш префікс brew), щоб інструменти, встановлені через brew, розпізнавалися в оболонках без входу в систему. Останні збірки також додають на початок типові користувацькі каталоги бінарних файлів у службах systemd Linux (наприклад, ~/.local/bin, ~/.npm-global/bin, ~/.local/share/pnpm, ~/.bun/bin) і враховують PNPM_HOME, NPM_CONFIG_PREFIX, BUN_INSTALL, VOLTA_HOME, ASDF_DATA_DIR, NVM_DIR та FNM_DIR, якщо їх задано.

• Придатне до модифікації встановлення (git): повне отримання вихідного коду, який можна редагувати; найкраще підходить для учасників розробки. Збірка виконується локально, а код і документацію можна змінювати.
• Встановлення через npm: глобальне встановлення CLI без репозиторію; найкраще підходить, щоб «просто запустити». Оновлення надходять через dist-теги npm.

Документація: Початок роботи, Оновлення.

Так, за допомогою openclaw update --channel ... у наявному встановленні. Це не видаляє ваші дані — змінюється лише спосіб установлення коду OpenClaw. Стан (~/.openclaw) і робочий простір (~/.openclaw/workspace) залишаються без змін.

З npm на git:

openclaw update --channel dev

З git на npm:

openclaw update --channel stable

Додайте --dry-run, щоб спочатку переглянути заплановану зміну режиму. Засіб оновлення виконує подальші дії Doctor, оновлює джерела плагінів для цільового каналу та перезапускає Gateway, якщо не передано --no-restart.

Інсталятор також може примусово вибрати будь-який із цих режимів:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method gitcurl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method npm

Поради щодо резервного копіювання: Де дані зберігаються на диску.

Потрібна надійна робота 24/7? Використовуйте VPS. Хочете якнайпростішого налаштування й вас влаштовують режим сну та перезапуски? Запускайте локально.

Ноутбук (локальний Gateway)

• Переваги: немає витрат на сервер, прямий доступ до локальних файлів, видиме вікно браузера.
• Недоліки: режим сну та перебої мережі розривають з’єднання, оновлення й перезавантаження ОС переривають роботу, ноутбук має залишатися активним.

VPS / хмара

• Переваги: постійна робота, стабільна мережа, немає проблем із режимом сну ноутбука, простіше підтримувати безперервну роботу.
• Недоліки: часто без графічного інтерфейсу (використовуйте знімки екрана), лише віддалений доступ до файлів, для оновлень потрібен SSH.

WhatsApp/Telegram/Slack/Mattermost/Discord добре працюють із VPS — справжній компроміс полягає у виборі між браузером без графічного інтерфейсу та видимим вікном. Див. Браузер.

Рекомендація за замовчуванням: VPS, якщо раніше виникали розриви з’єднання з Gateway; локальне розгортання чудово підходить, коли Mac активно використовується й потрібен доступ до локальних файлів або автоматизація інтерфейсу у видимому браузері.

Це не обов’язково, але рекомендовано для надійності та ізоляції.

• Окремий хост (VPS/Mac mini/Raspberry Pi): постійно ввімкнений, менше переривань через режим сну чи перезавантаження, простіші дозволи, легше забезпечити безперервну роботу.
• Спільний ноутбук або настільний комп’ютер: підходить для тестування й активного використання, але слід очікувати пауз, коли комп’ютер переходить у режим сну або оновлюється.

Найкраще з обох варіантів: розмістіть Gateway на окремому хості та під’єднайте ноутбук як вузол для локальних інструментів роботи з екраном, камерою та виконанням команд. Див. Вузли і Безпека.

• Абсолютний мінімум: 1 vCPU, 1 ГБ оперативної пам’яті, ~500 МБ дискового простору.
• Рекомендовано: 1-2 vCPU, 2 ГБ+ оперативної пам’яті для запасу ресурсів (журнали, медіафайли, кілька каналів). Інструменти Node й автоматизація браузера можуть потребувати значних ресурсів.

ОС: Ubuntu LTS (або будь-яка сучасна Debian/Ubuntu) — найкраще протестований шлях установлення в Linux.

Документація: Linux, Хостинг на VPS.

Так. Віртуальну машину слід розглядати як VPS: вона має бути постійно ввімкненою, доступною та мати достатньо оперативної пам’яті для Gateway і всіх увімкнених каналів.

• Абсолютний мінімум: 1 vCPU, 1 ГБ оперативної пам’яті.
• Рекомендовано: 2 ГБ+ оперативної пам’яті для кількох каналів, автоматизації браузера або інструментів роботи з медіафайлами.
• ОС: Ubuntu LTS або інша сучасна Debian/Ubuntu.

У Windows використовуйте Windows Hub для налаштування настільного середовища або WSL2 для віртуальної машини Gateway у стилі Linux із широкою сумісністю з інструментами. Див. Windows, Хостинг на VPS. Запуск macOS у віртуальній машині: див. Віртуальна машина macOS.