入門引導（macOS 應用程式）¶

This doc describes the current first‑run onboarding flow. 7. 目標是一個 順暢的「第 0 天」體驗：選擇 Gateway 的執行位置、連接驗證、執行精靈，並讓代理自行完成啟動。

Gateway 閘道器 在哪裡執行？

• 8. 此 Mac（僅限本機）： 導覽流程可以執行 OAuth 流程並在本機寫入憑證。
• 遠端（透過 SSH/Tailnet）： 入門引導不會在本機執行 OAuth；認證資料必須已存在於閘道器主機。
• 稍後設定： 略過設定，讓應用程式保持未設定狀態。

9. Gateway 驗證提示： - 精靈現在即使在 loopback 情況下也會產生一個 token，因此本機 WS 用戶端必須進行驗證。 - If you disable auth, any local process can connect; use that only on fully trusted machines. - 對於多機器存取或非 loopback 綁定，請使用 token。

入門引導會請求所需的 TCC 權限，包括：

• 自動化（AppleScript）
• 通知
• 無障礙
• 螢幕錄製
• 麥克風
• 語音辨識
• 相機
• 位置資訊

14. 此步驟為選用 應用程式可透過 npm/pnpm 安裝全域的 openclaw CLI，讓終端機工作流程與 launchd 工作能立即使用。 設定完成後，應用程式會開啟一個專用的新手引導聊天工作階段，讓代理 自我介紹並引導後續步驟。 這能讓首次執行的引導內容 與你的一般對話分開。 請參閱 Bootstrapping，了解 在第一次代理執行期間，閘道主機上會發生什麼事。