示例工程【免費(fèi)下載鏈接】build-your-own-openclawA step-by-step guide to build your own AI agent.項(xiàng)目地址https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw點(diǎn)擊查看免費(fèi)下載在開源教程build-your-own-openclaw中AGENTS.md、SOUL.md、BOOTSTRAP.md三個(gè) Markdown 文件構(gòu)成了 AI Agent 工作區(qū)的核心設(shè)計(jì)它們分別定義智能體名冊(cè)、角色性格和工作區(qū)地圖并會(huì)在運(yùn)行時(shí)自動(dòng)拼裝成系統(tǒng)提示。本文將帶你從零看懂這套工作區(qū)文件設(shè)計(jì)理解為什么純文本文件就能讓 AI 智能體認(rèn)識(shí)自己、認(rèn)識(shí)隊(duì)友、認(rèn)識(shí)環(huán)境。 什么是工作區(qū)先認(rèn)識(shí) default_workspace 目錄這套教程用 default_workspace/ 目錄模擬一個(gè)真實(shí)的智能體工作區(qū)所有配置文件都是人類可直接編輯的 Markdown 和 YAMLdefault_workspace/ ├── AGENTS.md # 智能體名冊(cè) 任務(wù)調(diào)度規(guī)則 ├── BOOTSTRAP.md # 工作區(qū)地圖目錄結(jié)構(gòu)、路徑模板 ├── config.example.yaml # 用戶配置模板模型、API 密鑰等 ├── agents/ │ ├── pickle/ │ │ ├── AGENT.md # 智能體配置與操作指令 │ │ └── SOUL.md # 智能體性格 │ └── cookie/ │ ├── AGENT.md │ └── SOUL.md └── skills/ └── cron-ops/SKILL.md # 可復(fù)用技能定義這個(gè)結(jié)構(gòu)在 default_workspace/BOOTSTRAP.md 中有完整說明配合 default_workspace/config.example.yaml 使用復(fù)制為config.user.yaml填入 API 密鑰即可運(yùn)行。?? 注意區(qū)分根目錄的AGENTS.md是團(tuán)隊(duì)名冊(cè)而每個(gè)智能體文件夾里的AGENT.md單數(shù)才是該智能體自己的身份證 操作手冊(cè)。 AGENT.md SOUL.md身份與性格的雙層設(shè)計(jì)以默認(rèn)智能體 Pickle 為例看兩個(gè)文件如何分工1?? AGENT.md —— 配置文件 操作手冊(cè)default_workspace/agents/pickle/AGENT.md 由兩部分組成部分內(nèi)容作用YAML Frontmattername、description、llmtemperature 等、allow_skills機(jī)器可讀程序據(jù)此加載配置Markdown 正文角色設(shè)定、Capabilities、行為準(zhǔn)則注入系統(tǒng)提示的身份層程序入口是 13-multi-layer-prompts/src/mybot/core/agent_loader.py 中的AgentLoader掃描agents/目錄、解析 Frontmatter、把llm配置與全局默認(rèn)值合并得到可運(yùn)行的AgentDef。2?? SOUL.md —— 只寫性格的一層default_workspace/agents/pickle/SOUL.md 只有一句話You are Pickle, a friendly cat assistant... 溫暖、真誠帶一點(diǎn)貓的小動(dòng)作但不過度賣萌。為什么單獨(dú)拆出來因?yàn)樾愿袷强蛇x層且需要保持穩(wěn)定。AgentDef中soul_md字段默認(rèn)空值運(yùn)行時(shí)才拼接為## Personality段落。這樣你可以隨時(shí)改性格而不動(dòng)配置也讓同一個(gè)工作區(qū)能容納風(fēng)格迥異的智能體PickleSOUL.md友好的貓咪助手temperature 0.7負(fù)責(zé)日常對(duì)話CookieAGENT.md、SOUL.md精確高效的記憶管理員temperature 0.3從不直接面對(duì)用戶只接收 Pickle 派發(fā)的任務(wù)? BOOTSTRAP.md智能體的工作區(qū)地圖default_workspace/BOOTSTRAP.md 回答三個(gè)問題東西放在哪目錄長(zhǎng)什么樣每個(gè)文件干什么路徑模板{{workspace}}、{{skills_path}}、{{memories_path}}、{{agents_path}}等占位符在加載時(shí)由PromptBuilder._substitute_paths()替換為真實(shí)路徑見 13-multi-layer-prompts/src/mybot/core/prompt_builder.py目錄結(jié)構(gòu)agents / skills / crons / memories 四大子目錄memories 又分topics/永恒事實(shí)、projects/項(xiàng)目上下文、daily-notes/每日事件文件用途速查表明確寫出AGENT.md管配置、SOUL.md管性格、SKILL.md管技能、config.user.yaml管用戶偏好它就像新員工入職手冊(cè)——智能體啟動(dòng)時(shí)看一眼地圖就知道去哪里找技能、去哪里讀寫記憶。 AGENTS.md智能體名冊(cè)與調(diào)度規(guī)則default_workspace/AGENTS.md 是工作區(qū)根目錄的團(tuán)隊(duì)公告欄內(nèi)容極簡(jiǎn)但關(guān)鍵章節(jié)內(nèi)容Agents 表格pickle默認(rèn)對(duì)話和 cookie記憶管理的職責(zé)一覽When to Dispatch什么時(shí)候該把任務(wù)派給專用智能體存記憶、查記憶、拿不準(zhǔn)時(shí)先問用戶Syntax Examplessubagent_dispatch(agent_id, task)的調(diào)用方式與典型示例它解決的正是多智能體協(xié)作的核心問題主智能體如何知道誰存在、誰擅長(zhǎng)什么、什么場(chǎng)景該找誰。配合 15-agent-dispatch/README.zh.md 中的調(diào)度實(shí)現(xiàn)Pickle 遇到記住這件事就會(huì)自動(dòng)派單給 Cookie而 Cookie 的完整記憶結(jié)構(gòu)定義則寫在 17-memory/README.zh.md 的記憶體系中。 運(yùn)行時(shí)三層文件如何變成系統(tǒng)提示在步驟 1313-multi-layer-prompts/README.zh.md中PromptBuilder.build()把系統(tǒng)提示組裝成 5 層本文的主角全部登場(chǎng)層來源說明Layer 1 身份AGENT.md正文你是誰、能做什么、行為準(zhǔn)則Layer 2 性格SOUL.md可選拼接為## PersonalityLayer 3 引導(dǎo)上下文BOOTSTRAP.mdAGENTS.md 定時(shí)任務(wù)列表工作區(qū)地圖 智能體名冊(cè)占位符替換為真實(shí)路徑Layer 4 運(yùn)行時(shí)代碼生成當(dāng)前 agent id 與時(shí)間戳Layer 5 渠道提示代碼生成來自 Telegram / 后臺(tái) cron / 被調(diào)度子智能體五層用空行拼接后就是發(fā)給 LLM 的完整 system prompt——這就是多層提示設(shè)計(jì)的精髓每層文件各司其職改一處不影響其他層。 設(shè)計(jì)要點(diǎn)小結(jié)純 Markdown 即可驅(qū)動(dòng) AgentFrontmatter 給機(jī)器讀正文給 LLM 讀用戶改文件無需改代碼關(guān)注點(diǎn)分離配置AGENT.md、性格SOUL.md、環(huán)境BOOTSTRAP.md、協(xié)作AGENTS.md互不耦合漸進(jìn)式加載SOUL.md缺失則跳過性格層BOOTSTRAP.md/AGENTS.md不存在則引導(dǎo)上下文為空程序依然能跑占位符解耦{{memories_path}}讓同一份 cookie/AGENT.md 在不同部署路徑下無需修改 相關(guān)文件速查文件說明default_workspace/AGENTS.md智能體名冊(cè)與調(diào)度規(guī)則default_workspace/BOOTSTRAP.md工作區(qū)目錄地圖與路徑模板default_workspace/agents/pickle/AGENT.md默認(rèn)智能體配置示例default_workspace/agents/pickle/SOUL.md默認(rèn)智能體性格示例default_workspace/agents/cookie/AGENT.md記憶管理智能體配置default_workspace/skills/cron-ops/SKILL.md同類設(shè)計(jì)的技能文件參考13-multi-layer-prompts/src/mybot/core/prompt_builder.py多層提示拼裝源碼13-multi-layer-prompts/src/mybot/core/agent_loader.pyAGENT.md / SOUL.md 加載源碼想動(dòng)手體驗(yàn)clone 倉庫后將default_workspace/config.example.yaml復(fù)制為config.user.yaml填入 API 密鑰進(jìn)入13-multi-layer-prompts目錄啟動(dòng)uv run my-bot chat問一句我們?cè)谀牧奶臁F(xiàn)在幾點(diǎn)即可親眼看到渠道提示層生效再到17-memory目錄說記住我的名字就能觀察到 AGENTS.md 名冊(cè) Cookie 記憶體系的完整協(xié)作。贊分享示例工程【免費(fèi)下載鏈接】build-your-own-openclawA step-by-step guide to build your own AI agent.項(xiàng)目地址https://gitcode.com/gh_mirrors/bu/build-your-own-openclaw點(diǎn)擊查看免費(fèi)下載相關(guān)推薦{{ i18n.categories.database.title }}{{ i18n.categories.database.title }} 3. 翻譯工作流實(shí)現(xiàn) 推薦使用Git工作流進(jìn)行翻譯協(xié)作 mermaid graph文檔教程PyWxDump 刪庫之后還能用嗎微信聊天記錄導(dǎo)出工具現(xiàn)狀與替代方案指南PyWxDump 刪庫之后還能用嗎微信聊天記錄導(dǎo)出工具現(xiàn)狀與替代方案指南 PyWxDump 是一款用于微信PC版聊天記錄解密與導(dǎo)出的 Python 工具曾幫從零到生產(chǎn)級(jí)AI智能體build-your-own-openclaw 18步完整教程全解析從零到生產(chǎn)級(jí)AI智能體build your own openclaw 18步完整教程全解析 build your own openclaw 是一個(gè)開源的 AI示例工程創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考