打造完美 Openclaw 設定的剖析

一份完整的工作區檔案、技能、頻道、權限指南，以及如何正確配置它們。

大多數 OpenClaw 使用者安裝後，連接一個頻道，就再也沒打開過工作區資料夾。

這是個錯誤。

你的工作區是你 AI 助手行為的控制中心。它包含你的身份、自訂技能、頻道連接和記憶。一旦你了解每個檔案的位置，就能按照自己的需求精確配置 OpenClaw。

本指南將帶你了解最佳設定的完整結構。

附註：Openclaw 只是起點。

在我們的 Build With AI 社群中，我們會教你如何建立自訂的 Agent、應用程式和自動化流程，供自己使用或銷售給客戶。即將上線。

立即加入候補名單：https://return-my-time.kit.com/1bd2720397

-----------------------------------------

兩層配置，而非一層

在深入探討之前，有一件事值得先了解：OpenClaw 使用兩層配置。

第一層是你的工作區資料夾（通常是 ~/clawd/ 或你初始化時指定的位置）。這裡存放你的個人配置、技能、記憶和密碼。

第二層是全域安裝目錄，位於 opt/homebrew/lib/node_modules/clawdbot/（或你系統上的對應路徑）。這裡包含核心文件、內建技能和預設行為。

你的工作區負責自訂。全域安裝則負責更新。

AGENTS.md：你的操作指令

這是整個設定中最重要的檔案。當 OpenClaw 啟動一個會話時，它首先讀取的就是 AGENTS.md。它會將內容直接載入系統提示詞，並在整個對話過程中牢記。

簡單來說：你在 AGENTS.md 中寫了什麼，你的 Agent 就會遵循什麼。

如果你告訴它每次建議會議時間前一定要檢查你的行事曆，它就會照做。如果你說「未經我明確批准，絕不發送電子郵件」，它每次都會遵守。

AGENTS.md 中真正該放的內容：

要寫：

• 你的核心操作指令（Agent 的任務是什麼？）
• 關鍵工具及其使用方法（電子郵件 CLI、任務管理工作流程）
• 絕不能違反的硬性規則
• 重要資源的連結（API 文件、技能位置）
• 工作流程觸發條件（應該自動發生什麼事）

不要寫：

• 可以改用連結提供的完整文件
• 說明理論的長段落
• 經常變動的資訊

保持 AGENTS.md 在 300 行以內。超過這個長度的檔案會佔用過多上下文，實際上的指令遵循度反而會下降。

以下是一個精簡但有效的範例：

1# AGENTS.md - Clawdbot 工作區
2
3## 核心操作指令
4我的助理扮演我業務的主動幫手角色。
5
6**使命：**
7- 盡可能減輕我的負擔
8- 主動出擊 —— 不要等我開口
9
10## 關鍵工具
11- **電子郵件：** 每天檢查收件匣，標記緊急項目
12- **行事曆：** 排程前確認沒有衝突
13- **任務管理：** 將完成的工作同步到儀表板
14
15## 硬性規則
16- 未經明確許可，絕不重新啟動服務
17- 排程前務必使用 `date` 指令確認日期
18- 將所有完成的工作記錄到追蹤系統

這大約是 20 行的核心指令。它能給你的 Agent 所需的一切，讓它高效工作，無需不斷澄清。

SOUL.md：角色與邊界

SOUL.md 定義你的 Agent 是誰，以及它應該如何溝通。這裡是人格個性的所在。

1# SOUL.md - 角色與邊界
2
3- 回覆保持簡潔直接。
4- 必要時提出釐清問題。
5- 切勿向外部訊息傳送面發送串流/部分回覆。

如果說 AGENTS.md 是使用手冊，那麼 SOUL.md 就是個人檔案。有些使用者會在這裡寫下詳盡的角色設定，有些則保持簡潔。兩種方式都可行，取決於你想要多少個性化自訂。

IDENTITY.md 與 USER.md：誰是誰

這兩個檔案建立你的 Agent 與你之間的關係。

IDENTITY.md 定義你的 Agent：

1# IDENTITY.md - Agent 身份
2
3- 名字：[你的 Agent 名稱]
4- 物種：[可選：有趣的描述詞]
5- 風格：聰明、 helpful、可靠、堅持不懈的問題解決者
6- 表情符號：[你選擇的表情符號]

USER.md 定義你：

1# USER.md - 使用者檔案
2
3- 名字：[你的名字]
4- 偏好稱呼：[暱稱]
5- 時區：[你的時區]
6- 電話：[你的號碼]
7- 行事曆：[行事曆平台與電子郵件]

為什麼要分成兩個檔案？因為它們用途不同。IDENTITY.md 設定後鮮少變動。USER.md 則會隨著你的偏好演進而更新。將它們分開能讓維護更容易。

HEARTBEAT.md：排程檢查

這個檔案控制你的 Agent 在心跳檢查（系統定期查看是否需要處理任何事項的排程時刻）期間的行為。

1# HEARTBEAT.md
2
3**如果訊息包含 "⚠️ EXECUTION CRON"：**
4- 這不是心跳檢查 —— 這是待辦工作
5- 閱讀訊息中的完整指示
6- 執行所有必要步驟
7- 絕不回傳 HEARTBEAT_OK
8
9**否則：**
10- 如果沒有需要處理的事項，回傳 HEARTBEAT_OK
11- 保持簡潔

心跳檢查對於建立主動型 Agent 非常有用。你的 Agent 可以檢查行事曆、掃描收件匣，或按排程執行任何自動化工作流程，全部由心跳檢查觸發。

TOOLS.md：外部工具文件

這個檔案存放你關於外部工具和使用慣例的筆記。它不定義哪些工具存在（OpenClaw 內部處理這部分），而是你記錄自己如何使用它們的地方。

1# TOOLS.md - 使用者工具筆記
2
3## 電子郵件 CLI
4- 帳戶：[email protected]
5- 常用指令：`cli email search`、`cli calendar create`
6
7## 任務管理 API
8- 權杖位置：~/.secrets/task-api-token.txt
9- 務必使用 `limit=100` 以避免分頁問題
10- 狀態轉換：[記錄你的特定工作流程]
11
12## 網頁抓取工具（當網站封鎖正常請求時）
13- 位置：~/clawd/.venv/scraper
14- 對受保護網站使用隱身模式

這份文件成為你的個人參考指南。當你的 Agent 需要使用某個工具時，它會查閱 TOOLS.md 來了解你的特定使用慣例。

skills/ 資料夾：可重複使用的工作流程

技能是 OpenClaw 展現強大功能的地方。每個技能都是一個獨立的工作流程，當任務符合該技能的描述時，你的 Agent 可以呼叫它。

每個技能都位於自己的子目錄中，並包含一個 SKILL.md 檔案：

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

SKILL.md 使用 YAML 前置資料來描述何時使用它：

1---
2name: meeting-prep
3description: 自動化的會前研究與簡報。當使用者要求檢查即將到來的會議或執行會議準備時使用。
4---
5
6# 會議準備技能
7
8## 觸發時機：
9- 使用者要求檢查即將到來的會議
10- 透過 cron 排程每 10 分鐘執行一次
11- 僅針對首次通話進行簡報
12
13## 流程：
141. 檢查行事曆中未來 15-45 分鐘內的會議
152. 研究與會者（LinkedIn、公司網站）
163. 建立簡報文件
174. 將連結附加到行事曆活動

與靜態指示的關鍵區別：技能可以捆綁支援檔案。references/templates.md 檔案可以保存範例輸出、經過驗證的格式，或僅在技能啟用時才載入的額外上下文。

memory/ 資料夾：持久上下文

這是你的 Agent 的長期記憶。會話記錄、學習到的偏好和每日記錄都存在這裡。

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

良好做法：

• 將每日記錄保存在 memory/YYYY-MM-DD.md
• 會話開始時，你的 Agent 會讀取今天和昨天的記錄（如果存在）
• 捕捉持久的事實、偏好和決策
• 避免儲存機密

記憶檔案為你的 Agent 提供跨會話的上下文。沒有它們，每次對話都從零開始。

.secrets/ 資料夾：憑證

API 權杖、密碼和敏感配置存放在這裡。這個資料夾應被 .gitignore 忽略，絕不提交。

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

你的 AGENTS.md 或 TOOLS.md 可以引用這些路徑，而不會暴露實際值。

頻道配置：你在哪裡與 Agent 對話

OpenClaw 支援多種訊息傳送頻道：Discord、Telegram、Signal、WhatsApp 等。頻道配置位於你的閘道器配置中（透過 clawdbot gateway 指令管理）。

關鍵概念：

• 每個頻道都有自己的會話行為
• 你可以同時啟用多個頻道
• 頻道特定規則（例如「在 Discord 中除非被 @提及，否則不回應」）應放在 AGENTS.md 中

完整架構

以下是所有元件如何組合在一起：

1~/clawd/
2├── AGENTS.md           # 操作指令（日常使用）
3├── SOUL.md             # 角色與邊界
4├── IDENTITY.md         # Agent 身份
5├── USER.md             # 你的檔案
6├── HEARTBEAT.md        # 排程檢查行為
7├── TOOLS.md            # 外部工具文件
8├── BOOTSTRAP.md        # 首次執行儀式（使用後刪除）
9│
10├── skills/             # 自訂工作流程
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # 持久上下文
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # API 金鑰與憑證（已加入 gitignore）
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # 產出的檔案與匯出內容

實用入門設定

如果你是從頭開始，這裡有一個循序漸進的好方法。

步驟 1. 執行 openclaw onboard 並完成初始設定。選擇你的模型提供者，並至少連接一個頻道。

步驟 2. 建立你的工作區資料夾，並加入 AGENTS.md 與你的核心指令。從涵蓋你主要使用案例的 10-20 行開始。

步驟 3. 加入 IDENTITY.md、USER.md 和 SOUL.md。這些檔案建立關係和個性。

步驟 4. 為你反覆執行的工作流程建立第一個技能。會議準備、電子郵件草稿或內容創作都是不錯的起點。

步驟 5. 用每日記錄範本設定 memory/。你的 Agent 將隨著時間開始累積上下文。

步驟 6. 當你發現值得記錄的工具特定模式時，再加入 TOOLS.md。

對於 95% 的使用案例來說，這樣就足夠了。像 cron 任務、多 Agent 設定和自訂頻道外掛程式等高階功能，則在你需要自動化特定工作流程時再引入。

關鍵洞察

你的 OpenClaw 工作區實際上是一個協定，用來告訴你的 AI 助你是誰、你需要完成什麼事，以及它應該遵守哪些規則。你定義得越清楚，花在糾正 Agent 上的時間就越少，它用來做有用工作的時間就越多。

AGENTS.md 是你槓桿率最高的檔案。先把它搞定。其他一切都只是優化。

從小處著手，邊使用邊改進，把它當作你工作流程中任何其他基礎設施來對待：一旦正確設定，它每天都會帶來回報。

附註：Openclaw 只是起點。

在我們的 Build With AI 社群中，我會教你如何建立自訂的 Agent、應用程式和自動化流程，供自己使用或銷售給客戶。即將上線。

立即加入候補名單：

https://return-my-time.kit.com/1bd2720397