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

​
Совместимость оборудования

Модель PiRAMРаботает?Примечания
Pi 54/8 GBЛучше всегоСамый быстрый, рекомендуется.
Pi 44 GBХорошоОптимальный вариант для большинства пользователей.
Pi 42 GBOKДобавьте swap.
Pi 41 GBВпритыкВозможно со swap, минимальная конфигурация.
Pi 3B+1 GBМедленноРаботает, но вяло.
Pi Zero 2 W512 MBНетНе рекомендуется.
Минимум: 1 GB RAM, 1 ядро, 500 MB свободного места на диске, 64-битная ОС. Рекомендуется: 2 GB+ RAM, SD-карта 16 GB+ (или USB SSD), Ethernet.

​
Предварительные требования

  • Raspberry Pi 4 или 5 с 2 GB+ RAM (рекомендуется 4 GB)
  • Карта MicroSD (16 GB+) или USB SSD (лучше производительность)
  • Официальный блок питания Pi
  • Сетевое подключение (Ethernet или WiFi)
  • 64-битная Raspberry Pi OS (обязательно — не используйте 32-битную)
  • Около 30 минут

​
Настройка

1

Запишите ОС

Используйте 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

Подключитесь по SSH

ssh user@gateway-host
3

Обновите систему

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

Установите Node.js 24

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

Добавьте swap (важно для 2 GB или меньше)

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

Установите OpenClaw

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

Запустите onboarding

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

Проверьте

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

Откройте 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
OPENCLAW_NO_RESPAWN=1 оставляет обычные перезапуски Gateway внутри процесса, что избегает лишней передачи управления между процессами и упрощает отслеживание PID на небольших хостах. Снизьте использование памяти — Для headless-настроек освободите память GPU и отключите неиспользуемые службы: 
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
systemd drop-in для стабильных перезапусков — Если этот Pi в основном запускает OpenClaw, добавьте 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.

​
Следующие шаги

​
Связанные материалы