Встановлення OpenClaw і налаштування OmniProxy

OpenClaw — це AI-помічник, який встановлюється на вашому комп’ютері. З ним можна спілкуватися безпосередньо через Telegram, Discord, WhatsApp або Feishu, не тримаючи постійно відкритим окреме вікно чату. Розмови й записи залишаються на цьому комп’ютері, а помічник може локально виконувати подальші кроки.

Підготовка до встановлення

Для OpenClaw потрібна Node версії 24.16 або новішої. Також можна використовувати Node 26.1 або новішої версії; рекомендовано Node 26. Node — це базове середовище, необхідне для роботи OpenClaw.

Встановлення підтримується на macOS, Linux і Windows. Якщо на комп’ютері немає відповідної версії Node, сценарій встановлення підготує її самостійно: Node 26 на macOS і Node 24 LTS на Linux. pnpm потрібен лише для складання OpenClaw із вихідного коду.

Якщо на комп’ютері вже встановлена старіша версія Node, її не потрібно відразу видаляти. Під час тестування 2026-10-09 системною версією Node на цьому комп’ютері була 24.2.0, що нижче за потрібну 24.16, тому неінтерактивний сценарій встановлення самостійно підготував Node 24.21.0.

Потрібне вікно

Компаньйон для робочого столу

• У Windows використовуйте інсталятор Hub
• У macOS — DMG із GitHub
• Під час першого запуску можна встановити локальний Gateway

Офіційно рекомендовано

Скрипт установлення

• macOS Linux WSL2
• У Windows використовуйте PowerShell
• Можна додати --no-onboard

Node уже встановлено

Менеджер пакетів

• npm, pnpm або bun
• Потім запустіть onboard
• Версію Node дивіться на сторінці встановлення

Встановлення та перший запуск

Можна встановити настільний застосунок-компаньйон із віконним інтерфейсом або виконати встановлення безпосередньо через термінал. Gateway — це локальна служба, яка отримує повідомлення, викликає модель і повертає результат. Її можна налаштувати під час першого запуску настільного застосунку.

Якщо потрібне вікно

• Windows: завантажте й запустіть OpenClawCompanion-Setup-x64.exe або OpenClawCompanion-Setup-arm64.exe. Інсталяційний пакет підписаний і містить налаштування, стан у системному треї, чат і режим node.
• macOS: завантажте .dmg для OpenClaw зі сторінки GitHub releases проєкту OpenClaw. Перевагу слід надати dmg, але також можна використовувати .zip. Після встановлення відкрийте OpenClaw.app. Якщо для цієї версії немає файлів macOS, дотримуйтеся вказівок на сторінці застосунку для macOS.

Під час першого запуску можна дозволити OpenClaw підготувати Gateway на цьому комп’ютері або підключитися до вже наявного віддаленого Gateway.

Встановлення через термінал

Для macOS, Linux і WSL2 використовуйте:

curl -fsSL https://openclaw.ai/install.sh | bash

Для Windows PowerShell використовуйте:

iwr -useb https://openclaw.ai/install.ps1 | iex

Сценарій визначить поточну систему, за потреби встановить Node, потім встановить OpenClaw і запустить початковий майстер. Майстер допоможе виконати перше налаштування.

Якщо поки що не хочете запускати майстер, у macOS, Linux і WSL2 використовуйте натомість:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

У Windows використовуйте офіційний параметр -NoOnboard:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Якщо ви самостійно керуєте Node, також можна використовувати npm, pnpm або bun. Для npm 12, а також npm 11.16 і новіших версій виконайте:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Для npm 11.15 і попередніх версій потрібно прибрати --allow-scripts=openclaw. У разі використання pnpm потрібно додати --allow-build=openclaw. Докладні відмінності наведено на сторінці встановлення.

Після завершення встановлення послідовно виконайте такі три команди:

openclaw --version
openclaw doctor
openclaw gateway status

Команда openclaw --version показує версію, openclaw doctor перевіряє поширені проблеми середовища, а openclaw gateway status показує, чи працює Gateway. Базове встановлення вважається завершеним лише тоді, коли всі три команди повертають нормальний результат.

Якщо термінал повідомляє, що openclaw не знайдено, зазвичай каталог глобальних виконуваних файлів npm не додано до PATH. PATH — це список розташувань, у яких термінал шукає програми. Для перевірки можна зіставити результати node -v, npm prefix -g і echo "$PATH", додати відповідний каталог bin до PATH, а потім знову відкрити термінал.

Якщо в ~/.openclaw уже є конфігурація, яка використовується, типовий сценарій встановлення застосує цей каталог. Щоб установити окрему копію й не змінювати наявну конфігурацію, запустіть неінтерактивний сценарій і вкажіть новий каталог:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard є типовою поведінкою цього сценарію. Під час використання цієї команди 2026-10-09 було встановлено OpenClaw 2026.9.9. Після встановлення потрібно запускати openclaw із каталогу bin у вказаному розташуванні.

Отримання параметрів підключення з OmniProxy

Спочатку переконайтеся, що OmniProxy працює, а потім відкрийте його список моделей і підготуйте такі три значення:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: повністю скопіюйте з поточного списку моделей OmniProxy

baseUrl — це адреса, на яку OpenClaw надсилає запити до моделі. Вона має закінчуватися на /v1. Для підключення OmniProxy параметр api має бути openai-completions. Змінюйте його на openai-responses, лише якщо ця модель справді працює через /v1/responses.

Model ID — це повний ідентифікатор моделі у списку. Скопіюйте його без змін; якщо він містить скісні риски, їх також потрібно зберегти. Наступні дві назви наведені лише для звірки з документацією постачальників станом на 2026-10-09. Не використовуйте їх, якщо їх немає у списку: claude-sonnet-5-5, gpt-6-luna.

Навіть якщо шлюз не перевіряє ключ, поле apiKey однаково має містити значення. Можна використати послідовність символів-заповнювачів, призначену лише для цього комп’ютера. Не додавайте справжній ключ до репозиторію.

Заповнення конфігурації інструмента

Provider можна розуміти як набір параметрів підключення, за допомогою яких OpenClaw знаходить службу моделі. Тут Provider має назву omniproxy.

Виконайте в терміналі наведену нижче команду, замінивши адресу, ключ і два Model ID власними значеннями:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

Ця команда запише Provider і список моделей до конфігурації. Після успішного виконання команди перезапускати Gateway не потрібно.

Далі вкажіть типову модель. Посилання на модель складається з omniproxy/ та Model ID. Усі наявні в ID скісні риски потрібно зберегти. Якщо ID у списку моделей довший за коротку назву нижче, використовуйте повне значення зі списку:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

Параметри reasoning, input, cost, contextWindow і maxTokens можна не вказувати. Якщо їх не заповнювати, текстова модель оброблятиметься у типовий спосіб.

Ці самі налаштування також можна записати безпосередньо до конфігураційного файлу. У головній конфігурації Provider розташований у models.providers. Кожен agent також може мати власний файл models.json; agent — це екземпляр помічника, який безпосередньо отримує завдання й викликає модель. Файл розташований у agent/models.json у каталозі відповідного agent усередині ~/.openclaw/agents/.

Якщо в цьому файлі models.json указано непорожнє значення baseUrl, воно перевизначить адресу з головної конфігурації.

Перевірка встановлення

Три команди

• openclaw --version
• openclaw doctor
• gateway status

Налаштування

models.providers

• baseUrl має завершуватися на /v1
• Для api використовуйте completions
• Для моделі потрібно вказати принаймні id

Вибір

provider/модель

• Використовуйте це посилання для primary
• Для ключа бажано використовувати змінну середовища
• Орієнтуйтеся на список шлюзу

Перевірка на реальному завданні

Перейдіть до звичайного каталогу проєкту й надішліть дуже коротке повідомлення. Замініть посилання на модель у команді своїм повним Model ID:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Відповідай одним словом."

Параметр --local означає, що це завдання agent виконуватиметься локально, --model визначає модель для цього запуску, а --timeout 300 задає максимальний час очікування — 300 секунд.

У терміналі має справді з’явитися відповідь моделі. Під час перевірки 2026-10-09 OpenClaw 2026.9.9 отримав відповідь за допомогою цієї команди. Перший виклик може тривати одну-дві хвилини.

Якщо з’явиться оригінальне повідомлення про помилку Request timed out before a response was generated, спочатку збільште значення --timeout, а потім надішліть запит ще раз. Зазвичай це означає, що часу очікування було недостатньо, а не те, що адреса обов’язково неправильна.

Після успішної короткої відповіді попросіть модель прочитати вказаний вами локальний файл. Потім відкрийте журнал викликів OmniProxy і перевірте джерело та Model ID у записі. Самих результатів команди версії або doctor недостатньо, щоб вважати підключення моделі повністю налаштованим.

Установлення

Команда відповідає

• Номер версії виводиться
• doctor не виявив блокувальних проблем
• Стан Gateway доступний

Завдання

Він виконав невелику дію

• Наприклад, прочитав локальний файл
• Відповідь не містить помилки
• Посилання на модель указано правильно

Журнал

Шлюз бачить запит

• Джерело — OpenClaw
• ID моделі збігається
• Ключ не потрапив у репозиторій

Поширені помилки

• openclaw не знайдено: додайте каталог глобальних виконуваних файлів npm до PATH, а потім знову відкрийте термінал. Якщо встановлення виконано до вказаного каталогу, запускайте програму з його підкаталогу bin.
• Результат node -v нижчий за 24.16: не потрібно спочатку видаляти стару версію. Перевірте Node, підготовлену сценарієм встановлення, або відповідно до сторінки встановлення використовуйте версію 24.16+ чи 26.1+. Рекомендовано Node 26.
• Модель не з’являється: її потрібно додати до масиву models у models.providers, указавши щонайменше відповідний id. Сам лише запис в agents.defaults.models не реєструє нову модель окремо.
• Повертається помилка 400 зі згадкою ролі developer: якщо хост адреси не є api.openai.com, залиште типові налаштування й не встановлюйте supportsDeveloperRole у true. Навіть якщо встановити true, значення однаково буде перевизначено.
• Дуже швидко спливає час очікування: збільште --timeout до 300 секунд або більше й поки що не змінюйте адресу.
• Вибрано gpt-6-luna, але виклик інструментів не працює: ця модель підтримує Chat Completions; виклик функцій у Chat Completions підтримується лише тоді, коли reasoning_effort має значення none. Якщо ID у списку відрізняється, використовуйте значення зі списку.
• Не вдається підключитися до адреси: переконайтеся, що OmniProxy працює, baseUrl закінчується на /v1, а записана до конфігурації адреса доступна. Для інших адрес у приватній мережі потрібно окремо дозволити доступ.
• Після налаштування запити однаково надсилаються на іншу адресу: перевірте, чи не вказано інше значення baseUrl у файлі models.json цього agent.

Офіційні довідкові матеріали

Кроки встановлення наведено в OpenClaw install. Налаштування власного Provider описано в Custom providers і полях конфігурації. Model ID, використані в прикладах, можна звірити з оглядом моделей Claude і GPT-6 Luna.

Замістіть усі заповнювачі значеннями з вашої власної конфігурації OmniProxy. Ніколи не публікуйте справжній ключ.

Збережений результат або HTTP 200 самі по собі не доводять повну сумісність Агента. Перевірте джерело та модель у журналі викликів OmniProxy.

Офіційні джерела · OpenClaw ↗