Raspberry Pi

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

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

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

پیش‌نیازها

• Raspberry Pi 4 یا 5 با حداقل ۲ گیگابایت RAM (۴ گیگابایت توصیه می‌شود)
• کارت MicroSD با ظرفیت حداقل ۱۶ گیگابایت یا USB SSD (با عملکرد بهتر)
• منبع تغذیهٔ رسمی Pi
• اتصال شبکه (Ethernet یا 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 عملکرد را به‌شکل چشمگیری بهبود می‌دهد و چرخه‌های نوشتن بیشتری را تحمل می‌کند؛ اگر سیستم‌عامل را روی SD نگه می‌دارید، از آن برای OPENCLAW_STATE_DIR استفاده کنید. به راهنمای بوت 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 را پاک می‌کنند و در نتیجه کش آماده‌شده از بین می‌رود.

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

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 میزبانی‌شده در فضای ابری استفاده کنید -- مدل‌های زبانی بزرگ محلی را روی 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 بررسی کنید که 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 بدون نمایشگر است، فعال بودن قابلیت ماندگاری را نیز بررسی کنید: 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
• پلتفرم‌ها