Skip to main content

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 तक पहुँच बनाना
Gateway तक निम्न तरीकों से पहुँचा जा सकता है:
  • आपके लैपटॉप से SSH पोर्ट फ़ॉरवर्डिंग
  • यदि आप फ़ायरवॉलिंग और टोकन स्वयं प्रबंधित करते हैं तो सीधे पोर्ट एक्सपोज़र
यह गाइड Hetzner पर Ubuntu या Debian मानकर चलती है।
यदि आप किसी अन्य Linux VPS पर हैं, तो पैकेजों को उसी अनुसार मैप करें। सामान्य Docker फ्लो के लिए, देखें Docker

त्वरित मार्ग (अनुभवी ऑपरेटर)

  1. Hetzner VPS प्रोविजन करें
  2. Docker इंस्टॉल करें
  3. OpenClaw रिपॉज़िटरी क्लोन करें
  4. स्थायी होस्ट डायरेक्टरी बनाएँ
  5. .env और docker-compose.yml को विन्यस्त करें
  6. आवश्यक बाइनरीज़ को इमेज में बेक करें
  7. docker compose up -d
  8. persistence और Gateway एक्सेस सत्यापित करें

आपको क्या चाहिए

  • root एक्सेस के साथ Hetzner VPS
  • अपने लैपटॉप से SSH एक्सेस
  • SSH + कॉपी/पेस्ट में बुनियादी सहजता
  • ~20 मिनट
  • Docker और Docker Compose
  • मॉडल प्रमाणीकरण क्रेडेंशियल्स
  • वैकल्पिक प्रदाता क्रेडेंशियल्स
    • WhatsApp QR
    • Telegram bot टोकन
    • Gmail OAuth

1. VPS प्रोविजन करें

Hetzner में Ubuntu या Debian VPS बनाएँ। root के रूप में कनेक्ट करें:
यह गाइड मानती है कि VPS stateful है। इसे disposable infrastructure की तरह न मानें।

2. Docker इंस्टॉल करें (VPS पर)

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

3. OpenClaw रिपॉज़िटरी क्लोन करें

यह गाइड मानती है कि आप बाइनरी persistence की गारंटी के लिए एक कस्टम इमेज बनाएँगे।

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
ये उदाहरण हैं, पूरी सूची नहीं। आप उसी पैटर्न का उपयोग करके जितनी चाहें binaries इंस्टॉल कर सकते हैं। यदि आप बाद में नए Skills जोड़ते हैं जो अतिरिक्त बाइनरीज़ पर निर्भर करते हैं, तो आपको करना होगा:
  1. Dockerfile अपडेट करें
  2. इमेज को रीबिल्ड करें
  3. कंटेनरों को रीस्टार्ट करें
उदाहरण 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 के बाद भी बना रहना चाहिए।

इन्फ्रास्ट्रक्चर ऐज़ कोड (Terraform)

जो टीमें infrastructure-as-code वर्कफ़्लो को प्राथमिकता देती हैं, उनके लिए समुदाय द्वारा मेंटेन किया गया Terraform सेटअप प्रदान करता है:
  • रिमोट स्टेट मैनेजमेंट के साथ मॉड्यूलर Terraform कॉन्फ़िगरेशन
  • cloud-init के माध्यम से स्वचालित प्रोविज़निंग
  • डिप्लॉयमेंट स्क्रिप्ट्स (bootstrap, deploy, backup/restore)
  • सुरक्षा सुदृढ़ीकरण (firewall, UFW, केवल SSH एक्सेस)
  • gateway एक्सेस के लिए SSH टनल कॉन्फ़िगरेशन
रिपॉज़िटरीज़: यह तरीका ऊपर दिए गए Docker सेटअप को पुनरुत्पादन योग्य डिप्लॉयमेंट, वर्ज़न-कंट्रोल्ड इन्फ्रास्ट्रक्चर और स्वचालित डिज़ास्टर रिकवरी के साथ पूरक बनाता है।
नोट: समुदाय द्वारा मेंटेन किया गया। समस्याओं या योगदान के लिए, ऊपर दिए गए रिपॉज़िटरी लिंक देखें।