> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway लॉक

## क्यों

* सुनिश्चित करें कि उसी होस्ट पर प्रति बेस पोर्ट केवल एक Gateway इंस्टेंस चले; अतिरिक्त Gateway को अलग-थलग प्रोफ़ाइल और अद्वितीय पोर्ट का उपयोग करना होगा।
* क्रैश/SIGKILL के बाद भी stale लॉक फ़ाइलें छोड़े बिना जारी रहें।
* जब कंट्रोल पोर्ट पहले से व्यस्त हो, तो स्पष्ट त्रुटि के साथ तुरंत विफल हों।

## तंत्र

* Gateway पहले स्टेट लॉक डायरेक्टरी के तहत प्रति-कॉन्फ़िग लॉक फ़ाइल प्राप्त करता है और किसी मौजूदा listener के लिए कॉन्फ़िगर किए गए पोर्ट की जांच करता है।
* यदि दर्ज किया गया लॉक owner समाप्त हो चुका है, पोर्ट खाली है, या लॉक stale है, तो startup लॉक को फिर से हासिल करता है और जारी रहता है।
* इसके बाद Gateway एक exclusive TCP listener का उपयोग करके HTTP/WebSocket listener (डिफ़ॉल्ट `ws://127.0.0.1:18789`) को bind करता है।
* यदि bind `EADDRINUSE` के साथ विफल होता है, तो startup `GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:<port>")` फेंकता है।
* shutdown पर Gateway HTTP/WebSocket server को बंद करता है और लॉक फ़ाइल हटाता है।

## त्रुटि सतह

* यदि कोई दूसरा process पोर्ट को hold कर रहा है, तो startup `GatewayLockError("another gateway instance is already listening on ws://127.0.0.1:<port>")` फेंकता है।
* अन्य bind विफलताएं `GatewayLockError("failed to bind gateway socket on ws://127.0.0.1:<port>: …")` के रूप में सामने आती हैं।

## संचालन संबंधी नोट्स

* यदि पोर्ट *किसी अन्य* process द्वारा occupied है, तो त्रुटि वही रहती है; पोर्ट खाली करें या `openclaw gateway --port <port>` के साथ दूसरा चुनें।
* किसी service supervisor के तहत, नया Gateway process जो मौजूदा स्वस्थ `/healthz` responder देखता है, उस process को नियंत्रण में रहने देता है। systemd पर, duplicate starter कोड 78 के साथ exit करता है ताकि डिफ़ॉल्ट `RestartPreventExitStatus=78` `Restart=always` को लॉक या `EADDRINUSE` conflict पर loop करने से रोक सके। यदि मौजूदा process कभी healthy नहीं बनता, तो retries सीमित रहती हैं और startup हमेशा loop करने के बजाय स्पष्ट लॉक त्रुटि के साथ विफल होता है।
* macOS app अभी भी Gateway spawn करने से पहले अपना हल्का PID guard बनाए रखता है; runtime लॉक को लॉक फ़ाइल और HTTP/WebSocket bind द्वारा enforce किया जाता है।

## संबंधित

* [एकाधिक Gateway](/hi/gateway/multiple-gateways) — अद्वितीय पोर्ट के साथ कई इंस्टेंस चलाना
* [समस्या निवारण](/hi/gateway/troubleshooting) — `EADDRINUSE` और पोर्ट conflicts का निदान करना