Raspberry Pi

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

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

Мінімум: 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 хвилин

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

ssh user@gateway-host

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

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

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

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

openclaw onboard --install-daemon

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

ssh user@gateway-host 'openclaw dashboard --no-open'

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

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

Використовуйте 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.

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

• Канали -- підключіть Telegram, WhatsApp, Discord та інші
• Конфігурація Gateway -- усі параметри конфігурації
• Оновлення -- підтримуйте OpenClaw в актуальному стані

# Пов’язане

• Огляд встановлення
• Linux-сервер
• Платформи