Fundamentals

代理程式啟動程序

啟動設定是 首次執行 的準備流程,會準備代理程式工作區並收集身分詳細資料。它會在入門設定之後、代理程式第一次啟動時發生。

啟動設定會做什麼

在第一次代理程式執行時,OpenClaw 會啟動設定工作區(預設為 ~/.openclaw/workspace):

  • 建立初始 AGENTS.mdBOOTSTRAP.mdIDENTITY.mdUSER.md
  • 執行簡短的問答流程(一次一個問題)。
  • 將身分資料與偏好設定寫入 IDENTITY.mdUSER.mdSOUL.md
  • 完成後移除 BOOTSTRAP.md,讓它只執行一次。

對於嵌入式/本機模型執行,OpenClaw 會讓 BOOTSTRAP.md 保持在具特權的系統內容脈絡之外。在主要互動式首次執行時,它仍會在使用者提示中傳入檔案內容,讓無法可靠呼叫 read 工具的模型也能完成此流程。如果目前執行無法安全存取工作區,代理程式會收到有限的啟動設定說明,而不是一般問候語。

略過啟動設定

若要對已預先建立內容的工作區略過此步驟,請執行 openclaw onboard --skip-bootstrap

執行位置

啟動設定一律在 gateway 主機 上執行。如果 macOS app 連線到遠端 Gateway,工作區與啟動設定檔案會位於該遠端機器上。

相關文件