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

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.

Запустіть постійний, завжди активний OpenClaw Gateway на Raspberry Pi. Оскільки Pi є лише Gateway (моделі працюють у хмарі через API), навіть скромний Pi добре справляється з навантаженням — типова вартість обладнання становить $35–80 одноразово, без щомісячних платежів.

​
Сумісність обладнання

Модель PiОЗППрацює?Примітки
Pi 54/8 ГБНайкращеНайшвидший, рекомендовано.
Pi 44 ГБДобреОптимальний варіант для більшості користувачів.
Pi 42 ГБOKДодайте swap.
Pi 41 ГБОбмеженоМожливо зі swap, мінімальна конфігурація.
Pi 3B+1 ГБПовільноПрацює, але мляво.
Pi Zero 2 W512 МБНіНе рекомендовано.
Мінімум: 1 ГБ ОЗП, 1 ядро, 500 МБ вільного диска, 64-бітна ОС. Рекомендовано: 2+ ГБ ОЗП, SD-карта 16+ ГБ (або USB SSD), Ethernet.

​
Передумови

  • Raspberry Pi 4 або 5 з 2+ ГБ ОЗП (рекомендовано 4 ГБ)
  • Карта MicroSD (16+ ГБ) або USB SSD (краща продуктивність)
  • Офіційний блок живлення Pi
  • Підключення до мережі (Ethernet або WiFi)
  • 64-бітна Raspberry Pi OS (обов’язково — не використовуйте 32-бітну)
  • Близько 30 хвилин

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

1

Flash the OS

Використовуйте Raspberry Pi OS Lite (64-bit) — для headless-сервера робочий стіл не потрібен.
  1. Завантажте Raspberry Pi Imager.
  2. Виберіть ОС: Raspberry Pi OS Lite (64-bit).
  3. У діалозі налаштувань попередньо задайте:
    • Ім’я хоста: gateway-host
    • Увімкнути SSH
    • Задати ім’я користувача й пароль
    • Налаштувати WiFi (якщо не використовуєте Ethernet)
  4. Запишіть образ на SD-карту або USB-накопичувач, вставте його й завантажте Pi.
2

Connect via SSH

ssh user@gateway-host
3

Update the system

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Set timezone (important for cron and reminders)
sudo timedatectl set-timezone America/Chicago
4

Install Node.js 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
5

Add swap (important for 2 GB or less)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Reduce swappiness for low-RAM devices
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
6

Install OpenClaw

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

Run onboarding

openclaw onboard --install-daemon
Дотримуйтеся вказівок майстра. Для headless-пристроїв рекомендовано API-ключі замість OAuth. Telegram — найпростіший канал для початку.
8

Verify

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
9

Access the Control UI

На своєму комп’ютері отримайте URL панелі керування з Pi:
ssh user@gateway-host 'openclaw dashboard --no-open'
Потім створіть SSH-тунель в іншому терміналі:
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
Відкрийте надрукований URL у локальному браузері. Для постійного віддаленого доступу див. інтеграцію Tailscale.

​
Поради щодо продуктивності

Використовуйте USB SSD — SD-карти повільні й зношуються. USB SSD суттєво покращує продуктивність. Див. посібник із USB-завантаження Pi. Увімкніть кеш компіляції модулів — пришвидшує повторні виклики CLI на малопотужних хостах Pi: 
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
Зменште використання пам’яті — для headless-налаштувань звільніть пам’ять GPU й вимкніть невикористовувані служби: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
systemd drop-in для стабільних перезапусків — якщо цей Pi здебільшого запускає OpenClaw, додайте service drop-in: 
systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90
Потім systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service. На headless Pi також один раз увімкніть lingering, щоб користувацька служба працювала після виходу з системи: sudo loginctl enable-linger "$(whoami)".

​
Рекомендоване налаштування моделі

Оскільки Pi запускає лише Gateway, використовуйте API-моделі, розміщені в хмарі: 
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}
Не запускайте локальні LLM на Pi — навіть малі моделі надто повільні, щоб бути корисними. Нехай Claude або GPT виконують роботу моделі.

​
Примітки щодо бінарних файлів ARM

Більшість функцій OpenClaw працюють на ARM64 без змін (Node.js, Telegram, WhatsApp/Baileys, Chromium). Бінарні файли, для яких іноді немає ARM-збірок, зазвичай є необов’язковими CLI-інструментами Go/Rust, що постачаються Skills. Перевірте сторінку релізу відсутнього бінарного файла на наявність артефактів linux-arm64 / aarch64, перш ніж переходити до збирання з вихідного коду.

​
Постійність і резервні копії

Стан OpenClaw зберігається тут:
  • ~/.openclaw/ — openclaw.json, поагентні auth-profiles.json, стан каналів/провайдерів, сеанси.
  • ~/.openclaw/workspace/ — робочий простір агента (SOUL.md, пам’ять, артефакти).
Вони зберігаються після перезавантажень. Створіть переносний знімок за допомогою: 
openclaw backup create
Якщо тримати їх на SSD, продуктивність і довговічність будуть кращими, ніж на SD-карті.

​
Усунення несправностей

Бракує пам’яті — Перевірте, що swap активний, за допомогою free -h. Вимкніть невикористовувані служби (sudo systemctl disable cups bluetooth avahi-daemon). Використовуйте лише моделі на основі API. Повільна продуктивність — Використовуйте USB SSD замість SD-карти. Перевірте обмеження частоти CPU за допомогою vcgencmd get_throttled (має повернути 0x0). Служба не запускається — Перевірте журнали за допомогою journalctl --user -u openclaw-gateway.service --no-pager -n 100 і запустіть openclaw doctor --non-interactive. Якщо це headless Pi, також перевірте, що lingering увімкнено: sudo loginctl enable-linger "$(whoami)". Проблеми з бінарними файлами ARM — Якщо skill завершується з помилкою “exec format error”, перевірте, чи має бінарний файл ARM64-збірку. Перевірте архітектуру за допомогою uname -m (має показати aarch64). Розривається WiFi — Вимкніть керування живленням WiFi: sudo iwconfig wlan0 power off.

​
Наступні кроки

​
Пов’язане