Onboarding (macOS App)（macOS 應用程式入門流程）

入門流程（macOS 應用程式）

本文件描述目前的首次執行入門流程。目標是提供流暢的「第 0 天」體驗：選擇 Gateway 執行位置、連接認證、執行精靈，並讓代理程式自我引導。 如需入門路徑的整體概覽，請參閱入門概覽。

1. 核准 macOS 警告

   
2. 核准尋找本地網路

   
3. 歡迎與安全性通知

   

   安全信任模型：

   • 預設情況下，OpenClaw 是個人代理程式：一個受信任的操作員邊界。
   • 共享/多使用者設定需要鎖定（分割信任邊界、保持最少工具存取，並遵循安全性）。
   • 本地入門現在預設將新設定的 tools.profile 設為 "coding"，因此新的本地設定無需強制使用不受限制的 full 設定檔，也能保留檔案系統/執行階段工具。
   • 如果啟用了 hooks/webhooks 或其他不受信任的內容饋送，請使用強大的現代模型層，並保持嚴格的工具政策/沙箱。
4. 本地 vs 遠端

   

   Gateway 在哪裡執行？

   • **此 Mac（僅限本地）：**入門可以設定認證並將憑證寫入本地。
   • 遠端（透過 SSH/Tailnet）：入門不會設定本地認證；憑證必須存在於 Gateway 主機上。
   • **稍後設定：**跳過設定，讓應用程式保持未配置。

   Gateway 認證提示：

   • 精靈現在即使對環回也會產生令牌，所以本地 WS 客戶端必須認證。
   • 如果您停用認證，任何本地程序都能連線；僅在完全信任的機器上這樣做。
   • 多機器存取或非環回綁定時使用令牌。
5. 權限

   

   入門請求以下功能所需的 TCC 權限：

   • 自動化（AppleScript）
   • 通知
   • 輔助功能
   • 螢幕錄製
   • 麥克風
   • 語音辨識
   • 相機
   • 位置
6. CLI

7. 入門聊天（專屬會話）

   設定完成後，應用程式會開啟一個專屬入門聊天會話，讓代理程式自我介紹並引導後續步驟。這使首次執行的指引與您的正常對話分開。請參閱引導，了解代理程式首次執行期間 Gateway 主機上發生的情況。