跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

本文件描述目前的首次執行設定流程。目標是提供順暢的「第 0 天」體驗：選擇 Gateway 的執行位置、連接驗證、執行精靈，並讓代理自行啟動。 如需 onboarding 路徑的一般概觀，請參閱 Onboarding 概觀。
1

核准 macOS 警告

2

允許尋找本機網路

3

歡迎與安全性通知

安全信任模型：
  • 預設情況下，OpenClaw 是個人代理：單一受信任的操作者邊界。
  • 共用/多使用者設定需要鎖定（分割信任邊界、將工具存取維持在最低限度，並遵循 安全性）。
  • 本機 onboarding 現在會將新設定預設為 tools.profile: "coding"，因此全新的本機設定會保留檔案系統/執行階段工具，而不會強制使用不受限制的 full 設定檔。
  • 如果啟用 hooks/webhooks 或其他不受信任的內容來源，請使用強大的現代模型等級，並維持嚴格的工具政策/沙箱化。
4

本機與遠端

Gateway 在哪裡執行？
  • 這台 Mac（僅限本機）： onboarding 可以設定驗證並在本機寫入憑證。
  • 遠端（透過 SSH/Tailnet）： onboarding 不會設定本機驗證；憑證必須存在於 Gateway 主機上。
  • 稍後設定： 跳過設定，讓應用程式保持未設定狀態。
Gateway 驗證提示：
  • 精靈現在即使對 loopback 也會產生權杖，因此本機 WS 用戶端必須驗證。
  • 如果停用驗證，任何本機程序都可以連線；只應在完全受信任的機器上這樣做。
  • 多機器存取或非 loopback 綁定請使用權杖。
5

權限

Onboarding 會要求下列所需的 TCC 權限：
  • 自動化（AppleScript）
  • 通知
  • 輔助使用
  • 螢幕錄製
  • 麥克風
  • 語音辨識
  • 相機
  • 位置
6

CLI

此步驟為選用
應用程式可以透過 npm、pnpm 或 bun 安裝全域 openclaw CLI。 它會優先使用 npm，其次是 pnpm，若 bun 是唯一偵測到的套件管理器才會使用 bun。 對於 Gateway 執行階段，Node 仍然是建議的路徑。
7

Onboarding 聊天（專用工作階段）

設定完成後，應用程式會開啟專用的 onboarding 聊天工作階段，讓代理能夠 介紹自己並引導後續步驟。這會將首次執行指引與你的正常對話分開。 請參閱 啟動，了解首次代理執行期間 Gateway 主機上會發生什麼事。

​
相關