Agent 初始化引導

初始化引導是首次執行時的引導儀式,負責準備 agent 工作區並收集身分資訊。它在 onboarding 完成後、agent 第一次啟動時觸發。

初始化引導做了什麼

Agent 首次執行時,OpenClaw 會初始化工作區(預設為 ~/.openclaw/workspace):

  • 產生 AGENTS.mdBOOTSTRAP.mdIDENTITY.mdUSER.md
  • 執行一段簡短的問答流程(一次一個問題)。
  • 將身分資訊和偏好寫入 IDENTITY.mdUSER.mdSOUL.md
  • 完成後移除 BOOTSTRAP.md,確保只執行一次。

執行位置

初始化引導一律在 gateway 主機上執行。如果 macOS app 連線到遠端 Gateway,工作區和引導檔案都位於那台遠端機器上。

注意: 當 Gateway 在另一台機器上執行時,請在 gateway 主機上編輯工作區檔案(例如 user@gateway-host:~/.openclaw/workspace)。

相關文件