- Ефективність Витрат: Запустіть AI-асистента 24/7 приблизно за $1 на місяць на витрати електроенергії, використовуючи Raspberry Pi.
- Вимоги до Обладнання: Рекомендується Raspberry Pi 4 або 5 з 8 ГБ оперативної пам’яті для оптимальної продуктивності; 4 ГБ є абсолютним мінімумом.
- Програмні Залежності: Система вимагає 64-бітної ОС і Node.js версії 20 або новішої.
- Конфіденційність: Самостійний хостинг забезпечує збереження ваших даних у приватності, взаємодіючи лише з обраним вами постачальником LLM та месенджерами.
Чому OpenClaw Ідеально Підходить для Raspberry Pi
OpenClaw — це відкрите, самостійно хостоване AI-асистент, розроблене для автоматизації завдань, управління взаємодіями з браузером і безперебійної інтеграції з месенджерами, такими як WhatsApp, Telegram і Discord. Хоча запуск такого асистента зазвичай вимагає дорогого хмарного хостингу або спеціального настільного комп’ютера, Raspberry Pi пропонує потужну, економічно ефективну альтернативу.
Raspberry Pi 4 і 5 — це малопотужні одноплатні комп’ютери, які цілком здатні впоратися з безперервними операціями. У поєднанні з OpenClaw ви можете створити постійного AI-агента за початкову вартість обладнання приблизно $105 і споживанням електроенергії ~5 Вт. Цей посібник детально описує процес встановлення на Raspberry Pi OS, використовуючи systemd для надійної доступності 24/7.
Передумови: Ваш Список Перевірки Обладнання та Програмного Забезпечення
Успішне розгортання вимагає специфічного обладнання, здатного обробляти процеси Node.js і автоматизацію браузера, разом з правильним програмним середовищем.
Список Перевірки Обладнання
- Raspberry Pi 4 (8 ГБ RAM) або Raspberry Pi 5 (8 ГБ RAM) — Хоча 4 ГБ Pi 4 технічно можливий, він може мати труднощі з інтенсивними завданнями автоматизації браузера.
- MicroSD карта — Рекомендується 32GB або більша з рейтингом A1/A2 для забезпечення швидшої швидкості запису та зменшення зносу.
- Блок живлення — Використовуйте офіційний USB-C блок живлення для вашої конкретної моделі Pi для забезпечення стабільної роботи.
- Корпус з охолодженням — Активне охолодження є необхідним для роботи 24/7, щоб запобігти тепловому обмеженню.
- Кабель Ethernet — Проводові з’єднання надають перевагу для надійності мережі, хоча підтримується Wi-Fi.
- Адаптер NVMe SSD (опціонально) — SSD значно покращує продуктивність введення/виведення (I/O) у порівнянні з MicroSD картами.
Перелік програмного забезпечення
- Raspberry Pi Imager — Доступний на raspberrypi.com/software.
- SSH клієнт — Вбудований в Mac/Linux; користувачі Windows можуть використовувати PuTTY, PowerShell або Windows Subsystem for Linux (WSL).
- Raspberry Pi OS (64-біт) Lite — Мінімальна версія з командним рядком (CLI) зменшує використання RAM і навантаження на робочий стіл.
- Текстовий редактор — Інструменти, такі як nano або vim, встановлені за замовчуванням.
- Node.js 20+ — Критично важлива вимога для роботи програми.
Мережа та доступ
- Статична IP адреса: Рекомендується для запобігання проблемам з підключенням у вашій локальній мережі.
- Доступ SSH: Повинен бути увімкнений під час процесу запису ОС.
- Порт 18789: Переконайтеся, що цей порт доступний (порт за замовчуванням для OpenClaw).
Крок 1: Підготовка системи – Запис Raspberry Pi OS
OpenClaw вимагає 64-бітної операційної системи для надійного виконання своєї архітектури. Ви повинні записати версію “Lite” для максимізації доступних системних ресурсів.
1.1 Запис Raspberry Pi OS (64-біт)
- Вставте вашу MicroSD карту в SD-кардрідер, підключений до вашого комп’ютера.
- Відкрийте Raspberry Pi Imager.
- Натисніть Choose OS і перейдіть до Raspberry Pi OS (other) → Raspberry Pi OS (64-bit) Lite.
- Натисніть Choose Storage і виберіть вашу MicroSD карту.
- Натисніть Next, потім виберіть Edit Settings (значок шестерні).
1.2 Налаштування SSH та Імені Хоста
У діалоговому вікні розширених налаштувань застосуйте наступні конфігурації:
- Ім’я хоста: Встановіть на openclaw-pi для легкого розпізнавання в мережі.
- Увімкнути SSH: Увімкніть цю опцію і виберіть “Використовувати аутентифікацію за паролем.”
- Встановити ім’я користувача та пароль: Створіть надійні облікові дані для користувача за замовчуванням (наприклад, pi).
- Налаштувати Wi-Fi: Введіть ваш SSID та пароль, якщо Ethernet недоступний.
- Локаль: Встановіть ваш регіон та часовий пояс.
Натисніть Save, потім Write. Дочекайтеся завершення процесу, це займе 2–5 хвилин.
1.3 Завантаження та підключення через SSH
- Вставте MicroSD карту в Raspberry Pi.
- Підключіть блок живлення та Ethernet кабель.
- Дочекайтеся 30–60 секунд для початкової послідовності завантаження.
- Відкрийте термінал на вашому комп’ютері і виконайте команду:
ssh pi@openclaw-pi.local
Або використовуйте IP-адресу, якщо ім’я хоста не працює:
ssh pi@192.168.1.XXX # Замініть на фактичну IP
Крок 2: Встановлення системних залежностей
OpenClaw залежить від Node.js 20 або новішої версії, Git та Python 3 для правильної роботи. Ви повинні встановити ці залежності перед тим, як намагатися запустити бота.
Виконайте наступні команди, щоб оновити систему та встановити необхідні пакети:
Bash
# Оновлення списків пакетів та оновлення системних пакетів
sudo apt update && sudo apt upgrade -y
# Встановлення Node.js 20.x з репозиторію NodeSource
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash –
sudo apt install -y nodejs
# Перевірка версій Node.js та npm
node –version # Повинно бути v20.x.x або вище
npm –version # Повинно бути 10.x.x або вище
# Встановлення Git (потрібно для клонування репозиторію OpenClaw)
sudo apt install -y git
# Встановлення build essentials та Python 3
sudo apt install -y build-essential python3
Пояснення залежностей:
- Node.js: Основне середовище виконання для застосунку. Версія 20+ є обов’язковою для сучасних функцій JavaScript.
- Git: Потрібен для контролю версій та оновлень системи.
- Build Essentials: Компілює нативні C/C++ модулі, які потрібні для певних npm пакетів.
- Python 3: Використовується певними скриптами автоматизації в екосистемі OpenClaw.
Крок 3: Встановлення OpenClaw за допомогою інсталяційного скрипта
Офіційний скрипт встановлення OpenClaw автоматизує процес клонування, встановлення залежностей та створення служби systemd.
3.1 Запуск інсталяційного скрипта
Виконайте наступну команду:
curl -fsSL https://openclaw.ai/install.sh | bash
Скрипт виконує наступні дії:
- Клонує репозиторій у ~/.openclaw/.
- Встановлює залежності Node.js.
- Генерує файли конфігурації openclaw.json та.env.
- Створює службу systemd openclaw.
3.2 Перевірка після встановлення
Перезавантажте середовище вашої оболонки та перевірте встановлення:
exec bash
openclaw –version
Ви повинні отримати вихідний результат, схожий на OpenClaw v2026.3.13.
Крок 4: Конфігурація – API ключі та налаштування бота
Ви повинні налаштувати свого постачальника AI (LLM) та платформи обміну повідомленнями, перш ніж бот зможе обробляти запити.
4.1 Запустіть Майстер Налаштування
Інтерактивний майстер спрощує процес налаштування:
openclaw setup –wizard
Дотримуйтесь підказок, щоб:
- Вибрати постачальника AI: Оберіть OpenAI, Anthropic або інших, та введіть свій API ключ.
- Інтегрувати обмін повідомленнями: Увімкніть платформи, такі як Telegram або WhatsApp, і надайте необхідні токени.
- Налаштувати поведінку: Встановіть обмеження на збереження пам’яті та переваги автоматизації.
4.2 Ручна Конфігурація (Альтернатива)
Якщо ви віддаєте перевагу ручному налаштуванню, відредагуйте файл JSON безпосередньо:
nano ~/.openclaw/openclaw.json
Приклад структури конфігурації:
{
“provider”: {
“type”: “openai”,
“apiKey”: “sk-…”
},
“channels”: {
“telegram”: {
“enabled”: true,
“botToken”: “…”
}
}
}
Натисніть Ctrl + X, потім Y, потім Enter, щоб зберегти та вийти.
Крок 5: Запуск OpenClaw з Systemd
Systemd є стандартом для управління сервісами в Linux, забезпечуючи запуск вашого бота при завантаженні та автоматичний перезапуск у разі збою.
5.1 Запуск та Увімкнення Сервісу
Запустіть сервіс негайно:
sudo systemctl start openclaw
Увімкніть сервіс для автоматичного запуску при перезавантаженні:
sudo systemctl enable openclaw
5.2 Моніторинг Статусу Сервісу
Перевірте, чи сервіс активний та працює:
sudo systemctl status openclaw
Щоб переглянути журнали в реальному часі для налагодження або пошуку кодів сполучення:
sudo journalctl -u openclaw -f
Порада професіонала: Використовуйте прапорець -n 100 з journalctl (наприклад, sudo journalctl -u openclaw -n 100), щоб швидко переглянути останні 100 рядків журналів без активного стеження за потоком у реальному часі.
Крок 6: Парування шлюзу та інтеграція повідомлень
Парування з’єднує вашу локальну інстанцію OpenClaw із зовнішнім шлюзом, який обробляє трафік повідомлень.
6.1 Отримання коду парування
Слідкуйте за журналами, щоб знайти свій унікальний код парування:
sudo journalctl -u openclaw -f
Шукайте наступний вивід у консолі:
Ваш код парування: ABC-123-DEF
Відвідайте https://openclaw.ai/pair, щоб завершити налаштування
6.2 Завершення парування
- Перейдіть на https://openclaw.ai/pair у вашому веб-браузері.
- Введіть код, відображений у ваших журналах терміналу.
- Виберіть бажані платформи (наприклад, WhatsApp, Discord) і дотримуйтесь підказок автентифікації.
- Надішліть тестове повідомлення (наприклад, “Привіт”) вашому боту на підключеній платформі, щоб перевірити функціональність.
Крок 7: Оптимізація – Максимізація продуктивності
Оптимізація середовища Raspberry Pi забезпечує залишення бота чутливим під час ресурсомістких завдань.
7.1 Увімкнення режиму продуктивності (Pi 4)
Збільште частоту процесора на Raspberry Pi 4:
sudo nano /boot/firmware/config.txt
Додайте наступні рядки в кінець файлу:
arm_freq=1800
over_voltage=6
gpu_mem=16
Збережіть і перезавантажте через sudo reboot. (Примітка: Raspberry Pi 5 автоматично обробляє масштабування продуктивності і не потребує цього кроку).
7.2 Налаштування простору підкачки
Збільште простір підкачки, щоб запобігти помилкам через недостатню пам’ять під час важкої автоматизації браузера:
sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
Змініть CONF_SWAPSIZE=100 на CONF_SWAPSIZE=2048. Потім застосуйте зміни:
sudo dphys-swapfile setup
sudo dphys-swapfile swapon
7.3 Зберігання на NVMe SSD
Завантаження з NVMe SSD через USB 3.0 значно покращує швидкість вводу-виводу порівняно з картами MicroSD. Це призводить до швидшого читання бази даних і плавнішої автоматизації браузера.
Порада професіонала: Якщо ви використовуєте NVMe диск, переконайтеся, що ваш USB адаптер підтримує UASP (USB Attached SCSI Protocol) для максимальних швидкостей передачі даних.
Усунення несправностей та поширені помилки
Проблеми часто виникають через конфігурації мережі або застарілі залежності.
Помилка: “Версія Node.js занадто стара”
Рішення: OpenClaw суворо вимагає Node.js 20+. Перевірте вашу версію за допомогою node –version. Якщо вона застаріла, повторно виконайте команди встановлення Node.js у Кроці 2.
Помилка: “Не вдалося з’єднати шлюз”
Рішення:
- Перевірте підключення до інтернету: ping 8.8.8.8.
- Переконайтеся, що служба дійсно працює: sudo systemctl status openclaw.
- Перевірте, чи локальний маршрутизатор не блокує порт 18789.
Помилка: “Недостатньо пам’яті”
Рішення: Це часто трапляється на моделях з 2GB або 4GB оперативної пам’яті. Переконайтеся, що ви збільшили розмір файлу підкачки, як описано в Кроці 7.2. Якщо проблема залишається при великих навантаженнях, можливо, знадобиться оновлення апаратного забезпечення до моделі з 8GB.
SSH з’єднання відхилено
Рішення: Якщо ssh pi@openclaw-pi.local не вдається, увійдіть в панель адміністратора вашого домашнього маршрутизатора, щоб знайти призначену IP-адресу Pi і підключитися за допомогою цієї IP-адреси. Переконайтеся, що Pi увімкнено і зелений індикатор активності блимає час від часу.
Часті питання
Питання: Чи можу я запустити OpenClaw на Raspberry Pi 3 або Zero?
Відповідь: Це не рекомендується. Raspberry Pi 3 і Zero не мають достатньої оперативної пам’яті та потужності процесора, необхідних для сучасних додатків Node.js і автоматизації браузера, що призводить до серйозної нестабільності та збоїв.
Q: Чи надсилаються мої дані на сервери OpenClaw?
A: Ні. OpenClaw розгортається локально. Ваші дані зберігаються локально на вашому Raspberry Pi і надсилаються безпосередньо до обраного вами постачальника LLM (наприклад, OpenAI) та на конкретні платформи обміну повідомленнями, які ви налаштували.
Q: Як оновити OpenClaw?
A: Перейдіть до каталогу встановлення та завантажте останні зміни через Git, або повторно запустіть скрипт install.sh. Завжди робіть резервну копію файлу конфігурації openclaw.json перед виконанням значних оновлень.
Q: Що станеться, якщо вимкнеться електроенергія?
A: Оскільки OpenClaw налаштований як служба systemd (Крок 5), він автоматично ініціалізується та перезапуститься, як тільки Raspberry Pi завантажиться після відновлення електропостачання.
Найцікавіше з нашого блогу:
Корисні посилання
