हार्डवेयर संगतता
| Pi मॉडल | RAM | काम करता है? | टिप्पणियां |
|---|---|---|---|
| Pi 5 | 4/8 GB | सबसे अच्छा | सबसे तेज, अनुशंसित। |
| Pi 4 | 4 GB | अच्छा | अधिकांश उपयोगकर्ताओं के लिए सही। |
| Pi 4 | 2 GB | ठीक | swap जोड़ें। |
| Pi 4 | 1 GB | सीमित | swap और न्यूनतम config के साथ संभव। |
| Pi 3B+ | 1 GB | धीमा | काम करता है लेकिन सुस्त है। |
| Pi Zero 2 W | 512 MB | नहीं | अनुशंसित नहीं। |
पूर्वापेक्षाएं
- 2 GB+ RAM वाला Raspberry Pi 4 या 5 (4 GB अनुशंसित)
- MicroSD card (16 GB+) या USB SSD (बेहतर प्रदर्शन)
- आधिकारिक Pi power supply
- नेटवर्क कनेक्शन (Ethernet या WiFi)
- 64-bit Raspberry Pi OS (आवश्यक — 32-bit का उपयोग न करें)
- लगभग 30 मिनट
सेटअप
OS फ्लैश करें
headless server के लिए Raspberry Pi OS Lite (64-bit) का उपयोग करें — desktop की जरूरत नहीं।
- Raspberry Pi Imager डाउनलोड करें।
- OS चुनें: Raspberry Pi OS Lite (64-bit)।
- settings dialog में, पहले से config करें:
- Hostname:
gateway-host - SSH सक्षम करें
- username और password सेट करें
- WiFi config करें (यदि Ethernet का उपयोग नहीं कर रहे हैं)
- Hostname:
- अपने SD card या USB drive पर फ्लैश करें, उसे लगाएं, और Pi को boot करें।
onboarding चलाएं
Control UI तक पहुंचें
अपने computer पर, Pi से dashboard URL प्राप्त करें:फिर दूसरे terminal में SSH tunnel बनाएं:प्रिंट किए गए URL को अपने local browser में खोलें। हमेशा-ऑन remote access के लिए, Tailscale integration देखें।
प्रदर्शन टिप्स
USB SSD का उपयोग करें — SD cards धीमे होते हैं और घिस जाते हैं। USB SSD प्रदर्शन को बहुत बेहतर बनाता है। Pi USB boot guide देखें। module compile cache सक्षम करें — कम-power Pi hosts पर बार-बार CLI चलाने की गति बढ़ाता है:OPENCLAW_NO_RESPAWN=1 नियमित Gateway restarts को in-process रखता है, जिससे अतिरिक्त process handoffs से बचा जाता है और छोटे hosts पर PID tracking सरल रहती है।
memory usage घटाएं — headless setups के लिए, GPU memory खाली करें और unused services disable करें:
systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service। headless Pi पर, lingering भी एक बार enable करें ताकि user service logout के बाद भी चलती रहे: sudo loginctl enable-linger "$(whoami)"।
अनुशंसित model setup
चूंकि Pi केवल Gateway चलाता है, cloud-hosted API models का उपयोग करें:ARM binary notes
अधिकांश OpenClaw features ARM64 पर बिना बदलाव के काम करते हैं (Node.js, Telegram, WhatsApp/Baileys, Chromium)। जिन binaries में कभी-कभी ARM builds नहीं होते, वे आमतौर पर Skills द्वारा भेजे गए वैकल्पिक Go/Rust CLI tools होते हैं। source से build करने से पहले missing binary के release page परlinux-arm64 / aarch64 artifacts सत्यापित करें।
Persistence और backups
OpenClaw state यहां रहता है:~/.openclaw/—openclaw.json, per-agentauth-profiles.json, channel/provider state, sessions।~/.openclaw/workspace/— agent workspace (SOUL.md, memory, artifacts)।
Troubleshooting
Memory खत्म होना —free -h से सत्यापित करें कि swap active है। unused services disable करें (sudo systemctl disable cups bluetooth avahi-daemon)। केवल API-based models का उपयोग करें।
धीमा performance — SD card की जगह USB SSD का उपयोग करें। CPU throttling की जांच vcgencmd get_throttled से करें (इसे 0x0 लौटाना चाहिए)।
Service start नहीं होगी — logs को journalctl --user -u openclaw-gateway.service --no-pager -n 100 से जांचें और openclaw doctor --non-interactive चलाएं। यदि यह headless Pi है, तो यह भी सत्यापित करें कि lingering enabled है: sudo loginctl enable-linger "$(whoami)"।
ARM binary issues — यदि कोई skill “exec format error” के साथ विफल होती है, तो जांचें कि binary का ARM64 build है या नहीं। architecture को uname -m से सत्यापित करें (इसे aarch64 दिखाना चाहिए)।
WiFi drops — WiFi power management disable करें: sudo iwconfig wlan0 power off।
अगले चरण
- Channels — Telegram, WhatsApp, Discord और अधिक connect करें
- Gateway configuration — सभी config options
- Updating — OpenClaw को up to date रखें