स्थान कमांड

TL;DR

• 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, CLI openclaw node सेवा में location.get जोड़ता है, जिसमें Linux डेस्कटॉप ऐप के बिना चलने वाले हेडलेस होस्ट भी शामिल हैं। स्थान डिफ़ॉल्ट रूप से बंद रहता है। इसे 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 का अवलोकन
• चैनल स्थान पार्सिंग
• कैमरा कैप्चर
• वार्ता मोड