Android ऐप

​

समर्थन स्नैपशॉट

• भूमिका: साथी नोड ऐप (Android Gateway होस्ट नहीं करता)।
• Gateway आवश्यक: हाँ (इसे macOS, Linux, या WSL2 के माध्यम से Windows पर चलाएँ)।
• इंस्टॉल करें: ऐप के लिए Google Play, Gateway के लिए प्रारंभ करना, फिर पेयरिंग।
• Gateway: रनबुक + कॉन्फ़िगरेशन।
  • प्रोटोकॉल: Gateway प्रोटोकॉल (नोड + नियंत्रण प्लेन)।

​

सिस्टम नियंत्रण

​

कनेक्शन रनबुक

• प्राथमिकता: Tailscale Serve / Funnel, https://<magicdns> / wss://<magicdns> के साथ
• समर्थित भी: वास्तविक TLS एंडपॉइंट वाला कोई अन्य wss:// Gateway URL
• क्लियरटेक्स्ट ws:// निजी LAN पतों / .local होस्टों, साथ ही localhost, 127.0.0.1, और Android एम्युलेटर ब्रिज (10.0.2.2) पर समर्थित रहता है

​

पूर्वापेक्षाएँ

• आप “मास्टर” मशीन पर Gateway चला सकते हैं।
• Android डिवाइस/एम्युलेटर Gateway WebSocket तक पहुँच सकता है:
  • mDNS/NSD के साथ वही LAN, या
  • Wide-Area Bonjour / unicast DNS-SD का उपयोग करके वही Tailscale tailnet (नीचे देखें), या
  • मैनुअल Gateway होस्ट/पोर्ट (fallback)
• Tailnet/सार्वजनिक मोबाइल पेयरिंग कच्चे tailnet IP ws:// एंडपॉइंट का उपयोग नहीं करती। इसके बजाय Tailscale Serve या किसी अन्य wss:// URL का उपयोग करें।
• आप Gateway मशीन पर CLI (openclaw) चला सकते हैं (या SSH के माध्यम से)।

​

1) Gateway शुरू करें

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) डिस्कवरी सत्यापित करें (वैकल्पिक)

dns-sd -B _openclaw-gw._tcp local.

openclaw gateway discover --json

​

unicast DNS-SD के माध्यम से Tailnet (Vienna ⇄ London) डिस्कवरी

1. Gateway होस्ट पर DNS-SD ज़ोन (उदाहरण openclaw.internal.) सेट अप करें और _openclaw-gw._tcp रिकॉर्ड प्रकाशित करें।
2. अपने चुने हुए डोमेन के लिए Tailscale split DNS कॉन्फ़िगर करें, जो उस DNS सर्वर की ओर संकेत करे।

​

3) Android से कनेक्ट करें

• ऐप अपनी Gateway कनेक्शन को फ़ोरग्राउंड सेवा (स्थायी नोटिफ़िकेशन) के माध्यम से जीवित रखता है।
• कनेक्ट टैब खोलें।
• सेटअप कोड या मैनुअल मोड का उपयोग करें।
• यदि डिस्कवरी अवरुद्ध है, तो उन्नत नियंत्रण में मैनुअल होस्ट/पोर्ट का उपयोग करें। निजी LAN होस्टों के लिए, ws:// अभी भी काम करता है। Tailscale/सार्वजनिक होस्टों के लिए, TLS चालू करें और wss:// / Tailscale Serve एंडपॉइंट का उपयोग करें।

• मैनुअल एंडपॉइंट (यदि सक्षम हो), अन्यथा
• पिछला खोजा गया Gateway (सर्वोत्तम प्रयास)।

​

Presence alive बीकन

​

4) पेयरिंग अनुमोदित करें (CLI)

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

​

5) सत्यापित करें कि नोड कनेक्टेड है

• नोड स्थिति के माध्यम से:
  openclaw nodes status
  
• Gateway के माध्यम से:
  openclaw gateway call node.list --params "{}"
  

​

6) चैट + इतिहास

• इतिहास: chat.history (display-normalized; inline directive tags को visible text से हटाया जाता है, plain-text tool-call XML payloads (जिसमें <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls>, और truncated tool-call blocks शामिल हैं) और leaked ASCII/full-width model control tokens हटाए जाते हैं, exact NO_REPLY / no_reply जैसी pure silent-token assistant rows छोड़ी जाती हैं, और oversized rows को placeholders से बदला जा सकता है)
• भेजें: chat.send
• Push updates (best-effort): chat.subscribe → event:"chat"

​

7) Canvas + कैमरा

​

Gateway Canvas Host (वेब सामग्री के लिए अनुशंसित)

1. Gateway होस्ट पर ~/.openclaw/workspace/canvas/index.html बनाएँ।
2. नोड को उस पर नेविगेट करें (LAN):

openclaw nodes invoke --node "<Android Node>" --command canvas.navigate --params '{"url":"http://<gateway-hostname>.local:18789/__openclaw__/canvas/"}'

• canvas.eval, canvas.snapshot, canvas.navigate (डिफ़ॉल्ट scaffold पर लौटने के लिए {"url":""} या {"url":"/"} का उपयोग करें)। canvas.snapshot { format, base64 } लौटाता है (डिफ़ॉल्ट format="jpeg")।
• A2UI: canvas.a2ui.push, canvas.a2ui.reset (canvas.a2ui.pushJSONL legacy alias)। ये commands action-capable rendering के लिए bundled app-owned A2UI page का उपयोग करते हैं।

• camera.snap (jpg)
• camera.clip (mp4)

​

8) वॉइस + विस्तृत Android command surface

• वॉइस टैब: Android में दो explicit capture modes हैं। Mic एक मैनुअल वॉइस-टैब सत्र है जो प्रत्येक pause को chat turn के रूप में भेजता है और ऐप के foreground छोड़ने या उपयोगकर्ता के वॉइस टैब छोड़ने पर रुक जाता है। Talk निरंतर Talk Mode है और toggled off होने या नोड disconnect होने तक सुनता रहता है।
• Talk Mode capture शुरू होने से पहले मौजूदा foreground service को connectedDevice से connectedDevice|microphone में promote करता है, फिर Talk Mode रुकने पर उसे demote करता है। नोड सेवा CHANGE_NETWORK_STATE के साथ FOREGROUND_SERVICE_CONNECTED_DEVICE घोषित करती है; Android 14+ को FOREGROUND_SERVICE_MICROPHONE घोषणा, RECORD_AUDIO runtime grant, और runtime पर microphone service type भी चाहिए।
• डिफ़ॉल्ट रूप से, Android Talk native speech recognition, Gateway chat, और configured gateway Talk provider के माध्यम से talk.speak का उपयोग करता है। Local system TTS का उपयोग केवल तब होता है जब talk.speak उपलब्ध नहीं होता।
• Android Talk realtime Gateway relay का उपयोग केवल तब करता है जब talk.realtime.mode realtime हो और talk.realtime.transport gateway-relay हो।
• वॉइस wake Android UX/runtime में अक्षम रहता है।
• अतिरिक्त Android command families (उपलब्धता डिवाइस, permissions, और user settings पर निर्भर करती है):
  • device.status, device.info, device.permissions, device.health
  • device.apps केवल तब जब Settings > Phone Capabilities > Installed Apps सक्षम हो; यह डिफ़ॉल्ट रूप से launcher-visible apps सूचीबद्ध करता है।
  • notifications.list, notifications.actions (नीचे नोटिफ़िकेशन फ़ॉरवर्डिंग देखें)
  • photos.latest
  • contacts.search, contacts.add
  • calendar.events, calendar.add
  • callLog.search
  • sms.search
  • motion.activity, motion.pedometer

​

सहायक entrypoints

​

नोटिफ़िकेशन फ़ॉरवर्डिंग

{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}

​

संबंधित

• iOS ऐप
• नोड्स
• Android नोड समस्या निवारण