Raspberry Pi

یک Gateway پایدار و همیشه‌روشن OpenClaw را روی Raspberry Pi اجرا کنید. از آنجا که Pi فقط نقش Gateway را دارد (مدل‌ها از طریق API در فضای ابری اجرا می‌شوند)، حتی یک Pi معمولی هم به‌خوبی از عهده بار کاری برمی‌آید — هزینه معمول سخت‌افزار ۳۵ تا ۸۰ دلار به‌صورت یک‌باره است، بدون هزینه ماهانه.

سازگاری سخت‌افزار

حداقل: ۱ GB RAM، ۱ هسته، ۵۰۰ MB فضای آزاد دیسک، سیستم‌عامل ۶۴ بیتی. توصیه‌شده: ۲ GB+ RAM، کارت SD با ظرفیت ۱۶ GB+ (یا USB SSD)، اترنت.

پیش‌نیازها

• Raspberry Pi 4 یا 5 با ۲ GB+ RAM (۴ GB توصیه می‌شود)
• کارت MicroSD (۱۶ GB+) یا USB SSD (کارایی بهتر)
• منبع تغذیه رسمی Pi
• اتصال شبکه (اترنت یا WiFi)
• Raspberry Pi OS ۶۴ بیتی (الزامی -- از نسخه ۳۲ بیتی استفاده نکنید)
• حدود ۳۰ دقیقه زمان

راه‌اندازی

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 کارایی را به‌طور چشمگیری بهتر می‌کند. راهنمای بوت USB برای Pi را ببینید.

کش کامپایل ماژول را فعال کنید -- فراخوانی‌های تکراری CLI را روی میزبان‌های Pi کم‌مصرف سریع‌تر می‌کند:

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

OPENCLAW_NO_RESPAWN=1 راه‌اندازی‌های مجدد معمول Gateway را در همان فرایند نگه می‌دارد؛ این کار جابه‌جایی‌های اضافی بین فرایندها را حذف می‌کند و رهگیری PID را روی میزبان‌های کوچک ساده نگه می‌دارد.

مصرف حافظه را کاهش دهید -- برای راه‌اندازی‌های بدون نمایشگر، حافظه GPU را آزاد کنید و سرویس‌های استفاده‌نشده را غیرفعال کنید:

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

drop-in systemd برای راه‌اندازی‌های مجدد پایدار -- اگر این Pi عمدتا OpenClaw را اجرا می‌کند، یک drop-in سرویس اضافه کنید:

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 بدون نمایشگر، همچنین lingering را یک‌بار فعال کنید تا سرویس کاربر پس از خروج هم باقی بماند: sudo loginctl enable-linger "$(whoami)".

راه‌اندازی مدل پیشنهادی

از آنجا که Pi فقط Gateway را اجرا می‌کند، از مدل‌های API میزبانی‌شده در فضای ابری استفاده کنید:

{  "agents": {    "defaults": {      "model": {        "primary": "anthropic/claude-sonnet-4-6",        "fallbacks": ["openai/gpt-5.4-mini"]      }    }  }}

LLMهای محلی را روی 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، حافظه، آرتیفکت‌ها).

این‌ها پس از راه‌اندازی مجدد باقی می‌مانند. با دستور زیر یک snapshot قابل حمل بگیرید:

openclaw backup create

اگر این‌ها را روی SSD نگه دارید، هم کارایی و هم دوام نسبت به کارت SD بهتر می‌شود.

عیب‌یابی

کمبود حافظه -- با free -h فعال بودن swap را بررسی کنید. سرویس‌های استفاده‌نشده را غیرفعال کنید (sudo systemctl disable cups bluetooth avahi-daemon). فقط از مدل‌های مبتنی بر API استفاده کنید.

کارایی کند -- به‌جای کارت SD از USB SSD استفاده کنید. با vcgencmd get_throttled محدودسازی CPU را بررسی کنید (باید 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.

گام‌های بعدی

• کانال‌ها -- Telegram، WhatsApp، Discord و موارد بیشتر را متصل کنید
• پیکربندی Gateway -- همه گزینه‌های پیکربندی
• به‌روزرسانی -- OpenClaw را به‌روز نگه دارید

مرتبط

• نمای کلی نصب
• سرور Linux
• پلتفرم‌ها