स्थान कमांड

सारांश

• location.get एक Node कमांड है, जिसे node.invoke या openclaw nodes location get के माध्यम से लागू किया जाता है।
• डिफ़ॉल्ट रूप से बंद।
• Android के तृतीय-पक्ष बिल्ड एक चयनकर्ता का उपयोग करते हैं: बंद / उपयोग करते समय / हमेशा। Play बिल्ड में बंद / उपयोग करते समय विकल्प ही रहते हैं।
• सटीक स्थान के लिए अलग टॉगल है।

चयनकर्ता क्यों (सिर्फ़ स्विच क्यों नहीं)

OS स्थान अनुमतियाँ बहु-स्तरीय होती हैं। सटीक स्थान भी OS की एक अलग अनुमति है (iOS 14+ में "Precise", Android में "fine" बनाम "coarse")। ऐप के भीतर का चयनकर्ता अनुरोधित मोड निर्धारित करता है, लेकिन वास्तविक अनुमति का निर्णय फिर भी OS ही करता है।

सेटिंग मॉडल

प्रत्येक Node डिवाइस के लिए:

• location.enabledMode: off | whileUsing | always
• location.preciseEnabled: bool

UI व्यवहार:

• whileUsing चुनने पर फ़ोरग्राउंड अनुमति का अनुरोध किया जाता है।
• Android के तृतीय-पक्ष बिल्ड में always चुनने पर पहले फ़ोरग्राउंड अनुमति का अनुरोध किया जाता है, फिर बैकग्राउंड पहुँच की व्याख्या की जाती है और अलग Allow all the time अनुमति के लिए Android ऐप सेटिंग खोली जाती हैं।
• Android Play बिल्ड बैकग्राउंड स्थान अनुमति घोषित नहीं करते और always नहीं दिखाते।
• यदि OS अनुरोधित स्तर अस्वीकार करता है, तो ऐप उच्चतम स्वीकृत स्तर पर वापस आ जाता है और स्थिति दिखाता है।

अनुमति मैपिंग (node.permissions)

वैकल्पिक। macOS Node, node.list/node.describe पर permissions मैप के माध्यम से location की रिपोर्ट करता है; iOS/Android इसे छोड़ सकते हैं।

कमांड: location.get

node.invoke या CLI सहायक के माध्यम से कॉल किया जाता है:

openclaw nodes location get --node <idOrNameOrIp>openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

पैरामीटर:

{  "timeoutMs": 10000,  "maxAgeMs": 15000,  "desiredAccuracy": "coarse|balanced|precise"}

CLI फ़्लैग सीधे मैप होते हैं: --location-timeout -> timeoutMs, --max-age -> maxAgeMs, --accuracy -> desiredAccuracy।

प्रतिक्रिया पेलोड:

{  "lat": 48.20849,  "lon": 16.37208,  "accuracyMeters": 12.5,  "altitudeMeters": 182.0,  "speedMps": 0.0,  "headingDeg": 270.0,  "timestamp": "2026-01-03T12:34:56.000Z",  "isPrecise": true,  "source": "gps|wifi|cell|unknown"}

त्रुटियाँ (स्थिर कोड):

• LOCATION_DISABLED: चयनकर्ता बंद है।
• LOCATION_PERMISSION_REQUIRED: अनुरोधित मोड के लिए अनुमति उपलब्ध नहीं है।
• LOCATION_BACKGROUND_UNAVAILABLE: ऐप बैकग्राउंड में है, लेकिन केवल उपयोग करते समय की अनुमति दी गई है।
• LOCATION_TIMEOUT: समय पर स्थान निर्धारण नहीं हुआ।
• LOCATION_UNAVAILABLE: सिस्टम विफलता या कोई प्रदाता उपलब्ध नहीं।

बैकग्राउंड व्यवहार

• Android के तृतीय-पक्ष बिल्ड बैकग्राउंड location.get को केवल तभी स्वीकार करते हैं, जब उपयोगकर्ता ने Always चुना हो और Android ने बैकग्राउंड स्थान की अनुमति दी हो। मौजूदा स्थायी Node सेवा location सेवा प्रकार जोड़ती है और सक्रिय रहते हुए Location: Always की सूचना देती है।
• Android Play बिल्ड और While Using मोड बैकग्राउंड में होने पर location.get अस्वीकार करते हैं।
• अन्य Node प्लेटफ़ॉर्म का व्यवहार भिन्न हो सकता है।

Linux Node होस्ट

बंडल किया गया Linux Node Plugin, Linux डेस्कटॉप ऐप के बिना हेडलेस होस्ट सहित, CLI openclaw node सेवा में location.get जोड़ता है। स्थान डिफ़ॉल्ट रूप से बंद होता है। इसे Plugin प्रविष्टि के अंतर्गत सक्षम करें, फिर Node सेवा पुनः आरंभ करें:

{  plugins: {    entries: {      "linux-node": {        config: {          location: { enabled: true },        },      },    },  },}

GeoClue2 और उसका where-am-i डेमो इंस्टॉल करें (Debian और Ubuntu पर geoclue-2-demo)। Node सेवा के उपयोगकर्ता को होस्ट की GeoClue नीति और प्राधिकरण एजेंट द्वारा अनुमति दी जानी चाहिए।

Plugin, busctl कॉलों के क्रम के बजाय where-am-i का उपयोग करता है। GeoClue क्लाइंट निर्माण, प्रॉपर्टी, आरंभ, अपडेट और समाप्ति को एक D-Bus क्लाइंट कनेक्शन से बाँधता है; डेमो इस जीवनचक्र को एक साथ रखता है, जबकि अलग-अलग busctl उप-प्रक्रियाएँ ऐसा नहीं करतीं। कोई npm निर्भरता नहीं जोड़ी जाती।

Linux, coarse, balanced और precise को GeoClue सटीकता स्तरों 4, 6 और 8 से मैप करता है। यह लौटाए गए टाइमस्टैम्प के आधार पर maxAgeMs को सत्यापित करता है। GeoClue का डेमो चयनित प्रदाता उजागर नहीं करता, इसलिए source, unknown होता है; isPrecise केवल तभी true होता है, जब रिपोर्ट की गई सटीकता 100 मीटर या उससे बेहतर हो।

Linux इन्हीं स्थिर त्रुटियों का उपयोग करता है: LOCATION_DISABLED, LOCATION_TIMEOUT और LOCATION_UNAVAILABLE।

मॉडल/टूलिंग एकीकरण

• एजेंट टूल: nodes टूल की location_get कार्रवाई (Node आवश्यक)।
• CLI: openclaw nodes location get --node <id>।
• एजेंट दिशानिर्देश: केवल तभी कॉल करें, जब उपयोगकर्ता ने स्थान सक्षम किया हो और वह इसके दायरे को समझता हो।

UX पाठ (सुझाया गया)

• बंद: "स्थान साझा करना अक्षम है।"
• उपयोग करते समय: "केवल जब OpenClaw खुला हो।"
• हमेशा: "OpenClaw के बैकग्राउंड में रहने के दौरान अनुरोधित स्थान जाँच की अनुमति दें।"
• सटीक: "सटीक GPS स्थान का उपयोग करें। अनुमानित स्थान साझा करने के लिए टॉगल बंद करें।"

संबंधित

• Nodes का अवलोकन
• चैनल स्थान पार्सिंग
• कैमरा कैप्चर
• वार्ता मोड