एनवायरनमेंट कॉन्फ़िगरेशन #

इंस्टॉलेशन स्टेप्स #

1. पैकेज अपडेट करें और आवश्यक टूल्स इंस्टॉल करें #

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

   Copy to Clipboard

2. OpenClaw इंस्टॉल करें #

   ऑफिशियल इंस्टॉलर चलाएँ। Node.js का सेटअप भी अपने आप हो जाता है।

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

   Copy to Clipboard

   इंस्टॉलर अपने आप निम्न काम करता है:

   • Node.js v22 इंस्टॉल करना (NodeSource के जरिए)
   • बिल्ड टूल्स इंस्टॉल करना (make / g++ / cmake)
   • OpenClaw npm पैकेज इंस्टॉल करना
   • onboarding विज़ार्ड लॉन्च करना
   Windows से अंतर
   Ubuntu पर npm इंस्टॉलेशन में MODULE_NOT_FOUND एरर नहीं आते।
   pnpm पर स्विच करना जरूरी नहीं है। ऑफिशियल इंस्टॉलर जैसा है वैसा ही काम करता है।

3. Onboarding #

   इंस्टॉलेशन पूरा होने के बाद विज़ार्ड अपने आप लॉन्च होता है। कॉन्फ़िगरेशन आइटम इस प्रकार हैं:

   • सिक्योरिटी वार्निंग: Yes के साथ आगे बढ़ें
   • सेटअप मोड: QuickStart
   • मॉडल प्रोवाइडर: Custom Provider
   • Base URL: http://<GPUStack IP>/v1
   • API Key देने का तरीका: Paste API key now
   • एंडपॉइंट कम्पैटिबिलिटी: OpenAI-compatible
   • Model ID: GPUStack पर चल रहे मॉडल का नाम
   • Channel: Skip for now
   • Skill dependencies: Skip for now
   • Web search: SearXNG Search → URL दर्ज करें
   • Hooks: केवल session-memory इनेबल करें

   Onboarding पूरा होने के बाद, एक systemd सर्विस अपने आप इंस्टॉल होकर स्टार्ट हो जाती है।

4. Context limit और मॉडल कॉन्फ़िगरेशन ठीक करें (महत्वपूर्ण) #

   अगर आप onboarding के तुरंत बाद चैट करते हैं, तो Context limit exceeded एरर दिख सकता है।
   इंस्टॉलेशन के तुरंत बाद नीचे दी गई सेटिंग्स करके इससे बचा जा सकता है।

   तरीका ①: डैशबोर्ड UI से कॉन्फ़िगर करें (अनुशंसित) #

   डैशबोर्ड के बाएँ मेनू में “AI and Agents” →
   “Models” टैब → संबंधित मॉडल का “Compat” सेक्शन खोलें,
   निम्न वैल्यू सेट करें और “Save” दबाएँ।

   • Context Tokens: 65536
   • Context Window: 65536
     
   • Max Tokens: 4096 (डिफ़ॉल्ट ही रखें)
     

   
   
   

   
   

   तरीका ②: कमांड लाइन से कॉन्फ़िगर करें #

   # Increase compaction buffer
   openclaw config set agents.defaults.compaction.reserveTokensFloor 20000
   
   # Manually fix contextWindow (change provider name to match your environment)
   python3 - << 'EOF'
   import json, os
   path = os.path.expanduser("~/.openclaw/openclaw.json")
   with open(path) as f:
       c = json.load(f)
   for k, v in c["models"]["providers"].items():
       for m in v.get("models", []):
           m["contextWindow"] = 65536
           m["maxTokens"] = 4096
   with open(path, "w") as f:
       json.dump(c, f, indent=2, ensure_ascii=False)
   print("Update complete")
   EOF
   
   openclaw gateway restart

   Copy to Clipboard
   UI से कॉन्फ़िगर करना अधिक भरोसेमंद है
   डैशबोर्ड से सेट करने पर बदलाव तुरंत लागू होते हैं और कॉन्फ़िगरेशन की गलतियों से बचाव होता है।
   CLI से कॉन्फ़िगरेशन के बाद openclaw gateway restart हमेशा जरूरी है।

5. Gateway स्टार्टअप वेरिफाई करें #

   openclaw gateway status
   systemctl --user is-enabled openclaw-gateway.service

   Copy to Clipboard

   अगर enabled दिखता है, तो OS बूट पर Gateway अपने आप स्टार्ट होगा।

रिमोट एक्सेस कॉन्फ़िगरेशन (nginx + self-signed सर्टिफिकेट) #

अगर आप नेटवर्क पर किसी दूसरे कंप्यूटर से डैशबोर्ड इस्तेमाल करना चाहते हैं, तो nginx को रिवर्स प्रॉक्सी के रूप में कॉन्फ़िगर करें।
चूँकि WebSocket का उपयोग होता है, nginx कॉन्फ़िगरेशन में Upgrade हेडर फॉरवर्डिंग जरूरी है।

1. nginx और self-signed सर्टिफिकेट सेटअप करें #

   sudo apt install -y nginx
   
   # Generate self-signed certificate (valid for 10 years)
   sudo mkdir -p /etc/nginx/ssl
   sudo openssl req -x509 -nodes -days 3650 -newkey rsa:2048 \
     -keyout /etc/nginx/ssl/openclaw.key \
     -out /etc/nginx/ssl/openclaw.crt \
     -subj "/CN=openclaw.local"

   Copy to Clipboard

2. nginx कॉन्फ़िगरेशन फ़ाइल बनाएँ #

   sudo tee /etc/nginx/sites-available/openclaw << 'EOF'
   server {
       listen 443 ssl;
       server_name _;
   
       ssl_certificate     /etc/nginx/ssl/openclaw.crt;
       ssl_certificate_key /etc/nginx/ssl/openclaw.key;
   
       location / {
           proxy_pass http://127.0.0.1:18789;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection "upgrade";
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_read_timeout 86400;
       }
   }
   
   server {
       listen 80;
       return 301 https://$host$request_uri;
   }
   EOF
   
   sudo ln -sf /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/
   sudo rm -f /etc/nginx/sites-enabled/default
   sudo nginx -t && sudo systemctl restart nginx
   sudo systemctl enable nginx

   Copy to Clipboard

3. OpenClaw कॉन्फ़िगरेशन बदलें #

   # Allow connections from non-localhost
   openclaw config set gateway.controlUi.allowInsecureAuth true
   
   # Allow origin of access source
   openclaw config set gateway.controlUi.allowedOrigins '["*"]'
   
   openclaw gateway restart

   Copy to Clipboard

4. Firewall खोलें #

   sudo ufw allow 443/tcp
   sudo ufw allow 80/tcp

   Copy to Clipboard

रिमोट एक्सेस के लिए device pairing अप्रूवल #

जब आप किसी दूसरे कंप्यूटर से डैशबोर्ड एक्सेस करते हैं, तो pairing required एरर दिखता है।
यह OpenClaw का एक सिक्योरिटी फीचर है जो पहली बार एक्सेस पर एडमिनिस्ट्रेटर अप्रूवल माँगता है।
एक बार अप्रूव हो जाने के बाद, दोबारा इसकी जरूरत नहीं पड़ती।

1. ब्राउज़र से डैशबोर्ड एक्सेस करें #

   Token वाला URL ब्राउज़र में खोलें। सर्वर साइड पर वेरिफाई करें।

   openclaw dashboard
   # Open the displayed URL (#token=...) in a browser

   Copy to Clipboard

   ब्राउज़र में pairing required दिखता है। इसी स्थिति में अगले स्टेप पर बढ़ें।

2. Pending लिस्ट देखें और अप्रूव करें #

   # List devices waiting for pairing
   openclaw devices list
   
   # Approve all displayed Request IDs
   openclaw devices approve <Request ID>

   Copy to Clipboard

   अगर कई requests pending हैं, तो उन सभी को अप्रूव करें।

3. ब्राउज़र से फिर से कनेक्ट करें #

   अप्रूवल के बाद, ब्राउज़र में “Connect” बटन दबाकर डैशबोर्ड खोलें।

GPUStack कॉन्फ़िगरेशन #

GPUStack मैनेजमेंट स्क्रीन में, मॉडल के backend parameters में निम्न जोड़ें और मॉडल को रीस्टार्ट करें।

--max-model-len 32768
--generation-config vllm
--enable-auto-tool-choice
--tool-call-parser hermes

Windows एनवायरनमेंट से तुलना #

ऑपरेशन वेरिफिकेशन चेकलिस्ट #

• openclaw --version दिखता है
• systemctl --user is-enabled openclaw-gateway.service पर enabled दिखता है
• openclaw gateway status पर RPC probe: ok दिखता है
• दूसरे कंप्यूटर के ब्राउज़र से https://<server IP> एक्सेस करें
• openclaw devices approve से device अप्रूवल पूरा हो गया है
• main सेशन में चैट के जवाब मिलते हैं
• सेशन स्क्रीन के TOKENS में xxxxx / 32768 दिखता है
• SearXNG सर्च काम करती है

सारांश #

Ubuntu 24.04 पर OpenClaw इंस्टॉल करना Windows एनवायरनमेंट की तुलना में काफी सरल रहा।
बस इंस्टॉलर चलाने भर से Node.js सेटअप से लेकर सर्विस रजिस्ट्रेशन तक सब पूरा हो जाता है।

एकमात्र pitfall है रिमोट डैशबोर्ड एक्सेस के लिए device pairing।
openclaw devices इस्तेमाल करने का ध्यान रखें, न कि openclaw pairing (channels के लिए)।
साथ ही, इंस्टॉलेशन के तुरंत बाद contextWindow और compaction सेटिंग्स कॉन्फ़िगर करने से
बातचीत शुरू करते ही होने वाले context overflow से बचाव होता है।