---
read_when:
    - إعداد OpenClaw على Raspberry Pi
    - تشغيل OpenClaw على أجهزة ARM
    - بناء ذكاء اصطناعي شخصي منخفض التكلفة ودائم التشغيل
summary: استضف OpenClaw على Raspberry Pi لاستضافة ذاتية دائمة التشغيل
title: Raspberry Pi
x-i18n:
    generated_at: "2026-05-06T08:02:14Z"
    model: gpt-5.5
    provider: openai
    source_hash: 96df076c2707b0b27751d452f15fad774356a86e96d10bce998581235776c4bc
    source_path: install/raspberry-pi.md
    workflow: 16
---

شغّل OpenClaw Gateway دائم التشغيل ومستمرًا على Raspberry Pi. بما أن Pi يعمل كبوابة فقط (تعمل النماذج في السحابة عبر API)، فإن حتى Pi متواضع المواصفات يتعامل مع عبء العمل جيدًا — تكلفة العتاد النموذجية هي **35–80 دولارًا لمرة واحدة**، دون رسوم شهرية.

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

| طراز Pi      | RAM       | هل يعمل؟ | ملاحظات                                  |
| ------------ | --------- | -------- | ---------------------------------------- |
| 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="تفليش نظام التشغيل">
    استخدم **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="الاتصال عبر SSH">
    ```bash
    ssh user@gateway-host
    ```
  </Step>

  <Step title="تحديث النظام">
    ```bash
    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="تثبيت Node.js 24">
    ```bash
    curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
    sudo apt install -y nodejs
    node --version
    ```
  </Step>

  <Step title="إضافة swap (مهم لسعة 2 GB أو أقل)">
    ```bash
    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="تثبيت OpenClaw">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Step>

  <Step title="تشغيل التهيئة الأولية">
    ```bash
    openclaw onboard --install-daemon
    ```

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

  </Step>

  <Step title="التحقق">
    ```bash
    openclaw status
    systemctl --user status openclaw-gateway.service
    journalctl --user -u openclaw-gateway.service -f
    ```
  </Step>

  <Step title="الوصول إلى Control UI">
    من جهاز الكمبيوتر، احصل على عنوان URL للوحة التحكم من Pi:

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

    ثم أنشئ نفق SSH في طرفية أخرى:

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

**قلّل استخدام الذاكرة** -- للإعدادات بلا شاشة، حرّر ذاكرة GPU وعطّل الخدمات غير المستخدمة:

```bash
echo 'gpu_mem=16' | sudo tee -a /boot/config.txt
sudo systemctl disable bluetooth
```

**إضافة systemd drop-in لإعادة تشغيل مستقرة** -- إذا كان هذا Pi يشغّل OpenClaw غالبًا، أضف drop-in للخدمة:

```bash
systemctl --user edit openclaw-gateway.service
```

```ini
[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
{
  "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
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** -- إذا فشلت إحدى Skills برسالة "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)