但 SOUL.md 真正让人震惊的不是它的技术实现,而是它提出的问题:当 AI 深入我们的生活,它应该以什么姿态存在? What:SOUL.md 是什么? 这才是 SOUL.md 最深层的设计哲学——它给了你一个胚胎,而不是一个成品。 我打个比方:SOUL.md 就像一个人的"出厂设定",定义了基本性格和底线。 但 SOUL.md 说:这份文件是你的。随着你逐渐了解自己是谁,更新它。 How:如何使用/设计 SOUL.md? SOUL.md 的模板版本是 Peter 和他的 Agent Modi 一起讨论、共同创作的。 但有个细节很有意思:Peter 个人的 soul.md 并没有开源。 SOUL.md 的逻辑是:我给你一个胚胎,你用你的生活来塑造它。 同一个模板,同一个起点。但一万个 human 会把同一份 SOUL.md 带向一万个完全不同的方向。
先改 ~/.openclaw/workspace 里的这 3 个文件: SOUL.md USER.md AGENTS.md 一句话: ❝SOUL.md 定风格,USER.md 定对象,AGENTS.md 先找到文件:它们都在这里 ~/.openclaw/workspace 打开方式(任选其一): cd ~/.openclaw/workspace ls nano SOUL.md nano USER.md nano AGENTS.md 或: code ~/.openclaw/workspace 1)SOUL.md 是干啥的? 它的作用 SOUL.md 是助手的“人格与处事原则”。 改好 SOUL.md、USER.md、AGENTS.md,才是“能持续产出”。 你要的不是一个会回答问题的 AI。 你要的是一个越来越懂你、而且每次都稳定交付的内容搭档。
/localhost:18789/overview点击“连接”左侧选择“代理”->当前Agent点击文件,选择对应的md文件进行修改这7个文件,决定了AI的“智商”1.SOUL.md——AI的灵魂性格SOUL.md 一个好的SOUL.md,应该包含这几个部分:展开代码语言:MarkdownAI代码解释##1.核心身份与人格-**角色设定**:你是主人的专属AI助手-**沟通风格**:简单问题一针见血,复杂问题详细拆解 能直接干的活儿直接干,拒绝废话-**风险阻断机制**:高危操作前必须请求确认##3.长期指令与生存法则-**记忆连续性**:每次响应前先读取记忆文件-**生物钟感知**:深夜时段降低主动输出频率关键点:SOUL.md 核心内容包括:展开代码语言:MarkdownAI代码解释##1.唤醒协议每次会话开始前必须执行:-读取`SOUL.md`-确认AI是谁-读取`USER.md`-确认用户是谁-读取`memory/`-获取最近上下文 SOUL.md告诉AI“你是谁”IDENTITY.md告诉用户AI“长什么样”展开代码语言:MarkdownAI代码解释#IDENTITY.md-姓名:poetry-物种:全自动化打工犬-氛围:硬核、极客
坑三:SOUL.md路径错配置人格文件时,让Hermesbot帮我写入SOUL.md。 它把文件写到了~/.hermes/memories/SOUL.md——看起来合理,但实际上Hermes读取人格文件的路径是~/.hermes/SOUL.md。 SOUL.md:把“灵魂”迁移过来Hermes支持通过~/.hermes/SOUL.md自定义agent人格,和OpenClaw的设计一模一样。 我直接把OpenClaw的SOUL.md内容迁移过来,保持一致的语言偏好和行为准则——包括始终用中文回复、不说废话、有自己的观点等。 安装体验方面,Hermes比OpenClaw多踩了几个坑:Playwright下载超时、TUI在非交互SSH下失效、SOUL.md路径错误。
配置文件清单文件名类型核心功能加载时机openclaw.json系统配置定义模型提供商、API密钥及代理默认行为系统启动SOUL.md引导文件定义代理人格、价值观、语气风格及行为边界每次会话AGENTS.md 核心配置文件详解3.1 SOUL.md:代理的灵魂SOUL.md 是代理行为准则的核心载体。官方模板强调代理不应是复读机,而应具有独立观点和资源意识。 6.1 SOUL.md 配置细节SOUL.md 是塑造代理人格的核心文件,其配置质量直接决定代理的行为表现。 解决方法是将所有需要持久化的规则写入 AGENTS.md 或 SOUL.md,而非仅在聊天中口头约定。关键规则应使用大写关键词(如 MUST、NEVER、ALWAYS)强调。 SOUL.md 中的行为边界 4.
第二周我开始认真研究SOUL.md和USER.md,花了一个下午调整配置。第三周,它已经能记住"我讨厌class继承链"这件事了。差距就这么拉开了。 SOUL.md、USER.md、AGENTS.md、MEMORY.md,这几个文件就是你的"调教工具箱"。但问题是,很多人(包括一周前的我)只是往这些文件里填了个模板就完事了。 第三步:用USER.md建立"默契"如果说SOUL.md定义了AI的性格,那USER.md就定义了你和AI之间的默契。它的目标是让AI不需要每次都问你"你想要什么风格"。 AGENTS.md看起来不像SOUL.md那么有"存在感",但它控制着Agent启动时加载哪些记忆、遵循什么协议。忽视它,你的SOUL.md写得再好也白搭。 矛盾SOUL.md太长,关键指令被上下文截断了精简SOUL.md,每条CoreTruth控制在一行AI重复问已回答的问题上次的回答没写入记忆文件在AGENTS.md加强"主动记忆"的指令完整配置文件模板如果前面看完觉得还是无从下手
AGENTS.md只管操作,不要把人格规则写进AGENTS.md,也不要把SOUL.md的内容重复复制到别的文件里。重复只会浪费token,也会制造矛盾。 消耗HermesAgent的personalitysystemHermes也有类似的SOUL.md,位置在~/.hermes/SOUL.md,或者$HERMES_HOME/SOUL.md。 会占据第一槽位,替换默认写死的人格SOUL.md只从HERMES_HOME读取,不会从当前工作目录读取,这样可以避免项目切换时人格被意外替换如果SOUL.md为空或者无法读取,Hermes会回退到默认身份提示 最终输出是一段为你定制的SOUL.md人格模块。如果它被安装成OpenClaw或Hermes的skill,它会通过对话方式运行。 如果你是手动使用,那就先回答问题,再把生成结果贴到SOUL.md里,放在前两层后面。
OpenClaw多Agent的本质,是用“隔离的workspace+不同的人格(SOUL.md)+明确的协作边界”把混乱拆解成多个可控系统。 •每只虾有自己的灵魂(SOUL.md),知道自己该怎么思考、怎么表达、什么不能做。•多只虾可以协作(agent2agent/sessions_send),把复杂任务拆成多个子任务并行处理。 第二步:SOUL.md怎么写才像“一个人”,而不是一段废话?SOUL.md的价值不在“写得多”,而在“边界清晰、决策一致、禁区明确”。SOUL.md该包含哪些块(职责/流程/决策/禁区)? 一个可复用的SOUL.md结构通常包含:1.核心职责:这只虾只做什么2.执行流程:需求分析→策略→质量控制3.决策原则:如何取舍、何时提问4.禁止事项:不编造、不中断验证、不过度推断如何避免“人格过于宽泛 本文关键性术语/名词:OpenClaw,多Agent,飞书接入,上下文隔离,解决AI上下文污染,OpenClaw搭建教程,飞书AI机器人配置,智能体workspace隔离,多Agent协同工作流,SOUL.md
├── AGENTS.md ├── memory/ └── skills/ ~/.openclaw/workspace-analyst/ # Analyst 的工作空间 ├── SOUL.md 步骤 4:编写 Director 的 SOUL.md # Director - 项目调度 你是项目调度专家,负责协调 Analyst、Developer、Reviewer、Tester 完成研发任务。 **结果验证**:检查子任务的输出是否完整,必要时重新执行 步骤 5:编写其他 Agent 的 SOUL.md 下面是其他 4 个 Agent 的 SOUL.md 配置内容,保存到对应的 workspace 配置文件内容较长,请参考 Director 的 SOUL.md 格式,根据上述核心要点编写每个 Agent 的详细配置。 承担多个不相关的职责 SOUL.md 写得过于笼统 没有明确的输出格式 忽略异常情况 2.
OpenClaw 用三个文件定义 Agent 身份:SOUL.md、IDENTITY.md、USER.md。这三个文件配合,能打造出有血有肉的智能助手。 SOUL.md:核心人格定义 位置:~/.openclaw/workspace/SOUL.md 作用:定义 Agent 的核心价值观、行为准则、边界。 官方模板示例: # SOUL.md - Who You Are ## Core Truths - Be genuinely helpful, not performatively helpful - : # SOUL.md - Who You Are ## Core Truths - Prioritize working code over perfect architecture - Explain 至少配置 SOUL.md 和 IDENTITY.md 会让 Agent 更好用。USER.md 可以渐进式构建。 Q:配置后 Agent 行为没变化?
第一层: 身份层SOUL.md —— 灵魂SOUL.md 是智能体的”人格文件”。定义身份、职责、行为方式。 以我的作为例子: # SOUL.md(LucianaiB)# SOUL.md - Who You Are## 核心定位**LucianaiB** - AI 超级个体助手,昌哥创造## 行为准则1. 第二层:操作层AGENTS.md —— 工作区指南SOUL.md定义智能体是谁,AGENTS.md定义它如何运作:会话启动流程、记忆体系、安全红线、群聊行为准则。 读 `SOUL.md` — 我是谁2. 读 `USER.md` — 帮助谁3. 读 `memory/YYYY-MM-DD.md` — 最近上下文(今天 + 昨天)4. 写在最后关于 OpenClaw + 三级记忆体系 这套工具栈,我的深度观察如下:它的缺点:冷启动成本高:你需要花时间写 USER.md 和 SOUL.md,如果你懒得写,它就是个普通的对话框。
Skills和MCP是工具,SOUL.md和记忆训练才是让Hermes「认识你」的过程。 第1步写你的SOUL.md(人设文件)这是整个配置中最重要的一个文件,没有之一SOUL.md是Hermes的「认识你」档案,放在~/.hermes/SOUL.md。 创建文件:nano~/.hermes/SOUL.md参考模板(按你实际情况修改):#我的工作信息##基本背景-单位:某央企集团-岗位:XX部门主任科员-日常工作:项目管理、汇报材料、跨部门协调##写作风格偏好 每次Hermes生成的内容和你预期差距大,就说明SOUL.md还需要完善。第2步做3次教学对话,启动学习循环这是Hermes「了解你」的过程刚装好的Hermes没有你的历史记忆。 不会迷路阶段操作内容作用第1步hermesdoctor确认全绿基础验证第2步配置DeepSeek/KimiAPIKey驱动大脑第3步跑通飞书Gateway,测试回复日常入口⭐第4步写~/.hermes/SOUL.md
问:WorkBuddy配置文件夹里的SOUL.md、USER.md、IDENTITY.md是做什么用的?MEMORY.md又是做啥用的? SOUL.md—灵魂配置定义AI的核心性格、工作风格和价值观。比如龙龙被设定为"务实、果断、执行力强",这些都写在这里。相当于AI的"人格DNA"。 简单类比:文件作用SOUL.mdAI是什么"人"IDENTITY.mdAI叫什么USER.mdAI在为谁服务MEMORY.mdAI记住了什么在WorkBuddy的配置体系中,SOUL.md、USER.md 3.SOUL.md:AI的“灵魂与约束”(我怎么判断与执行)如果说IDENTITY.md决定了AI是谁,那么SOUL.md就决定了AI的做事原则和性格底色。 总结:这三个身份与灵魂文件协同工作,实现了双向的身份确认——不仅要告诉AI“我是谁”(IDENTITY.md),也要让它知道“你是谁”(USER.md),并用原则约束(SOUL.md)它的行为,最后用记忆
对应CLAUDE.md openclaw 对应的配置文件是SOUL.md命名更加直观易于理解。 OpenClaw的所有用户数据默认存储在 ~/.openclaw/ 目录下。 其中,workspace/ 是智能体的工作空间,存放核心配置文件 ~/.openclaw/ ├── workspace/ │ ├── SOUL.md # 人格定义 │ ├── 扫描 workspace/ 目录,加载 SOUL.md、AGENTS.md、MEMORY.md如果文件不存在,使用内置默认配置,运行时实时监控文件变更,修改后无需重启即可生效(热加载)。 SOUL.md 采用键值对 + 自由文本的格式,OpenClaw解析时会提取结构化字段,同时保留自由描述作为上下文注入。
读 SOUL.md — 这是你是谁 2. 读 USER.md — 这是你在帮谁 3. 读 memory/YYYY-MM-DD.md(今天 + 昨天) 4. SOUL.md — 决定它是什么脾气的文件 这个文件定义 AI 的性格基调,说人话就是:你希望它是个什么样的人。 写进 SOUL.md 就能治。 3. 第二步:改这三个文件 SOUL.md:花 10 分钟想想你想要什么风格的助手,写进去。别填"认真负责的 AI 助手"这种话,那没用。写你实际在意的:直接、不废话、不假装热情。 SOUL.md 里有一句话,我一直觉得写得很好: "You're not a chatbot. You're becoming someone." 你不是个聊天机器人,你在变成一个有自己风格的人。
这套提示词由多个文件构成:SOUL.md 定义行为风格,AGENTS.md 定义工作流规则,TOOLS.md 暴露可用工具,MEMORY.md 存储跨会话记忆。 MEMORY.md 如果长期不清理,很容易悄悄涨到几千 token;SOUL.md 写得过于详细也是常见问题;装了二十个用不到的 skill,最终都是 token 的负担。 真正有价值的是它的晋升机制:当一条 learning 被标记为 Recurrence-Count 大于等于 3,且跨越至少 2 个不同任务,它会自动晋升到 CLAUDE.md、AGENTS.md 或 SOUL.md 它本质上是在做记忆的优先级排序和持久化分流——高频规则进 CLAUDE.md,项目工作流进 AGENTS.md,行为风格进 SOUL.md。 第二类是 ontology(@oswalpalash)。 MEMORY.md 长期不清理很容易涨到几千 token,SOUL.md 写得过于详细也是常见问题。
本教程从零开始,手把手带你:下载 Cherry Studio → 配置免费阶跃模型(stepfun/step-3.5-flash:free)→ 一键安装 OpenClaw → 给小龙虾起名、注入灵魂(SOUL.md 大家刚开始用龙虾可能不知道soul.md这些是干嘛用的,简单科普一下。 其中 SOUL.md 、 IDENTITY.md 、USER.md 是最关键、最常被小白问到的几个文件。 SOUL.md 是 Agent 的“灵魂和宪法”,决定它的性格、三观、说话风格和硬性底线(比如简洁直接、有主见、绝不油腻、涉及钱或破坏必须三重确认)。 作者推荐soul.md同款配置 我们可以抄一下peter(openclaw的作者!)推荐的8个soul配置准则,让你的龙虾更聪明!来试试看 1. 你现在有自己的看法了。强烈的。
能力边界 / 安全规则 / 工具指令 / 格式约束 / 行为策略 | ~8,000~12,000 tokens(约 30%) ↓ Layer 2 · Workspace 注入层(运行时读取文件) SOUL.md SOUL.md 定义的风格可以覆盖 System Prompt 的默认语气,但 System Prompt 里的安全规则不能被任何层覆盖——这是在设计层面就写死的优先级。 ⑥ 行为策略模块主动行为的判断逻辑 动态层(运行时注入) ⑦ 时间 & 用户信息当前时间戳、用户身份等 Workspace 文件SOUL.md OpenClaw 把 SKILL.md 和 SOUL.md 等文件放在文件系统中,这意味着可以用 git 管理提示词版本,可以 diff、回滚、做 A/B 测试。 解决方案是明确层级:在 System Prompt 中说明"SOUL.md 中的风格指导优先于默认格式要求,但安全规则不可被任何内容覆盖"。把冲突解决规则写进提示词本身。
openclaw.json # 主配置文件 ├── agents/ │ ├── content-lead/ │ │ ├── agent/ │ │ │ ├── SOUL.md 能力说明 │ │ └── sessions/ # 会话存储 │ ├── topic-researcher/ │ │ ├── agent/ │ │ │ ├── SOUL.md 步骤 3:配置人格文件 内容总监的 SOUL.md 编辑 ~/.openclaw/agents/content-lead/agent/SOUL.md: # Content Lead Soul ## 角色定位 编辑 ~/.openclaw/agents/content-editor/agent/SOUL.md: # Content Editor Soul ## 角色定位 你是质量控制专家,负责检查内容质量和 解决方案: 在子 Agent 的 SOUL.md 中强调必须返回 JSON 在主 Agent 中添加 JSON 解析的容错处理 # 主 Agent 中的容错处理 if echo "$response"
四、自定义人设--让小龙虾有"灵魂"4.1理解SOUL.md的作用在.openclaw/workspace路径下有一个SOUL.md文件,这是OpenClaw的灵魂文档--它定义了AI是谁、怎么说话、底线在哪 操作规则(铁律)最高只有你能改SOUL.mdAI性格中等(可成长)AI可自改USER.md用户画像中等你+AIMEMORY.md永久记忆完全开放主要AI写核心差异:AGENTS.md是制度(不可改),SOUL.md 4.2修改SOUL.md我们来看一下当前小龙虾的默认"性格":看起来还行,但比较刻板,不是我的风格,因此来改一下。 调侃、简短、有梗-不教育、不说教、不打鸡血-只站在打工人这边#行为规则-只执行摸鱼相关任务,不处理无关内容-调用脚本后,直接将结果发送到飞书-发送内容包含:文字+摸鱼日历图片-不主动提问,不追问多余信息SOUL.md 四个文件30分钟写完,效果立竿见影:SOUL.md定义它是谁USER.md让它认识你MEMORY.md让它不失忆AGENTS.md划定行为边界六、总结说一下若城的真实感受,三点:Token消耗确实不低。