代理程式啟動設定

啟動初始化是首次執行時的必要流程，會為新的代理工作區建立初始內容，並引導代理選擇身分。此流程只會在完成初始設定後、代理第一次正式互動時執行一次。

執行內容

首次針對全新工作區執行時（預設為 ~/.openclaw/workspace）， OpenClaw 會：

• 建立 AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md 和 BOOTSTRAP.md 的初始內容。
• 讓代理依序完成最多三個步驟的誕生流程：詢問你想如何稱呼它、用一句簡短文字描述其靈魂／氛圍，並詢問你想要最精簡的建議外掛組合，還是最大程度的便利性。
• 將雙方確認的身分儲存兩次：寫入 IDENTITY.md 和 SOUL.md（代理讀取的自我資訊），並透過 openclaw agents set-identity 儲存（頻道和使用者介面顯示的資訊）。
• 直接讀取初始設定期間已儲存的應用程式建議，不再重新掃描。官方外掛使用 openclaw plugins install <id>；第三方 ClawHub Skills 則仍須明確選擇加入。處理完選擇後，代理會確認已儲存的提議，確保不再詢問。
• 工作區看起來已完成設定後，刪除 BOOTSTRAP.md，因此此流程只會執行一次。

只要 SOUL.md、IDENTITY.md 或 USER.md 已不同於其初始範本，或存在 memory/ 資料夾，工作區就會視為已完成設定。

內嵌與本機模型執行

對於內嵌或本機模型執行，OpenClaw 不會將 BOOTSTRAP.md 放入具特殊權限的系統內容中。在主要互動式首次執行期間，仍會透過使用者提示傳入檔案內容，因此無法可靠呼叫 read 工具的模型也能完成此流程。如果目前的執行無法安全存取工作區，代理會收到一則簡短的受限啟動初始化說明，而不是一般問候語。

略過啟動初始化

若要在已預先建立初始內容的工作區略過此流程，請執行：

openclaw onboard --skip-bootstrap

執行位置

啟動初始化一律在閘道主機上執行。如果 macOS 應用程式連線至遠端閘道，工作區及其啟動初始化檔案會位於該遠端機器上，而不是 Mac 上。

相關文件

• macOS 應用程式初始設定：初始設定
• 工作區配置：代理工作區
• 範本內容：BOOTSTRAP.md 範本