Hetzner पर OpenClaw (Docker, प्रोडक्शन VPS गाइड)
लक्ष्य
Docker का उपयोग करके Hetzner VPS पर एक स्थायी OpenClaw Gateway चलाना, जिसमें durable state, अंतर्निहित बाइनरीज़ और सुरक्षित रीस्टार्ट व्यवहार हो। यदि आप “~$5 में OpenClaw 24/7” चाहते हैं, तो यह सबसे सरल और विश्वसनीय सेटअप है। Hetzner की कीमतें बदलती रहती हैं; सबसे छोटा Debian/Ubuntu VPS चुनें और यदि OOMs आएँ तो स्केल अप करें।हम क्या कर रहे हैं (सरल शब्दों में)?
- एक छोटा Linux सर्वर किराए पर लेना (Hetzner VPS)
- Docker इंस्टॉल करना (आइसोलेटेड ऐप रनटाइम)
- Docker में OpenClaw Gateway शुरू करना
- होस्ट पर
~/.openclaw+~/.openclaw/workspaceको स्थायी रखना (रीस्टार्ट/रीबिल्ड के बाद भी) - SSH टनल के माध्यम से अपने लैपटॉप से Control UI तक पहुँच बनाना
- आपके लैपटॉप से SSH पोर्ट फ़ॉरवर्डिंग
- यदि आप फ़ायरवॉलिंग और टोकन स्वयं प्रबंधित करते हैं तो सीधे पोर्ट एक्सपोज़र
यदि आप किसी अन्य Linux VPS पर हैं, तो पैकेजों को उसी अनुसार मैप करें। सामान्य Docker फ्लो के लिए, देखें Docker।
त्वरित मार्ग (अनुभवी ऑपरेटर)
- Hetzner VPS प्रोविजन करें
- Docker इंस्टॉल करें
- OpenClaw रिपॉज़िटरी क्लोन करें
- स्थायी होस्ट डायरेक्टरी बनाएँ
.envऔरdocker-compose.ymlको विन्यस्त करें- आवश्यक बाइनरीज़ को इमेज में बेक करें
docker compose up -d- persistence और Gateway एक्सेस सत्यापित करें
आपको क्या चाहिए
- root एक्सेस के साथ Hetzner VPS
- अपने लैपटॉप से SSH एक्सेस
- SSH + कॉपी/पेस्ट में बुनियादी सहजता
- ~20 मिनट
- Docker और Docker Compose
- मॉडल प्रमाणीकरण क्रेडेंशियल्स
- वैकल्पिक प्रदाता क्रेडेंशियल्स
- WhatsApp QR
- Telegram bot टोकन
- Gmail OAuth
1. VPS प्रोविजन करें
Hetzner में Ubuntu या Debian VPS बनाएँ। root के रूप में कनेक्ट करें:2. Docker इंस्टॉल करें (VPS पर)
3. OpenClaw रिपॉज़िटरी क्लोन करें
4. स्थायी होस्ट डायरेक्टरी बनाएँ
Docker कंटेनर ephemeral होते हैं। सारा long-lived state होस्ट पर होना चाहिए।5. पर्यावरण चर विन्यस्त करें
रिपॉज़िटरी रूट में.env बनाएँ।
6. Docker Compose विन्यास
docker-compose.yml बनाएँ या अपडेट करें।
--allow-unconfigured is only for bootstrap convenience, it is not a replacement for a proper gateway configuration. Still set auth (gateway.auth.token or password) and use safe bind settings for your deployment.
7. आवश्यक बाइनरीज़ को इमेज में बेक करें (महत्वपूर्ण)
चल रहे कंटेनर के अंदर binaries इंस्टॉल करना एक जाल है। रनटाइम पर इंस्टॉल की गई कोई भी चीज़ रीस्टार्ट पर खो जाएगी। Skills द्वारा आवश्यक सभी बाहरी बाइनरीज़ को इमेज बिल्ड समय पर इंस्टॉल किया जाना चाहिए। नीचे दिए गए उदाहरण केवल तीन सामान्य बाइनरीज़ दिखाते हैं:- Gmail एक्सेस के लिए
gog - Google Places के लिए
goplaces - WhatsApp के लिए
wacli
- Dockerfile अपडेट करें
- इमेज को रीबिल्ड करें
- कंटेनरों को रीस्टार्ट करें
8. बिल्ड और लॉन्च करें
9. Gateway सत्यापित करें
http://127.0.0.1:18789/
अपना gateway टोकन पेस्ट करें।
क्या कहाँ स्थायी रहता है (source of truth)
OpenClaw Docker में चलता है, लेकिन Docker source of truth नहीं है। सारा long-lived state रीस्टार्ट, rebuilds और reboots के बाद भी बना रहना चाहिए।| घटक | स्थान | Persistence तंत्र | नोट्स |
|---|---|---|---|
| Gateway विन्यास | /home/node/.openclaw/ | होस्ट वॉल्यूम माउंट | openclaw.json, टोकन शामिल |
| मॉडल auth प्रोफ़ाइल | /home/node/.openclaw/ | होस्ट वॉल्यूम माउंट | OAuth टोकन, एपीआई कुंजियाँ |
| Skill विन्यास | /home/node/.openclaw/skills/ | होस्ट वॉल्यूम माउंट | Skill-स्तरीय state |
| एजेंट वर्कस्पेस | /home/node/.openclaw/workspace/ | होस्ट वॉल्यूम माउंट | कोड और एजेंट आर्टिफ़ैक्ट्स |
| WhatsApp सत्र | /home/node/.openclaw/ | होस्ट वॉल्यूम माउंट | QR लॉगिन को सुरक्षित रखता है |
| Gmail कीरिंग | /home/node/.openclaw/ | होस्ट वॉल्यूम + पासवर्ड | GOG_KEYRING_PASSWORD आवश्यक |
| बाहरी बाइनरीज़ | /usr/local/bin/ | Docker इमेज | बिल्ड समय पर बेक होना चाहिए |
| Node रनटाइम | कंटेनर फ़ाइलसिस्टम | Docker इमेज | हर इमेज बिल्ड पर रीबिल्ड |
| OS पैकेज | कंटेनर फ़ाइलसिस्टम | Docker इमेज | रनटाइम पर इंस्टॉल न करें |
| Docker कंटेनर | Ephemeral | रीस्टार्ट योग्य | नष्ट करना सुरक्षित |
इन्फ्रास्ट्रक्चर ऐज़ कोड (Terraform)
जो टीमें infrastructure-as-code वर्कफ़्लो को प्राथमिकता देती हैं, उनके लिए समुदाय द्वारा मेंटेन किया गया Terraform सेटअप प्रदान करता है:- रिमोट स्टेट मैनेजमेंट के साथ मॉड्यूलर Terraform कॉन्फ़िगरेशन
- cloud-init के माध्यम से स्वचालित प्रोविज़निंग
- डिप्लॉयमेंट स्क्रिप्ट्स (bootstrap, deploy, backup/restore)
- सुरक्षा सुदृढ़ीकरण (firewall, UFW, केवल SSH एक्सेस)
- gateway एक्सेस के लिए SSH टनल कॉन्फ़िगरेशन
- इन्फ्रास्ट्रक्चर: openclaw-terraform-hetzner
- Docker कॉन्फ़िग: openclaw-docker-config
नोट: समुदाय द्वारा मेंटेन किया गया। समस्याओं या योगदान के लिए, ऊपर दिए गए रिपॉज़िटरी लिंक देखें।