跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.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 主機上會發生什麼，請參閱 啟動。

​
相關