Розгортання OpenClaw та інтеграція безкоштовних API

💡 Усі статті, обговорення, новини про AI — в одному місці. Приєднуйтесь до AI спільноти!

І. Системні вимоги

• Операційна система: macOS, Linux (рекомендується Ubuntu/Debian), Windows (дуже рекомендується використовувати WSL2, оскільки нативна підтримка Windows обмежена).
• Node.js: версія ≥22 (завантажити: Node.js — Run JavaScript Everywhere).
• Перевірити версію командою: node -v.
• Менеджер пакетів: npm.
• Апаратне забезпечення: мінімум 4 ГБ оперативної пам’яті, рекомендується Mac mini або VPS для цілодобової роботи 24/7.

2. Конфігурація Discord Bot

1. Перейдіть на Discord for Developers, створіть нову програму → додайте Bot → увімкніть Intents (Message Content, Server Members, Presence).
2. Скопіюйте Token бота та вставте його у відповідне поле конфігурації на третьому кроці.
3. Запросіть бота на свій сервер (використовуйте OAuth2 URL Generator).
4. Отримайте ID каналів Discord і заповніть їх у розділі channels access на третьому кроці.

3. Способи встановлення (Installation Methods)

OpenClaw підтримує три основні шляхи встановлення: скриптовий інсталятор (найшвидший), глобальна CLI-встановлення, збирання з вихідного коду. Тут показуємо використання скриптового інсталятора — це офіційний найпростіший спосіб: він автоматично визначає ОС, встановлює Node.js (якщо його немає), і запускає onboarding wizard.

Bash:

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

• Встановить OpenClaw CLI.
• Запитає у вас базові налаштування (workspace, channels тощо).
• Автоматично встановить daemon (фонову службу), щоб OpenClaw працював 24/7.
• Якщо виникне помилка (наприклад, через права доступу): використовуйте sudo або перевірте, чи встановлено curl.

4. Майстер налаштування (Onboarding Wizard) — початкова конфігурація

Після встановлення автоматично запуститься процес ініціалізації — просто проходьте крок за кроком.

Він підтвердить постачальника моделі та назву моделі. Оскільки в майстрі немає опції для налаштування OpenAI-сумісних API, спочатку пропустіть цей крок, завершіть весь процес, а потім уже в конфігураційному файлі налаштуйте Provider та інші параметри.

• channels: обирайте Discord або Telegram/WhatsApp тощо, в цьому посібнику використовується Discord. Перший крок — налаштування Discord.
• Права бота: якщо відповідний Discord-бот уже налаштований, просто заповніть відповідні поля інформацією. Якщо ні — дотримуйтесь кроку 5, щоб налаштувати Discord-бота.

Після завершення потрібно налаштувати деякі навички (skills) для бота. Їх можна додавати пізніше відповідно до ваших потреб.

Після завершення натисніть Ctrl+C, щоб зупинити поточний процес openclaw, а потім перейдіть до конфігураційного файлу та налаштуйте наш url і key.

5. Налаштування стороннього API (на прикладі Canopy Wave)

Я тут використовую безкоштовний API від Canopy Wave. На офіційному сайті Canopy Wave отримайте API Key та URL для викликів: Canopy Wave — The World’s Best Inference Platform For Open Models.

Відредагуйте файл ~/.openclaw/openclaw.json або .env: додайте наступний вміст до файлу openclaw.json:

Після збереження можна використовувати команду openclaw doctor, щоб перевірити, чи конфігурація успішна.

Після завершення налаштування використовуйте openclaw onboard, щоб перезавантажити конфігурацію. Після додавання canopywave до конфігураційного файлу просто пропустіть налаштування Provider — і в списку моделей з’являться моделі від canopywave.

6. Запуск та тестування

Запустіть Gateway:

openclaw gateway start

• Перевірте статус Gateway: openclaw gateway status
• Інтерактивний TUI: openclaw tui
• Перевірка стану здоров’я: openclaw doctor --fix

7. Оновлення та підтримка

• Оновлення: openclaw update --channel stable
• Логи: openclaw logs --follow
• Видалення (uninstall): npm uninstall -g openclaw та rm -rf ~/.openclaw

8. Поради з безпеки та поширені проблеми

Безпека:

• Обмежте allowedUsers — тільки для себе.
• Не давайте AI права root.
• Використовуйте VPS (наприклад, Hostinger) для ізоляції.

Проблеми:

• Низька версія Node: оновіть Node.
• API не працює: перевірте key та URL.
• Проблеми на Windows: використовуйте WSL2.
• Daemon не запускається: перевірте статус systemd/launchd (systemctl --user status openclaw). Якщо ви працюєте в середовищі Windows через WSL2, але systemd не увімкнено, то user-level daemon (служба gateway) не зможе запускатися/керуватися як systemd-сервіс. Просто увімкніть функцію systemd — і проблема вирішиться.