入門 (macOS 應用程式)
本文描述了目前的首次執行設定流程。目標是提供流暢的「第 0 天」體驗:選擇 Gateway 的執行位置、連接驗證、執行精靈,然後讓代理程式自行引導。 如需關於入門路徑的一般概覽,請參閱 Onboarding Overview。
核准 macOS 警告

Approve find local networks

歡迎與安全性注意事項

安全性信任模型:
- 預設情況下,OpenClaw 是個人代理程式:單一信任的操作員邊界。
- 共用/多使用者設定需要鎖定(分隔信任邊界、保持工具存取權限最小化,並遵循安全性)。
- 本機入門現在會將新設定預設為
tools.profile: "coding",讓全新的本機設定保留檔案系統/執行階段工具,而不強制使用不受限的full設定檔。 - 如果啟用了 hooks/webhooks 或其他不受信任的內容來源,請使用強大的現代模型層級,並保持嚴格的工具原則/沙箱機制。
本機與遠端

Gateway 在何處執行?
- 此 Mac (僅限本機): 入門程序可以在本機設定驗證並寫入憑證。
- 遠端 (透過 SSH/Tailnet): 入門程序不會設定本機驗證;憑證必須存在於 gateway 主機上。
- 稍後設定: 略過設定並讓應用程式保持未設定狀態。
權限

Onboarding 會請求所需的 TCC 權限,範圍包括:
- 自動化 (AppleScript)
- 通知
- 輔助使用
- 螢幕錄製
- 麥克風
- 語音辨識
- 相機
- 位置
CLI
應用程式可透過 npm、pnpm 或 bun 安裝全域
openclawCLI。 它會優先使用 npm,其次是 pnpm,若僅偵測到 bun 則使用 bun。對於 Gateway 執行時,Node 仍是推薦的路徑。入門聊天 (專屬工作階段)
設定完成後,應用程式會開啟專屬的入門聊天工作階段,讓代理程式能夠自我介紹並引導後續步驟。這能讓首次執行的指引與您的一般對話保持分開。如需關於第一次執行代理程式時 gateway 主機上發生什麼的資訊,請參閱 Bootstrapping。