Raspberry Pi

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

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

الحد الأدنى: ذاكرة 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 دقيقة

الإعداد

ssh user@gateway-host

sudo apt update && sudo apt upgrade -ysudo apt install -y git curl build-essential # Set timezone (important for cron and reminders)sudo timedatectl set-timezone America/Chicago

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

sudo fallocate -l 2G /swapfilesudo chmod 600 /swapfilesudo mkswap /swapfilesudo swapon /swapfileecho '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab # Reduce swappiness for low-RAM devicesecho 'vm.swappiness=10' | sudo tee -a /etc/sysctl.confsudo sysctl -p

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

openclaw onboard --install-daemon

openclaw statussystemctl --user status openclaw-gateway.servicejournalctl --user -u openclaw-gateway.service -f

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

ssh -N -L 18789:127.0.0.1:18789 user@gateway-host

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

استخدم 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 secretexport NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cachemkdir -p /var/tmp/openclaw-compile-cacheexport OPENCLAW_NO_RESPAWN=1EOFsource ~/.bashrc

استخدم /var/tmp، لا /tmp — تمسح بعض التوزيعات /tmp عند الإقلاع، ما يؤدي إلى فقدان ذاكرة التخزين المؤقت المهيّأة.

قلّل استخدام الذاكرة — في الإعدادات التي تعمل دون شاشة، حرّر ذاكرة وحدة معالجة الرسومات وعطّل الخدمات غير المستخدمة:

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

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

systemctl --user edit openclaw-gateway.service

[Service]Environment=OPENCLAW_NO_RESPAWN=1Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cacheRestart=alwaysRestartSec=2TimeoutStartSec=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

ذو صلة

• نظرة عامة على التثبيت
• خادم Linux
• المنصات