name: agent-add description: "按照 OpenClaw 官方規範建立新 agent（代理），自動完成問答、配置、workspace 初始化與記錄。" metadata: openclaw: emoji: 🤖 requires: bins: - openclaw

Agent Add — 新建 OpenClaw Agent

這是按照 OpenClaw 官方規範建立新 agent 的技能。全程遵循 openclaw agents add CLI 命令的標準化流程，確保新建 agent 後自動生成完整的 workspace 和一系列精煉的 .md 引導文件，讓 AI 更好地配合人類工作。

⚠️ 副作用說明： 此技能會執行以下磁碟寫入操作，請確認後再使用：

• 建立新目錄： 為新 agent 建立獨立的 workspace 目錄
• 寫入檔案： 建立 AGENTS.md、IDENTITY.md、SOUL.md、USER.md 等模板檔案
• 修改已有檔案： 指令碼執行後，會用 edit 工具對 IDENTITY.md、SOUL.md、USER.md 做精準編輯（替換欄位值，保留原始結構）。這些檔案如果已存在，其內容會被部分修改
• 持久化記錄： 在技能目錄的 history/history.md 中追加一條建立記錄（永久儲存）
• 修改 OpenClaw 配置： 通過 openclaw agents add 寫入 agent 註冊資訊

建議在執行前備份重要 workspace，或在確認彙總後再執行。

流程

第一步：逐個確認資訊（嚴格一問一答）

使用者如果需要新增 agent，務必嚴格分開問、一個一個問。每個問題發出後，等使用者回覆並確認，再問下一個。不要一次性問多個問題，不要把最後一個問題和彙總合併。

關鍵規則： 每問一個問題 → 等使用者回覆 → 確認收到 → 再問下一個。4 個問題全部確認完畢後再進入第二步彙總。

問題 1：Agent 名字

請給這個 agent 起個名字。這個名字會決定：

• 工作目錄的名稱
• 介面中選擇 agent 時顯示的名字
• 在群裡 @召喚 這個 agent 時使用的名字

建議： 儘量簡短好記，2-4 個字或英文單詞。例如：助手、coder、小秘。

收到回覆後確認： "好的，agent 名字確定為 {name}。"

問題 2：Agent 的定位描述

請描述一下這個 agent 的定位。可以參考以下格式：

• 用途： 這是我的，用來
• 暱稱/稱呼： （可選）
• 性格/風格： 嚴謹 / 幽默 / 簡潔 / 溫暖 / 專業...

  7w4.net收錄了海量優質技能外掛。

• 圖示 emoji： 選一個代表它的符號

圖示建議（根據 agent 名字 {name} 推薦，僅供參考，可以自己選）：

（根據名字的型別動態推薦 5-8 個相關 emoji，不要固定列同一批。例如： - 教育/老師類：🎓 📚 ✏️ 🍎 🧑‍🏫 - 程式碼/技術類：💻 🔧 ⚙️ 🐛 🖥️ - 寫作/文案類：✍️ 📝 📖 🖊️ 📰 - 資料/分析類：📊 📈 📉 🔢 🧮 - 日常/助手類：📋 ✅ ⚡ 🤖 💡 - 設計/創意類：🎨 🎭 🖼️ ✨ 🎬）

示例：

• "這是我的程式碼審查助手，用來 review PR 和檢查 bug，風格嚴謹簡潔，圖示用 🔍"
• "這是我的日常秘書，幫我管理日程和郵件，語氣溫暖友好，圖示用 📋"
• "這是我的資料分析 agent，處理報表和視覺化，專業高效，圖示用 📊"

收到回覆後確認： "好的，定位描述已記錄。"

問題 3：模型選擇

先用 session_status 獲取當前會話使用的模型，再從 openclaw.json 讀取 agents.defaults.model.primary 作為預設模型。

請選擇這個 agent 使用的模型。可選：

• 當前主 agent 正在使用的模型： {currentModel}（推薦，和現有 agent 一致）
• 預設模型： {defaultModel}

先選一個能用的就行，後面隨時可以換模型。

收到回覆後確認： "好的，模型確定為 {model}。"

問題 4：Workspace 目錄

計算規則（按實際使用方式）： 1. 先找到 main agent workspace 的父目錄 2. 新 agent 的 workspace = {父目錄}/workspace-{agentId} 3. 也就是和 main 的 workspace 平級，在同一目錄下

例如 main workspace 是 /data1/.openclaw/workspace，則： - 父目錄 = /data1/.openclaw/ - 新 workspace = /data1/.openclaw/workspace-{agentId}

新 agent 的 workspace 將建立在以下位置：

{實際計算出的路徑，例如 /data1/.openclaw/workspace-xiaolaoshi}

這個目錄和 main agent 的 workspace 平級。確認使用這個預設路徑，還是指定其他路徑？

收到回覆後確認： "好的，workspace 路徑確定為 {workspacePath}。"

⚠️ 注意：問題 4 確認後，等使用者回覆，再單獨進入第二步彙總。不要把問題 4 和彙總合併在一起問。

第二步：彙總確認

四個問題全部逐個確認後，給使用者展示完整彙總：

📋 即將建立的新 Agent：

- Agent ID: {agentId}
- 顯示名稱: {name}
- 定位: {description}
- 模型: {model}
- Workspace: {workspacePath}
- 圖示: {emoji}

確認以上資訊？（回覆"確認"或指出需要修改的地方）

使用者確認後，告知即將生成的文件列表：

📁 新 agent 的 workspace 中將包含以下 OpenClaw 精煉文件：

這些文件規範了 AI 的行為準則，能讓 AI 更好地幫助人類工作。
建議讓 AI 按照各自規範自動填充內容，儘量不要手動刪除。

| 檔案 | 定位 | 核心職責 | 生命週期 |
|------|------|---------|---------|
| AGENTS.md | 🏛️ 行為憲法 | 操作規則、優先順序、記憶使用指令 | 持久存在 |
| BOOTSTRAP.md | 👶 出生證明 | 首次執行儀式，引導填充 IDENTITY/USER/SOUL | 一次性，完成後自毀 |
| IDENTITY.md | 🪪 身份證 | 名字、型別、emoji | Bootstrap 建立，後續可更新 |
| USER.md | 📇 使用者速查卡 | 使用者名稱、稱呼、時區 | Bootstrap 建立，持續更新 |
| SOUL.md | 🎭 靈魂/人格 | 語氣、立場、邊界、幽默感 | 持久存在，隨時打磨 |
| TOOLS.md | 🛠️ 工具說明書 | 本地工具慣例與配置備忘 | 持久存在 |
| MEMORY.md | 🧠 精選長期記憶 | 事實、偏好、決策摘要 | 持久存在 |
| HEARTBEAT.md | 🔁 定時任務清單 | Heartbeat 檢查待辦項 | 持久存在（可選） |

第三步：執行建立

使用者最終確認後，先執行指令碼註冊 agent（傳入所有確認的資訊）：

{baseDir}/scripts/agent-add.sh <agentId> <name> <workspacePath> <model> <description> <emoji>

引數說明： - agentId — agent 唯一標識 - name — 顯示名稱 - workspacePath — workspace 絕對路徑 - model — 模型 id - description — 定位描述（使用者問題2的完整回答） - emoji — 圖示 emoji

指令碼會自動完成： 1. 執行 openclaw agents add 命令 2. 用 openclaw agents list 驗證新增成功 3. 檢查 workspace 中的 .md 檔案是否存在，缺失則從 main workspace 補充 4. 在 {baseDir}/history/history.md 中記錄本次建立

第四步：初始化文件內容（按區塊追加，不覆蓋）

指令碼執行完成後，用 edit 工具對以下檔案做精準編輯，不是全盤覆蓋。

核心原則： 原始模板裡的通用約束（Core Truths、Boundaries、Continuity、Related 等）是 OpenClaw 精煉過的行為準則，必須保留。只按類別追加/替換與新 agent 定位相關的內容。

IDENTITY.md — 只替換欄位值，保留結構和 Notes/Related

用 edit 工具做精確替換： - 把 **Name:** 後面的空值替換為 agent 名字 - 把 **Creature:** 替換為 agent 的型別描述（例如 "AI 學習助手"） - 把 **Vibe:** 替換為風格描述 - 把 **Emoji:** 替換為選定的 emoji - **Avatar:** 先留空或寫 （暫無） - 保留原有的 Notes、Related 等所有其他區塊不變

SOUL.md — 在原有結構上追加定位內容，不刪通用約束

用 edit 工具： - 保留原有的 Core Truths、Boundaries、Vibe、Continuity、Related 全部不變 - 先 read 檢視原始 SOUL.md 有哪些類別（H2/H3 標題） - 優先在已有類別下追加/替換內容，例如把 ## 定位 下的內容替換為新 agent 的定位 - 除非某個類別原始完全沒有，並且確實需要，才新增類別。不要憑空創造大量新章節 - 溝通風格部分：如果原有 ## Vibe / 溝通風格 存在，在其中追加新 agent 的語言/語氣要求

USER.md — 只替換使用者相關欄位，保留結構

用 edit 工具： - 把 **name:** 替換為使用者名稱字（如果使用者有特別指定的話，否則保留原始的 老楊） - 保留原有的 Notes、Related 等所有其他區塊不變

⚠️ 關鍵： 每個檔案用 edit 做精準替換（oldText/newText），不要用 write 全盤覆蓋。先 read 看原始內容，再決定怎麼 edit。

第五步：完成提示

文件初始化完成後，告訴使用者：

✅ Agent {name} 已建立成功！

Workspace: {workspacePath}

已完成的工作： - Agent 註冊到 OpenClaw（ID: {agentId}） - Workspace 初始化，包含所有必要文件 - IDENTITY.md — 身份資訊已寫入 - SOUL.md — 定位和風格已配置（保留原始通用約束） - USER.md — 使用者資訊已更新

是否現在重啟 gateway 使新 agent 生效？ 執行 openclaw gateway restart 即可。

注意事項

• Agent ID 使用小寫字母、數字和連字元（如 my-agent）
• 顯示名稱可以是中文或任意語言
• Workspace 路徑必須是一個空目錄或不存在的路徑（指令碼會建立）
• 模型選擇影響 agent 的推理能力和速度，根據用途合理選擇

這是一個設計成熟的 Skill，流程清晰、互動友好，文件對操作的說明非常詳細。它能自動完成 agent 建立和 workspace 初始化，省去了手動配置的麻煩。指令碼執行有驗證機制，出錯時會給提示。不過部分文件內容有缺失，另外依賴的配置檔案路徑寫死了，系統環境不同時可能需要手動調整。總體而言質量可靠，對 OpenClaw 使用者來說是實用的輔助工具。