Agent Bootstrapping：讓你的 Agent 第一次啟動就上手

每次開始一個新專案，最煩人的往往不是核心開發，而是那堆瑣碎的初始化工作。手動建立資料夾、配置基礎設定檔，只要漏掉一個步驟，後面可能就會噴出一堆錯誤。這種重複性的「開工儀式」往往是開發者最想跳過的環節。

OpenClaw 的 Bootstrapping 機制就是為了幫你解決這個問題。它是一個「首航儀式」，確保你的 Agent 工作區在第一次啟動時就已經準備就緒。

需要準備的東西

• 完成 Onboarding 流程
• 準備好 Gateway host（本地機器或遠端伺服器）

快速開始

當你完成 Onboarding 並第一次啟動 Agent 時，OpenClaw 會自動執行以下流程，整個過程大約只需 5 分鐘：

1. 建立工作區：系統會在預設路徑 ~/.openclaw/workspace 產生必要的基礎檔案。
2. 生成種子檔案：你會看到目錄下出現了 AGENTS.md、BOOTSTRAP.md、IDENTITY.md 與 USER.md。
3. 進行 Q&A 儀式：系統會一次拋出一個問題，請根據你的偏好回答。
4. 寫入偏好設定：你的回答會被整理並寫入 IDENTITY.md、USER.md 和 SOUL.md 中。
5. 清理現場：一旦流程完成，系統會自動移除 BOOTSTRAP.md，確保這個初始化動作只會執行一次。

如果你是透過 macOS app 連接到遠端的 Gateway，請記住這些檔案是存在遠端機器上的。如果你需要手動編輯檔案，必須登入該台 Gateway host：

# 範例：登入遠端 Gateway 修改檔案
ssh user@gateway-host
cd ~/.openclaw/workspace

疑難排解

• 找不到工作區檔案：請確認你查看的是 Gateway host。如果你使用遠端 Gateway，檔案不會出現在你本地的 macOS 電腦上。
• Bootstrapping 沒有觸發：檢查工作區中是否還存在 BOOTSTRAP.md。如果該檔案已被移除，代表系統認為初始化已經完成。

如果你在設定過程中遇到任何卡關，可以直接詢問 AI Setup Assistant。

下一步

• Onboarding 流程指南
• 深入了解 Agent workspace 佈局