> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Raspberry Pi

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

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

| Модель Pi | ОЗУ | Работает? | Примечания |
| - | - | - | - |
| Pi 5 | 4/8 GB | Лучше всего | Самый быстрый, рекомендуется. |
| Pi 4 | 4 GB | Хорошо | Оптимальный вариант для большинства пользователей. |
| Pi 4 | 2 GB | Нормально | Добавьте раздел подкачки. |
| Pi 4 | 1 GB | На пределе | Возможно с разделом подкачки и минимальной конфигурацией. |
| Pi 3B+ | 1 GB | Медленно | Работает, но медленно. |
| Pi Zero 2 W | 512 MB | Нет | Не рекомендуется. |

**Минимум:** 1 GB ОЗУ, 1 ядро, 500 MB свободного места на диске, 64-разрядная ОС.
**Рекомендуется:** 2 GB+ ОЗУ, SD-карта на 16 GB+ (или USB SSD), Ethernet.

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

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

## Настройка

**1. Запишите образ ОС**

Используйте **Raspberry Pi OS Lite (64-bit)** — для сервера без монитора рабочий стол не нужен.

1. Скачайте [Raspberry Pi Imager](https://www.raspberrypi.com/software/).
2. Выберите ОС: **Raspberry Pi OS Lite (64-bit)**.
3. В диалоговом окне настроек заранее укажите:
   * Имя хоста: `gateway-host`
   * Включите SSH
   * Задайте имя пользователя и пароль
   * Настройте WiFi (если не используете Ethernet)
4. Запишите образ на SD-карту или USB-накопитель, вставьте его и загрузите Pi.

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh user@gateway-host
```

**3. Обновите систему**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# Задайте часовой пояс (важно для cron и напоминаний)
sudo timedatectl set-timezone America/Chicago
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs
node --version
```

**5. Добавьте раздел подкачки (важно для 2 GB или меньше)**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

# Уменьшите интенсивность подкачки для устройств с небольшим объёмом ОЗУ
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
```

**6. Установите OpenClaw**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://openclaw.ai/install.sh | bash
```

**7. Запустите первоначальную настройку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```

Следуйте указаниям мастера. Для устройств без монитора рекомендуется использовать ключи API вместо OAuth. Проще всего начать с канала Telegram.

**8. Проверьте работу**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f
```

**9. Откройте интерфейс управления**

На компьютере получите URL панели управления с Pi:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh user@gateway-host 'openclaw dashboard --no-open'
```

Затем создайте SSH-туннель в другом терминале:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh -N -L 18789:127.0.0.1:18789 user@gateway-host
```

Откройте выведенный URL в локальном браузере. Для постоянного удалённого доступа см. раздел [Интеграция с Tailscale](https://docs2.openclaw.ai/ru/gateway/tailscale.md).

## Советы по производительности

**Используйте USB SSD** — SD-карты работают медленно и изнашиваются. USB SSD значительно повышает производительность и выдерживает больше циклов записи; используйте его для `OPENCLAW_STATE_DIR`, если ОС остаётся на SD-карте. См. [руководство по загрузке Pi с USB](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot).

**Включите кеш компиляции модулей** — это ускоряет повторные вызовы CLI на маломощных хостах Pi. `OPENCLAW_NO_RESPAWN=1` выполняет обычные перезапуски Gateway внутри процесса, избегая дополнительных передач управления между процессами и упрощая отслеживание PID на небольших хостах:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Используйте `/var/tmp`, а не `/tmp` — некоторые дистрибутивы очищают `/tmp` при загрузке, из-за чего прогретый кеш удаляется.

**Сократите потребление памяти** — для систем без монитора освободите память GPU и отключите неиспользуемые службы:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
```

**Дополнительная конфигурация systemd для стабильных перезапусков** — если этот Pi в основном используется для OpenClaw, добавьте дополнительную конфигурацию службы:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
systemctl --user edit openclaw-gateway.service
```

```ini theme={"theme":{"light":"min-light","dark":"min-dark"}}
[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`. На Pi без монитора также один раз включите сохранение пользовательских служб после выхода из системы: `sudo loginctl enable-linger "$(whoami)"`.

## Рекомендуемая настройка моделей

Поскольку Pi запускает только шлюз, используйте модели API, размещённые в облаке, — не запускайте локальные LLM на Pi: даже небольшие модели работают слишком медленно, чтобы быть полезными:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallbacks": ["openai/gpt-5.4-mini"]
      }
    }
  }
}
```

## Примечания о двоичных файлах ARM

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

## Сохранение данных и резервные копии

Состояние OpenClaw хранится в следующих каталогах:

* `~/.openclaw/` — `openclaw.json`, отдельные для каждого агента `auth-profiles.json`, состояние каналов и провайдеров, сеансы.
* `~/.openclaw/workspace/` — рабочая область агента (SOUL.md, память, артефакты).

Эти данные сохраняются после перезагрузки, а использование SSD вместо SD-карты повышает производительность и продлевает срок службы. Создайте переносимый снимок с помощью:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw backup create
```

## Устранение неполадок

**Недостаточно памяти** — проверьте активность раздела подкачки с помощью `free -h`. Отключите неиспользуемые службы (`sudo systemctl disable cups bluetooth avahi-daemon`). Используйте только модели на основе API.

**Низкая производительность** — используйте USB SSD вместо SD-карты. Проверьте троттлинг процессора с помощью `vcgencmd get_throttled` (команда должна вернуть `0x0`).

**Служба не запускается** — проверьте журналы с помощью `journalctl --user -u openclaw-gateway.service --no-pager -n 100` и выполните `openclaw doctor --non-interactive`. Если это Pi без монитора, также убедитесь, что сохранение пользовательских служб после выхода из системы включено: `sudo loginctl enable-linger "$(whoami)"`.

**Проблемы с двоичными файлами ARM** — если навык завершается с ошибкой "exec format error", проверьте наличие сборки двоичного файла для ARM64. Проверьте архитектуру с помощью `uname -m` (должно отображаться `aarch64`).

**Обрывы WiFi** — отключите управление энергопотреблением WiFi: `sudo iwconfig wlan0 power off`.

## Дальнейшие действия

* [Каналы](https://docs2.openclaw.ai/ru/channels.md) — подключите Telegram, WhatsApp, Discord и другие сервисы
* [Конфигурация Gateway](https://docs2.openclaw.ai/ru/gateway/configuration.md) — все параметры конфигурации
* [Обновление](https://docs2.openclaw.ai/ru/install/updating.md) — поддерживайте OpenClaw в актуальном состоянии

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

* [Обзор установки](https://docs2.openclaw.ai/ru/install.md)
* [Сервер Linux](https://docs2.openclaw.ai/ru/vps.md)
* [Платформы](https://docs2.openclaw.ai/ru/platforms.md)