Raspberry Pi

یک Gateway دائمی و همیشه‌روشن OpenClaw را روی Raspberry Pi اجرا کنید. از آنجا که Pi فقط نقش Gateway را دارد (مدل‌ها از طریق API در فضای ابری اجرا می‌شوند)، حتی یک Pi معمولی نیز به‌خوبی از پس این بار کاری برمی‌آید — هزینهٔ معمول سخت‌افزار $35-80 فقط برای یک‌بار است و هزینهٔ ماهانه‌ای ندارد.

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

حداقل: 1 GB RAM، یک هسته، 500 MB فضای آزاد دیسک و سیستم‌عامل 64 بیتی. توصیه‌شده: 2 GB+ RAM، کارت SD با ظرفیت 16 GB+ (یا USB SSD) و Ethernet.

پیش‌نیازها

• Raspberry Pi 4 یا 5 با 2 GB+ RAM (مقدار 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 # تنظیم منطقهٔ زمانی (برای Cron و یادآوری‌ها مهم است)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 # کاهش میزان استفاده از swap برای دستگاه‌های کم‌حافظهecho '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 میزبانی‌شده در فضای ابری استفاده کنید — مدل‌های 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 بررسی کنید که 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
• پلتفرم‌ها