Remote na OpenClaw (macOS ⇄ remote host)¶

Pinapahintulutan ng daloy na ito ang macOS app na kumilos bilang ganap na remote control para sa isang OpenClaw gateway na tumatakbo sa ibang host (desktop/server). Ito ang tampok ng app na Remote over SSH (remote run). Lahat ng feature—health checks, Voice Wake forwarding, at Web Chat—ay gumagamit ng parehong remote SSH configuration mula sa Settings → General.

Mga mode¶

• Local (itong Mac): Lahat ay tumatakbo sa laptop. Walang kasamang SSH.
• Remote over SSH (default): Ang mga utos ng OpenClaw ay isinasagawa sa remote host. Nagbubukas ang mac app ng SSH connection gamit ang -o BatchMode kasama ang iyong napiling identity/key at isang lokal na port-forward.
• Remote direct (ws/wss): Walang SSH tunnel. Direktang kumokonekta ang mac app sa URL ng gateway (halimbawa, sa pamamagitan ng Tailscale Serve o isang pampublikong HTTPS reverse proxy).

Mga remote transport¶

Sinusuportahan ng remote mode ang dalawang transport:

• SSH tunnel (default): Ginagamit ang ssh -N -L ... upang i-forward ang port ng gateway papuntang localhost. Makikita ng gateway ang IP ng node bilang 127.0.0.1 dahil ang tunnel ay loopback.
• Direct (ws/wss): Direktang kumokonekta sa URL ng gateway. Nakikita ng gateway ang tunay na IP ng client.

Mga paunang kinakailangan sa remote host¶

1. I-install ang Node + pnpm at i-build/i-install ang OpenClaw CLI (pnpm install && pnpm build && pnpm link --global).
2. Tiyaking ang openclaw ay nasa PATH para sa mga non-interactive shell (mag-symlink sa /usr/local/bin o /opt/homebrew/bin kung kailangan).
3. Buksan ang SSH gamit ang key auth. Inirerekomenda namin ang mga IP ng Tailscale para sa matatag na koneksyon kahit wala sa LAN.

Setup ng macOS app¶

1. Buksan ang Settings → General.
2. Sa ilalim ng OpenClaw runs, piliin ang Remote over SSH at itakda ang: - Transport: SSH tunnel o Direct (ws/wss). - SSH target: user@host (opsyonal ang :port).
   • Kung ang gateway ay nasa parehong LAN at nag-a-advertise ng Bonjour, piliin ito mula sa discovered list para awtomatikong mapunan ang field na ito.
   • Gateway URL (Direct lamang): wss://gateway.example.ts.net (o ws://... para sa local/LAN).
   • Identity file (advanced): path papunta sa iyong key.
   • Project root (advanced): remote checkout path na ginagamit para sa mga command.
   • CLI path (advanced): opsyonal na path sa isang runnable na openclaw entrypoint/binary (awtomatikong napupunan kapag na-advertise).
3. Pindutin ang Test remote. Ibig sabihin ng tagumpay ay tumatakbo nang tama ang remote na openclaw status --json. Karaniwang nangangahulugan ng mga isyu sa PATH/CLI ang mga failure; ang exit 127 ay nangangahulugang hindi makita ang CLI sa remote.
4. Ang health checks at Web Chat ay tatakbo na ngayon sa pamamagitan ng SSH tunnel na ito nang awtomatiko.

Web Chat¶

• SSH tunnel: Kumokonekta ang Web Chat sa gateway sa pamamagitan ng forwarded WebSocket control port (default 18789).
• Direct (ws/wss): Direktang kumokonekta ang Web Chat sa naka-configure na gateway URL.
• Wala nang hiwalay na WebChat HTTP server.

Mga pahintulot¶

• Kailangan ng remote host ang parehong mga TCC approval tulad ng lokal (Automation, Accessibility, Screen Recording, Microphone, Speech Recognition, Notifications). Run onboarding on that machine to grant them once.
• Ina-advertise ng mga node ang kanilang permission state sa pamamagitan ng node.list / node.describe para malaman ng mga agent kung ano ang available.

Mga tala sa seguridad¶

• Mas mainam ang loopback binds sa remote host at kumonekta sa pamamagitan ng SSH o Tailscale.
• Kung i-bind mo ang Gateway sa isang non-loopback interface, mag-require ng token/password auth.
• Tingnan ang Security at Tailscale.

WhatsApp login flow (remote)¶

• Run openclaw channels login --verbose on the remote host. Scan the QR with WhatsApp on your phone.
• Patakbuhin muli ang pag-login sa host na iyon kung mag-expire ang auth. 8. Ilalabas ng health check ang mga problema sa link.

Pag-troubleshoot¶

• 9. exit 127 / not found: wala ang openclaw sa PATH para sa mga non-login shell. Add it to /etc/paths, your shell rc, or symlink into /usr/local/bin//opt/homebrew/bin.
• Health probe failed: suriin ang SSH reachability, PATH, at kung naka-login ang Baileys (openclaw status --json).
• Web Chat stuck: tiyaking tumatakbo ang gateway sa remote host at tugma ang forwarded port sa gateway WS port; nangangailangan ang UI ng healthy na WS connection.
• Node IP shows 127.0.0.1: expected with the SSH tunnel. Switch Transport to Direct (ws/wss) if you want the gateway to see the real client IP.
• Voice Wake: awtomatikong nafi-forward ang mga trigger phrase sa remote mode; walang hiwalay na forwarder na kailangan.

Mga tunog ng notification¶

Pumili ng mga tunog kada notification mula sa mga script gamit ang openclaw at node.invoke, hal.:

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

Wala nang global na toggle para sa “default sound” sa app; ang mga tumatawag ang pumipili ng tunog (o wala) kada request.