跳轉到主要內容

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

This doc describes the current first‑run onboarding flow. 目標是一個 順暢的「第 0 天」體驗：選擇 Gateway 的執行位置、連接驗證、執行精靈，並讓代理自行完成啟動。 如需了解入門流程的整體概覽，請參閱 Onboarding Overview。
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

Gateway 閘道器 在哪裡執行？
  • 此 Mac（僅限本機）： 導覽流程可以執行 OAuth 流程並在本機寫入憑證。
  • 遠端（透過 SSH/Tailnet）： 入門引導不會在本機執行 OAuth；認證資料必須已存在於閘道器主機。
  • 稍後設定： 略過設定，讓應用程式保持未設定狀態。
Gateway 驗證提示：
  • 精靈現在即使在 loopback 情況下也會產生一個 token，因此本機 WS 用戶端必須進行驗證。
  • If you disable auth, any local process can connect; use that only on fully trusted machines.
  • If you disable auth, any local process can connect; use that only on fully trusted machines.
  • 對於多機器存取或非 loopback 綁定，請使用 token。
5

Permissions

入門引導會請求所需的 TCC 權限，包括：
  • 自動化（AppleScript）
  • 通知
  • 無障礙
  • 螢幕錄製
  • 麥克風
  • 語音辨識
  • 相機
  • 位置資訊
6

CLI

  1. 此步驟為選用
應用程式可透過 npm/pnpm 安裝全域的 openclaw CLI，讓終端機工作流程與 launchd 工作能立即使用。
7

Onboarding Chat (dedicated session)

設定完成後，應用程式會開啟一個專用的新手引導聊天工作階段，讓代理 自我介紹並引導後續步驟。 這能讓首次執行的引導內容 與你的一般對話分開。 請參閱 Bootstrapping，了解 在第一次代理執行期間，閘道主機上會發生什麼事。