Pagsisimula (macOS App)¶

This doc describes the current first‑run onboarding flow. The goal is a smooth “day 0” experience: pick where the Gateway runs, connect auth, run the wizard, and let the agent bootstrap itself.

Saan tatakbo ang Gateway?

• Itong Mac (Lokal lamang): puwedeng patakbuhin ng onboarding ang mga OAuth flow at magsulat ng mga credential nang lokal.
• Remote (sa SSH/Tailnet): hindi nagpapatakbo ng OAuth nang lokal ang onboarding; dapat umiiral na ang mga credential sa host ng gateway.
• I-configure sa ibang pagkakataon: laktawan ang setup at iwanang hindi pa naka-configure ang app.

Tip sa gateway auth: - Gumagawa na ngayon ang wizard ng token kahit para sa loopback, kaya kailangang mag‑authenticate ang mga lokal na WS client. - Kung idi-disable mo ang auth, anumang lokal na proseso ay puwedeng kumonek; gamitin lamang ito sa mga ganap na pinagkakatiwalaang makina. - Gumamit ng token para sa multi‑machine access o mga non‑loopback bind.

Humihingi ang onboarding ng mga TCC permission na kailangan para sa:

• Awtomasyon (AppleScript)
• Mga Notification
• Pagiging naa-access
• Pag-record ng Screen
• Mikropono
• Pagkilala sa Boses
• Kamera
• Lokasyon

Opsyonal ang hakbang na ito Maaaring i-install ng app ang global openclaw CLI sa pamamagitan ng npm/pnpm upang gumana agad ang mga terminal workflow at mga launchd task. Pagkatapos ng setup, awtomatikong magbubukas ang app ng isang hiwalay na onboarding chat session upang maipakilala ng agent ang sarili nito at magabayan ang mga susunod na hakbang. Pinananatili nitong hiwalay ang gabay sa unang paggamit mula sa iyong normal na usapan. Tingnan ang Bootstrapping para sa kung ano ang nangyayari sa gateway host sa unang pagtakbo ng agent.