Raspberry Pi

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

توافق الأجهزة

طراز Pi	ذاكرة RAM	هل يعمل؟	ملاحظات
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	لا	لا يُنصح به.

الحد الأدنى: ذاكرة RAM بسعة 1 GB، ونواة واحدة، ومساحة قرص خالية قدرها 500 MB، ونظام تشغيل 64 بت. الموصى به: ذاكرة 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 بت (مطلوب — لا تستخدم إصدار 32 بت)
نحو 30 دقيقة

الإعداد

Flash the OS

استخدم Raspberry Pi OS Lite (64-bit) — لا حاجة إلى سطح مكتب لخادم يعمل دون شاشة.

نزّل Raspberry Pi Imager.
اختر نظام التشغيل: Raspberry Pi OS Lite (64-bit).
اضبط مسبقًا في مربع حوار الإعدادات:
- اسم المضيف: gateway-host
- فعّل SSH
- عيّن اسم المستخدم وكلمة المرور
- اضبط WiFi (إذا لم تكن تستخدم Ethernet)
اكتب النظام على بطاقة SD أو محرك USB، ثم أدخله وشغّل Pi.

Connect via SSH

ssh user@gateway-host

Update the system

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

Install Node.js 24

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

Add swap (important for 2 GB or less)

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

Install OpenClaw

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

Run onboarding

openclaw onboard --install-daemon

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

Verify

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

Access the 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 الأداء بدرجة كبيرة ويتحمّل دورات كتابة أكثر؛ استخدمه لتخزين OPENCLAW_STATE_DIR إذا أبقيت نظام التشغيل على بطاقة SD. راجع دليل إقلاع Pi من USB. فعّل ذاكرة التخزين المؤقت لترجمة الوحدات — يسرّع ذلك عمليات استدعاء CLI المتكررة على مضيفات Pi محدودة الطاقة. يحافظ OPENCLAW_NO_RESPAWN=1 على عمليات إعادة التشغيل الاعتيادية لـ Gateway داخل العملية نفسها، ما يتجنب عمليات التسليم الإضافية بين العمليات ويُبقي تتبّع PID بسيطًا على المضيفات الصغيرة:

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 عند الإقلاع، ما يؤدي إلى فقدان ذاكرة التخزين المؤقت المهيّأة. قلّل استخدام الذاكرة — في الإعدادات التي تعمل دون شاشة، حرّر ذاكرة وحدة معالجة الرسومات وعطّل الخدمات غير المستخدمة:

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

إعداد إضافي لـ systemd لضمان استقرار إعادة التشغيل — إذا كان جهاز Pi هذا مخصصًا في الغالب لتشغيل OpenClaw، فأضف إعدادًا إضافيًا للخدمة:

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

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

بما أن Pi لا يشغّل سوى Gateway، فاستخدم نماذج API المستضافة سحابيًا — لا تشغّل نماذج LLM محلية على Pi؛ فحتى النماذج الصغيرة أبطأ من أن تكون مفيدة:

{
  "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. أنشئ لقطة قابلة للنقل باستخدام:

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 التنفيذية — إذا فشلت إحدى Skills مع الرسالة "exec format error"، فتحقّق مما إذا كان للملف التنفيذي إصدار ARM64. تحقّق من البنية باستخدام uname -m (يجب أن يعرض aarch64). انقطاع WiFi — عطّل إدارة طاقة WiFi: sudo iwconfig wlan0 power off.

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

القنوات — وصّل Telegram وWhatsApp وDiscord وغيرها
إعداد Gateway — جميع خيارات الإعداد
التحديث — حافظ على تحديث OpenClaw

Install overview

Maintenance

Containers

Hosting

Advanced setup

توافق الأجهزة

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

الإعداد

نصائح لتحسين الأداء

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

ملاحظات حول ملفات ARM التنفيذية

الاستمرارية والنسخ الاحتياطية

استكشاف الأخطاء وإصلاحها

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

ذو صلة

​توافق الأجهزة

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

​الإعداد

​نصائح لتحسين الأداء

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

​ملاحظات حول ملفات ARM التنفيذية

​الاستمرارية والنسخ الاحتياطية

​استكشاف الأخطاء وإصلاحها

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

​ذو صلة

توافق الأجهزة

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

الإعداد

نصائح لتحسين الأداء

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

ملاحظات حول ملفات ARM التنفيذية

الاستمرارية والنسخ الاحتياطية

استكشاف الأخطاء وإصلاحها

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

ذو صلة