Raspberry Pi

Raspberry Pi पर एक स्थायी, हमेशा चालू रहने वाला OpenClaw Gateway चलाएँ। चूँकि Pi केवल Gateway है (मॉडल API के माध्यम से क्लाउड में चलते हैं), इसलिए सामान्य क्षमता वाला Pi भी कार्यभार को अच्छी तरह संभाल लेता है — आम तौर पर हार्डवेयर की लागत एक बार $35-80 होती है और कोई मासिक शुल्क नहीं होता।

हार्डवेयर संगतता

Pi मॉडल	RAM	काम करता है?	टिप्पणियाँ
Pi 5	4/8 GB	सर्वोत्तम	सबसे तेज़, अनुशंसित।
Pi 4	4 GB	अच्छा	अधिकांश उपयोगकर्ताओं के लिए उपयुक्त।
Pi 4	2 GB	ठीक	स्वैप जोड़ें।
Pi 4	1 GB	सीमित	स्वैप और न्यूनतम कॉन्फ़िगरेशन के साथ संभव।
Pi 3B+	1 GB	धीमा	काम करता है, लेकिन सुस्त है।
Pi Zero 2 W	512 MB	नहीं	अनुशंसित नहीं।

न्यूनतम: 1 GB RAM, 1 कोर, 500 MB खाली डिस्क, 64-बिट OS। अनुशंसित: 2 GB+ RAM, 16 GB+ SD कार्ड (या USB SSD), Ethernet।

पूर्वापेक्षाएँ

2 GB+ RAM वाला Raspberry Pi 4 या 5 (4 GB अनुशंसित)
MicroSD कार्ड (16 GB+) या USB SSD (बेहतर प्रदर्शन)
आधिकारिक Pi पावर सप्लाई
नेटवर्क कनेक्शन (Ethernet या WiFi)
64-बिट Raspberry Pi OS (आवश्यक — 32-बिट का उपयोग न करें)
लगभग 30 मिनट

सेटअप

OS फ़्लैश करें

Raspberry Pi OS Lite (64-bit) का उपयोग करें — हेडलेस सर्वर के लिए डेस्कटॉप की आवश्यकता नहीं है।

Raspberry Pi Imager डाउनलोड करें।
OS चुनें: Raspberry Pi OS Lite (64-bit)।
सेटिंग डायलॉग में पहले से कॉन्फ़िगर करें:
- होस्टनेम: gateway-host
- SSH सक्षम करें
- उपयोगकर्ता नाम और पासवर्ड सेट करें
- WiFi कॉन्फ़िगर करें (यदि Ethernet का उपयोग नहीं कर रहे हैं)
अपने SD कार्ड या USB ड्राइव पर फ़्लैश करें, उसे लगाएँ और Pi बूट करें।

SSH के माध्यम से कनेक्ट करें

ssh user@gateway-host

सिस्टम अपडेट करें

sudo apt update && sudo apt upgrade -y
sudo apt install -y git curl build-essential

# समय क्षेत्र सेट करें (Cron और रिमाइंडर के लिए महत्वपूर्ण)
sudo timedatectl set-timezone America/Chicago

Node.js 24 इंस्टॉल करें

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

स्वैप जोड़ें (2 GB या कम के लिए महत्वपूर्ण)

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# कम RAM वाले उपकरणों के लिए स्वैप प्रवृत्ति घटाएँ
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

OpenClaw इंस्टॉल करें

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

ऑनबोर्डिंग चलाएँ

openclaw onboard --install-daemon

विज़ार्ड के निर्देशों का पालन करें। हेडलेस उपकरणों के लिए OAuth की तुलना में API कुंजियाँ अनुशंसित हैं। शुरुआत करने के लिए Telegram सबसे आसान चैनल है।

सत्यापित करें

openclaw status
systemctl --user status openclaw-gateway.service
journalctl --user -u openclaw-gateway.service -f

नियंत्रण UI तक पहुँचें

अपने कंप्यूटर पर Pi से डैशबोर्ड URL प्राप्त करें:

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

फिर दूसरे टर्मिनल में SSH टनल बनाएँ:

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

प्रिंट किया गया URL अपने स्थानीय ब्राउज़र में खोलें। हमेशा चालू रहने वाली रिमोट पहुँच के लिए, Tailscale एकीकरण देखें।

प्रदर्शन संबंधी सुझाव

USB SSD का उपयोग करें — SD कार्ड धीमे होते हैं और घिस जाते हैं। USB SSD प्रदर्शन में उल्लेखनीय सुधार करता है और अधिक लेखन चक्रों तक चलता है; यदि आप OS को SD पर रखते हैं, तो इसे OPENCLAW_STATE_DIR के लिए उपयोग करें। Pi USB बूट गाइड देखें। मॉड्यूल कंपाइल कैश सक्षम करें — कम क्षमता वाले Pi होस्ट पर बार-बार किए जाने वाले CLI आह्वानों को तेज़ करता है। OPENCLAW_NO_RESPAWN=1 नियमित Gateway पुनरारंभों को उसी प्रक्रिया में रखता है, जिससे अतिरिक्त प्रक्रिया हस्तांतरण से बचा जाता है और छोटे होस्ट पर PID ट्रैकिंग सरल रहती है:

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' # pragma: allowlist secret
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc

/tmp के बजाय /var/tmp का उपयोग करें — कुछ वितरण बूट होने पर /tmp साफ़ कर देते हैं, जिससे तैयार कैश हट जाता है। मेमोरी उपयोग घटाएँ — हेडलेस सेटअप के लिए GPU मेमोरी खाली करें और उपयोग न होने वाली सेवाएँ अक्षम करें:

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

स्थिर पुनरारंभों के लिए systemd ड्रॉप-इन — यदि यह Pi मुख्यतः OpenClaw चला रहा है, तो सर्विस ड्रॉप-इन जोड़ें:

systemctl --user edit openclaw-gateway.service

[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

फिर systemctl --user daemon-reload && systemctl --user restart openclaw-gateway.service। हेडलेस Pi पर लॉगआउट के बाद भी उपयोगकर्ता सेवा चलती रहे, इसके लिए एक बार लिंगरिंग भी सक्षम करें: sudo loginctl enable-linger "$(whoami)"।

अनुशंसित मॉडल सेटअप

चूँकि Pi केवल Gateway चलाता है, इसलिए क्लाउड-होस्टेड API मॉडल का उपयोग करें — Pi पर स्थानीय LLM न चलाएँ, छोटे मॉडल भी उपयोगी होने के लिए बहुत धीमे हैं:

{
  "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 बिल्ड कभी-कभी उपलब्ध नहीं होते, वे आम तौर पर Skills द्वारा प्रदान किए गए वैकल्पिक Go/Rust CLI टूल होते हैं। uname -m से आर्किटेक्चर सत्यापित करें (इसमें aarch64 दिखना चाहिए), फिर स्रोत से बिल्ड करने से पहले अनुपलब्ध बाइनरी के रिलीज़ पेज पर linux-arm64 / aarch64 आर्टिफ़ैक्ट देखें।

स्थायित्व और बैकअप

OpenClaw की स्थिति यहाँ संग्रहीत होती है:

~/.openclaw/ — openclaw.json, प्रति-एजेंट auth-profiles.json, चैनल/प्रदाता की स्थिति, सत्र।
~/.openclaw/workspace/ — एजेंट कार्यक्षेत्र (SOUL.md, मेमोरी, आर्टिफ़ैक्ट)।

ये रीबूट के बाद भी बने रहते हैं और प्रदर्शन तथा दीर्घायु, दोनों के लिए SD कार्ड के बजाय SSD से लाभान्वित होते हैं। इसका पोर्टेबल स्नैपशॉट लेने के लिए चलाएँ:

openclaw backup create

समस्या निवारण

मेमोरी समाप्त होना — free -h से सत्यापित करें कि स्वैप सक्रिय है। उपयोग न होने वाली सेवाएँ अक्षम करें (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 को अद्यतित रखें

Install overview

Maintenance

Containers

Hosting

Advanced setup

हार्डवेयर संगतता

पूर्वापेक्षाएँ

सेटअप

प्रदर्शन संबंधी सुझाव

अनुशंसित मॉडल सेटअप

ARM बाइनरी संबंधी टिप्पणियाँ

स्थायित्व और बैकअप

समस्या निवारण

अगले चरण

संबंधित

​हार्डवेयर संगतता

​पूर्वापेक्षाएँ

​सेटअप

​प्रदर्शन संबंधी सुझाव

​अनुशंसित मॉडल सेटअप

​ARM बाइनरी संबंधी टिप्पणियाँ

​स्थायित्व और बैकअप

​समस्या निवारण

​अगले चरण

​संबंधित

हार्डवेयर संगतता

पूर्वापेक्षाएँ

सेटअप

प्रदर्शन संबंधी सुझाव

अनुशंसित मॉडल सेटअप

ARM बाइनरी संबंधी टिप्पणियाँ

स्थायित्व और बैकअप

समस्या निवारण

अगले चरण

संबंधित