掌握 Agent Runtime：打造你的 OpenClaw 核心

每次設定 AI Agent，最煩的就是要把一堆指令、背景設定和工具說明塞進 Prompt 裡。如果專案變大，這些內容會變得難以維護，甚至讓 Agent 在執行時因為上下文太亂而「斷片」。

OpenClaw 透過一個內嵌的 Agent Runtime（源自 pi-mono）來解決這個問題，讓你用結構化的方式管理 Agent 的靈魂與技能。

需要準備的東西

• 已安裝 OpenClaw
• 一個指定的 Workspace 目錄
• 基本的 JSON 配置知識

快速開始

想在 5 分鐘內讓你的 Agent 動起來，跟著這幾步走：

1. 初始化環境：執行 openclaw setup。這會幫你建立 ~/.openclaw/openclaw.json 並初始化 Workspace 檔案。
2. 設定 Workspace：在配置文件中指定 agents.defaults.workspace。
3. 填寫設定檔：在你的 Workspace 目錄下，編輯 AGENTS.md（指令）和 SOUL.md（性格）。
4. 啟動服務：確保基本配置包含 Workspace 路徑即可開始對話。

核心機制：Workspace 與 Bootstrap

OpenClaw 強制使用單一的 Workspace 目錄（agents.defaults.workspace），這也是 Agent 執行工具與讀取 Context 的唯一工作目錄（cwd）。

自動注入的 Bootstrap 檔案

在對話開始時，OpenClaw 會自動將 Workspace 內的檔案內容注入到 Context 中。你可以透過編輯這些檔案來形塑 Agent：

• AGENTS.md：操作指令與「記憶」
• SOUL.md：人格特質、邊界與語氣
• TOOLS.md：你對工具使用的筆記（例如 imsg 的慣例）
• BOOTSTRAP.md：第一次執行的啟動儀式（完成後會自動刪除）
• IDENTITY.md：Agent 的名稱、氛圍或 Emoji
• USER.md：你的個人檔案與偏好的稱呼

如果檔案是空的，OpenClaw 會跳過它；如果檔案太大，系統會自動截斷以節省 Token。如果你想針對預先配置好的 Workspace 停用自動建立功能，可以在配置中加入：

{ agent: { skipBootstrap: true } }

工具與技能系統

Built-in tools

核心工具（讀取、執行、編輯、寫入等）預設開啟。要注意 TOOLS.md 只是給 Agent 的「使用指南」，並不能決定哪些工具存在。如果你想控制 apply_patch 功能，需透過 tools.exec.applyPatch 設定。

Skills

OpenClaw 會從三個地方載入技能，如果名稱衝突，Workspace 的優先權最高：

1. Bundled: 隨軟體內建
2. Managed/local: 位於 ~/.openclaw/skills
3. Workspace: 位於 <workspace>/skills

串流與即時引導 (Steering)

當你在等待 Agent 回覆時，可以透過不同的 queue 模式來干預它：

• steer 模式：你的新訊息會直接插入目前的執行中。系統會在每次工具呼叫後檢查隊列，如果有新訊息，會跳過剩餘的工具並先處理你的要求。
• followup/collect 模式：新訊息會等到目前這一輪對話結束後，才開啟新的一輪。

關於 Block streaming（區塊串流），預設是關閉的。你可以透過 agents.defaults.blockStreamingDefault: "off" 來調整。如果你在 Telegram 以外的頻道使用，需要顯式開啟 *.blockStreaming: true。

Model 配置規範

在設定 agents.defaults.model 時，OpenClaw 使用第一個 / 來拆分供應商與模型名稱：

• 標準格式：provider/model（例如 openai/gpt-4o）
• 特殊路徑：如果模型 ID 本身包含斜槓（如 OpenRouter），請包含前綴：openrouter/moonshotai/kimi-k2
• 預設供應商：如果你省略前綴且 ID 中沒有斜槓，系統會將其視為預設供應商的模型。

疑難排解

• 檔案遺失問題：如果 Workspace 缺少必要的 .md 檔案，OpenClaw 會注入一行「missing file」標記。執行 openclaw setup 可以快速產生預設範本。
• BOOTSTRAP.md 重複出現：這個檔案只會在全新 Workspace 中建立。如果你完成儀式後手動刪除它，重啟後它不應該再出現。
• 訊息被跳過：如果你在 steer 模式下發送訊息，看到工具回傳 “Skipped due to queued user message.” 是正常現象，這代表 Agent 正在優先處理你的最新指示。

---

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

What’s Next:

• Group Chats 深入瞭解群組對話設定 🦞