रिमोट कंट्रोल

यह flow macOS ऐप को किसी अन्य host (desktop/server) पर चल रहे OpenClaw Gateway के लिए पूर्ण remote control की तरह काम करने देता है। ऐप trusted LAN/Tailnet Gateway URLs से सीधे connect कर सकता है या remote Gateway के केवल loopback होने पर SSH tunnel manage कर सकता है। Health checks, Voice Wake forwarding, और Web Chat Settings → General से वही remote configuration reuse करते हैं।

Modes

• Local (यह Mac): सब कुछ laptop पर चलता है। SSH शामिल नहीं है।
• Remote over SSH (default): OpenClaw commands remote host पर execute होते हैं। mac ऐप -o BatchMode के साथ आपकी चुनी हुई identity/key और local port-forward का उपयोग करके SSH connection खोलता है।
• Remote direct (ws/wss): कोई SSH tunnel नहीं। mac ऐप Gateway URL से सीधे connect करता है (उदाहरण के लिए, LAN, Tailscale, Tailscale Serve, या public HTTPS reverse proxy के माध्यम से)।

Remote transports

Remote mode दो transports support करता है:

• SSH tunnel (default): Gateway port को localhost पर forward करने के लिए ssh -N -L ... का उपयोग करता है। Gateway को Node का IP 127.0.0.1 दिखेगा क्योंकि tunnel loopback है।
• Direct (ws/wss): Gateway URL से सीधे connect करता है। Gateway को वास्तविक client IP दिखता है।

ऐप app-owned SSH processes के लिए SSH connection multiplexing और post-authentication backgrounding disable करता है, ताकि selected alias में ControlMaster या ForkAfterAuthentication enabled होने पर भी वह exact process को monitor और restart कर सके।

SSH host-key verification default रूप से strict है क्योंकि Gateway credentials इस tunnel से होकर जाते हैं। किसी managed SSH alias के लिए, जिसका trust behavior आप स्पष्ट रूप से उपयोग करना चाहते हैं, openclaw-mac configure-remote --ssh-target <alias> --ssh-host-key-policy openssh के साथ opt in करें या gateway.remote.sshHostKeyPolicy को "openssh" पर set करें। यह opt-in effective OpenSSH host-key policy का उपयोग करता है; पहले alias और किसी matching Host * या system configuration की review करें। ऐप में या configure-remote के साथ SSH target बदलने पर policy strict पर reset हो जाती है, जब तक आप फिर से स्पष्ट रूप से opt in न करें।

SSH tunnel mode में, discovered LAN/tailnet hostnames gateway.remote.sshTarget के रूप में save किए जाते हैं। ऐप gateway.remote.url को local tunnel endpoint पर रखता है, उदाहरण के लिए ws://127.0.0.1:18789, ताकि CLI, Web Chat, और local node-host service सभी वही सुरक्षित loopback transport उपयोग करें। जब discovery raw Tailnet IPs और stable hostnames दोनों लौटाती है, तो ऐप Tailscale MagicDNS या LAN names को prefer करता है ताकि remote connections address changes के बाद बेहतर तरीके से बने रहें। अगर local tunnel port remote Gateway port से अलग है, तो gateway.remote.remotePort को remote host के port पर set करें।

Remote mode में browser automation CLI Node host के स्वामित्व में होता है, native macOS app Node के नहीं। संभव होने पर ऐप installed Node host service start करता है; अगर आपको उस Mac से browser control चाहिए, तो इसे openclaw node install ... और openclaw node start के साथ install/start करें (या foreground में openclaw node run ... चलाएं), फिर उस browser-capable Node को target करें।

Remote host पर prerequisites

1. Node + pnpm install करें और OpenClaw CLI build/install करें (pnpm install && pnpm build && pnpm link --global)।
2. सुनिश्चित करें कि non-interactive shells के लिए openclaw PATH पर है (जरूरत हो तो /usr/local/bin या /opt/homebrew/bin में symlink करें)।
3. केवल SSH transport के लिए: key auth के साथ SSH खोलें। Off-LAN stable reachability के लिए हम Tailscale IPs recommend करते हैं।

macOS app setup

Welcome flow के बिना ऐप को preconfigure करने के लिए:

openclaw-mac configure-remote \  --ssh-target user@gateway.local \  --local-port 18789 \  --remote-port 18789 \  --token "$OPENCLAW_GATEWAY_TOKEN"

Trusted LAN या Tailnet पर पहले से reachable Gateway के लिए, SSH को पूरी तरह skip करें:

openclaw-mac configure-remote \  --direct-url ws://192.168.0.202:18789 \  --token "$OPENCLAW_GATEWAY_TOKEN"

यह remote config लिखता है, onboarding complete mark करता है, और ऐप start होने पर selected transport को own करने देता है।

1. Settings → General खोलें।
2. OpenClaw runs के अंतर्गत, Remote चुनें और set करें:
   • Transport: SSH tunnel या Direct (ws/wss)।
   • SSH target: user@host (optional :port)।
     • अगर Gateway उसी LAN पर है और Bonjour advertise करता है, तो इस field को auto-fill करने के लिए discovered list से उसे चुनें।
   • Gateway URL (केवल Direct): wss://gateway.example.ts.net (या local/LAN के लिए ws://...)।
   • Identity file (advanced): आपकी key का path।
   • Project root (advanced): commands के लिए उपयोग किया गया remote checkout path।
   • CLI path (advanced): runnable openclaw entrypoint/binary का optional path (advertised होने पर auto-filled)।
3. Test remote दबाएं। Success का मतलब है कि remote openclaw status --json सही तरह चलता है। Failures आमतौर पर PATH/CLI issues होते हैं; exit 127 का मतलब है कि CLI remote पर नहीं मिला।
4. Health checks और Web Chat अब selected transport के माध्यम से automatically चलेंगे।

Web Chat

• SSH tunnel: Web Chat forwarded WebSocket control port (default 18789) पर Gateway से connect करता है।
• Direct (ws/wss): Web Chat configured Gateway URL से सीधे connect करता है।
• अब कोई अलग WebChat HTTP server नहीं है।

Permissions

• Remote host को local जैसी ही TCC approvals चाहिए (Automation, Accessibility, Screen Recording, Microphone, Speech Recognition, Notifications)। इन्हें एक बार grant करने के लिए उस machine पर onboarding चलाएं।
• Nodes अपनी permission state node.list / node.describe के माध्यम से advertise करते हैं ताकि agents जान सकें कि क्या available है।

Security notes

• Remote host पर loopback binds prefer करें और SSH, Tailscale Serve, या trusted Tailnet/LAN direct URL के माध्यम से connect करें।
• SSH tunneling default रूप से पहले से trusted host key require करता है। पहले host key पर trust करें ताकि वह configured known-hosts file में मौजूद हो, या किसी managed alias के लिए, जिसकी OpenSSH trust policy आप accept करते हैं, स्पष्ट रूप से gateway.remote.sshHostKeyPolicy: "openssh" चुनें।
• अगर आप Gateway को non-loopback interface पर bind करते हैं, तो valid Gateway auth require करें: token, password, या gateway.auth.mode: "trusted-proxy" वाला identity-aware reverse proxy।
• Security और Tailscale देखें।

WhatsApp login flow (remote)

• Remote host पर openclaw channels login --verbose चलाएं। अपने phone पर WhatsApp से QR scan करें।
• अगर auth expire हो जाए, तो उसी host पर login फिर से चलाएं। Health check link problems दिखाएगा।

Troubleshooting

• exit 127 / not found: non-login shells के लिए openclaw PATH पर नहीं है। इसे /etc/paths, अपने shell rc में add करें, या /usr/local/bin//opt/homebrew/bin में symlink करें।
• Health probe failed: SSH reachability, PATH, और यह check करें कि Baileys logged in है (openclaw status --json)।
• Web Chat stuck: confirm करें कि Gateway remote host पर चल रहा है और forwarded port Gateway WS port से match करता है; UI को healthy WS connection चाहिए।
• Node IP shows 127.0.0.1: SSH tunnel के साथ expected है। अगर आप चाहते हैं कि Gateway को real client IP दिखे, तो Transport को Direct (ws/wss) पर switch करें।
• Dashboard works but Mac capabilities are offline: इसका मतलब है कि ऐप का operator/control connection healthy है, लेकिन companion Node connection connected नहीं है या उसका command surface missing है। Menu bar device section खोलें और check करें कि Mac paired · disconnected है या नहीं। wss://*.ts.net Tailscale Serve endpoints के लिए, ऐप certificate rotation के बाद stale legacy TLS leaf pins detect करता है, macOS द्वारा नए certificate पर trust करने पर stale pin clear करता है, और automatically retry करता है। अगर certificate system-trusted नहीं है या host Tailscale Serve name नहीं है, तो gateway.remote.tlsFingerprint को expected certificate fingerprint पर set करें, certificate review करें, या Remote over SSH पर switch करें।
• Voice Wake: remote mode में trigger phrases automatically forward होते हैं; अलग forwarder की जरूरत नहीं है।

Notification sounds

openclaw और node.invoke वाले scripts से प्रति notification sounds चुनें, जैसे:

openclaw nodes notify --node <id> --title "Ping" --body "Remote gateway ready" --sound Glass

ऐप में अब कोई global "default sound" toggle नहीं है; callers हर request के लिए sound (या कोई sound नहीं) चुनते हैं।

Related

• macOS app
• Remote access