跳轉到主要內容
啟動初始化是首次執行的儀式，會為新的代理程式工作區植入初始內容，並引導代理程式選擇身分。它只會執行一次，也就是在入門設定之後、代理程式第一次真正回合時執行。

​
會發生什麼

在全新工作區（預設 ~/.openclaw/workspace）的第一次執行中，OpenClaw 會：
  • 植入 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md 和 BOOTSTRAP.md。
  • 讓代理程式遵循 BOOTSTRAP.md：透過自由形式的對話（不是固定的問答表單）決定名稱、性格和風格。
  • 將學到的內容寫入 IDENTITY.md、USER.md 和 SOUL.md。
  • 一旦工作區看起來已設定好，就刪除 BOOTSTRAP.md，讓這個儀式只執行一次。
當 SOUL.md、IDENTITY.md 或 USER.md 已偏離其初始範本，或存在 memory/ 資料夾時，工作區就會被視為已設定。
BOOTSTRAP.md 涵蓋完整的身分對話。請參閱其內容： BOOTSTRAP.md 範本。

​
嵌入式和本機模型執行

對於嵌入式或本機模型執行，OpenClaw 會將 BOOTSTRAP.md 排除在特權系統上下文之外。在主要互動式首次執行時，它仍會透過使用者提示傳遞檔案內容，因此即使模型無法可靠呼叫 read 工具，也仍能完成這個儀式。如果目前執行無法安全存取工作區，代理程式會收到簡短的有限啟動初始化提示，而不是一般問候語。

​
略過啟動初始化

若要在預先植入的工作區上略過此步驟，請執行： 
openclaw onboard --skip-bootstrap

​
執行位置

啟動初始化一律在閘道主機上執行。如果 macOS 應用程式連線到遠端閘道，工作區及其啟動初始化檔案會位於該遠端機器上，而不是 Mac 上。
當閘道在另一台機器上執行時，請在閘道主機上編輯工作區檔案（例如 user@gateway-host:~/.openclaw/workspace）。

​
相關文件