> ## 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 ليس إلا Gateway (تعمل النماذج في السحابة عبر API)، فإن حتى Pi متواضعًا يتعامل مع عبء العمل جيدًا — تكلفة العتاد المعتادة هي **35–80 دولارًا تدفع مرة واحدة**، بلا رسوم شهرية.

## توافق العتاد

| طراز Pi     | الذاكرة | يعمل؟  | ملاحظات                           |
| ----------- | ------- | ------ | --------------------------------- |
| Pi 5        | 4/8 GB  | الأفضل | الأسرع، موصى به.                  |
| Pi 4        | 4 GB    | جيد    | الخيار المتوازن لمعظم المستخدمين. |
| Pi 4        | 2 GB    | مقبول  | أضف swap.                         |
| Pi 4        | 1 GB    | محدود  | ممكن مع swap وإعدادات بسيطة.      |
| Pi 3B+      | 1 GB    | بطيء   | يعمل لكنه متثاقل.                 |
| Pi Zero 2 W | 512 MB  | لا     | غير موصى به.                      |

**الحد الأدنى:** ذاكرة RAM بسعة 1 GB، نواة واحدة، مساحة قرص فارغة 500 MB، ونظام تشغيل 64-bit.
**الموصى به:** ذاكرة RAM بسعة 2 GB+، بطاقة SD بسعة 16 GB+ (أو USB SSD)، واتصال Ethernet.

## المتطلبات الأساسية

* Raspberry Pi 4 أو 5 بذاكرة RAM بسعة 2 GB+ (يوصى بـ 4 GB)
* بطاقة MicroSD ‏(16 GB+) أو USB SSD (أداء أفضل)
* مزود طاقة Pi رسمي
* اتصال شبكة (Ethernet أو WiFi)
* Raspberry Pi OS بنواة 64-bit (مطلوب -- لا تستخدم 32-bit)
* نحو 30 دقيقة

## الإعداد

<Steps>
  <Step title="Flash the OS">
    استخدم **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.
  </Step>

  <Step title="Connect via SSH">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    ssh user@gateway-host
    ```
  </Step>

  <Step title="Update the system">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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
    ```
  </Step>

  <Step title="Install 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
    ```
  </Step>

  <Step title="Add swap (important for 2 GB or less)">
    ```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

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

  <Step title="Install OpenClaw">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Step>

  <Step title="Run onboarding">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    اتبع المعالج. يوصى بمفاتيح API بدل OAuth للأجهزة بلا شاشة. Telegram هو أسهل قناة للبدء.
  </Step>

  <Step title="Verify">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f
    ```
  </Step>

  <Step title="Access the Control UI">
    على جهاز الكمبيوتر لديك، احصل على عنوان 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](/ar/gateway/tailscale).
  </Step>
</Steps>

## نصائح الأداء

**استخدم USB SSD** -- بطاقات SD بطيئة وتبلى. يحسّن USB SSD الأداء بدرجة كبيرة. راجع [دليل إقلاع Pi من USB](https://www.raspberrypi.com/documentation/computers/raspberry-pi.html#usb-mass-storage-boot).

**فعّل ذاكرة التخزين المؤقت لتجميع الوحدات** -- يسرّع استدعاءات CLI المتكررة على مضيفات Pi منخفضة القدرة:

```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
```

يبقي `OPENCLAW_NO_RESPAWN=1` عمليات إعادة تشغيل Gateway الروتينية داخل العملية نفسها، ما يتجنب عمليات التسليم الإضافية بين العمليات ويحافظ على بساطة تتبع PID على المضيفات الصغيرة.

**قلّل استخدام الذاكرة** -- في إعدادات التشغيل بلا شاشة، حرّر ذاكرة 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 drop-in لإعادة التشغيل المستقرة** -- إذا كان هذا Pi مخصصًا غالبًا لتشغيل OpenClaw، فأضف service drop-in:

```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 بلا شاشة، فعّل أيضًا lingering مرة واحدة كي تبقى خدمة المستخدم تعمل بعد تسجيل الخروج: `sudo loginctl enable-linger "$(whoami)"`.

## إعداد النموذج الموصى به

بما أن Pi يشغّل Gateway فقط، استخدم نماذج API المستضافة سحابيًا:

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

لا تشغّل LLMs محلية على 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، والذاكرة، والآثار).

تنجو هذه البيانات من عمليات إعادة التشغيل. خذ لقطة محمولة باستخدام:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`. إذا كان هذا Pi بلا شاشة، فتحقق أيضًا من تفعيل lingering: `sudo loginctl enable-linger "$(whoami)"`.

**مشكلات ثنائيات ARM** -- إذا فشلت Skill مع "exec format error"، فتحقق مما إذا كان للثنائي إصدار ARM64. تحقق من البنية باستخدام `uname -m` (يجب أن يعرض `aarch64`).

**انقطاع WiFi** -- عطّل إدارة طاقة WiFi: `sudo iwconfig wlan0 power off`.

## الخطوات التالية

* [القنوات](/ar/channels) -- وصّل Telegram وWhatsApp وDiscord والمزيد
* [إعدادات Gateway](/ar/gateway/configuration) -- كل خيارات الإعداد
* [التحديث](/ar/install/updating) -- حافظ على OpenClaw محدثًا

## ذات صلة

* [نظرة عامة على التثبيت](/ar/install)
* [خادم Linux](/ar/vps)
* [المنصات](/ar/platforms)