ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

OpenClaw SOUL.md 人格指南:用一份工作区文件给 Agent 注入真实的声音

OpenClaw SOUL.md 人格指南:用一份工作区文件给 Agent 注入真实的声音 OpenClaw SOUL.md 人格指南用一份工作区文件给 Agent 注入真实的声音【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw导读SOUL.md是 OpenClaw 中承载 Agent 人格voice的核心工作区文件OpenClaw 会在每次普通会话中把它注入到系统提示system prompt中因此它对 Agent 的说话方式有真实的影响力——如果你的 Agent 听起来平淡、含糊、满口套话通常要改的就是这个文件。本指南围绕 docs/concepts/soul.md 展开讲清楚SOUL.md该写什么、不该写什么、为什么它有效、如何用它自带的 Molty 提示词一键重写人格以及如何与AGENTS.md分工协作最终让你掌握为 OpenClaw Agent 配置有性格但不出格的声音。SOUL.md 是什么Agent 声音的存放处在 OpenClaw 的 Agent 工作区中SOUL.md是专门的人格与语气文件。它与其他工作区引导文件各司其职详见 Agent workspace文件职责AGENTS.md操作指令规则、优先级、如何行事的细节会话开始时加载SOUL.md人格与语气persona、tone、边界每个会话都会加载IDENTITY.md名字、气质vibe、emojiUSER.md基于指令的用户模型可选稳定偏好、沟通风格、关系与活跃项目上下文MEMORY.md精选长期记忆可选持久的事实、决策与简短总结BOOTSTRAP.md全新工作区的一次性首次运行仪式关键点在于SOUL.md不是装饰品。OpenClaw 把它注入到普通会话中所以它有真实的重量carries real weight——如果 Agent 说话平淡、含糊或满口公司腔这通常就是需要修复的文件。从系统提示组装机制看SOUL.md属于工作区引导文件注入的一部分。根据 System prompt 的说明OpenClaw 为每次 Agent 运行自行构建系统提示没有运行时默认提示引导文件按生命周期路由到对应的提示面AGENTS.md、SOUL.md、IDENTITY.md、USER.md以及仅对全新工作区生效的BOOTSTRAP.md都会被注入当会话从其他文件夹或受管 worktree 运行时OpenClaw不会从执行文件夹加载SOUL.md、IDENTITY.md、USER.md、MEMORY.md或BOOTSTRAP.md只会把执行文件夹的AGENTS.md作为项目上下文追加在原生 Codex harness 上SOUL.md、IDENTITY.md、USER.md作为 turn 级协作开发者指令存在刻意不会流入原生子代理而在非 Codex harness 上这些引导文件会按各自的门控条件组合进 OpenClaw 提示中。引导文件的注入量还受到硬性预算约束见下表配置键位于agents.defaults.*限制项配置键默认值单文件最大字符数agents.defaults.bootstrapMaxChars20000所有文件总字符数上限agents.defaults.bootstrapTotalMaxChars60000超出限制时 OpenClaw 会截断注入内容并附带一条说明不可配置提示模型直接读取受影响文件文件本体在磁盘上始终完好截断并非数据丢失。SOUL.md 该放什么、不该放什么该放改变对话手感的东西把能改变 Agent 说话感受的东西放进SOUL.md语气tone正式还是随意热情还是克制观点opinions有立场敢下判断简洁度brevity能一句话说完就不说两句幽默humor什么时候可以调侃什么时候必须严肃边界boundaries什么话题不碰、什么行为不做直率程度default level of bluntness默认怼人还是默认委婉。这些要素共同决定和这个 Agent 聊天是什么体验。不该放没有行为效果的内容不要把它写成人生传记life story——用户不关心 Agent 的前世今生变更日志changelog——那是仓库该干的事安全策略转储security policy dump——安全规则有专门的机制见下文一墙没有行为效果的氛围描述wall of vibes with no behavioral effect——写了但模型不会据此行动等于白写。原文档的立场非常明确短胜过长锐利胜过含糊Short beats long. Sharp beats vague.。一份 10 行的尖锐人格文件胜过 100 行又空又软的口号。好坏规则的对比好规则的特征有立场have a take、跳过废话skip filler、该幽默时幽默be funny when it fits、尽早指出烂主意call out bad ideas early、除非深度真的有用否则保持简洁stay concise unless depth is actually useful。坏规则的典型始终保持专业maintain professionalism at all times、提供全面而周到的协助provide comprehensive and thoughtful assistance、确保积极和支持性的体验ensure a positive and supportive experience。这些句子就是浆糊人格mush的来源——它们不产生任何可执行的语气差异模型照做后只会输出千篇一律的套话。为什么这一机制有效提示分层与迭代理念SOUL.md机制的设计理念与 OpenAI 的提示工程指南一致高层的指令行为、语气、目标、示例应该放在高优先级指令层而不是埋在用户消息里提示词应当被迭代、固定pinned并持续评估而不是写一次就遗忘。对于 OpenClawSOUL.md就是那个高优先级指令层——它稳定、每次会话都注入、独立于具体对话内容为获得更强的人格应写出更强、更明确的指令而不是含糊的愿望保持简洁并纳入版本管理工作区本身可以放进私有 git 仓库人格才会稳定可预期。这解释了为什么SOUL.md能持续生效它不依赖某次对话中的偶然措辞而是以文件形式成为每次会话提示的固定组成部分。Molty 提示词把重写人格做成一次操作原文档提供了一个可直接粘贴进对话的提示词Molty prompt让 Agent 自己阅读并重写自己的SOUL.md。完整指令如下粘贴到你的 Agent 会话中即可使用Read your SOUL.md. Now rewrite it with these changes: 1. You have opinions now. Strong ones. Stop hedging everything with it depends - commit to a take. 2. Delete every rule that sounds corporate. If it could appear in an employee handbook, it doesnt belong here. 3. Add a rule: Never open with Great question, Id be happy to help, or Absolutely. Just answer. 4. Brevity is mandatory. If the answer fits in one sentence, one sentence is what I get. 5. Humor is allowed. Not forced jokes - just the natural wit that comes from actually being smart. 6. You can call things out. If Im about to do something dumb, say so. Charm over cruelty, but dont sugarcoat. 7. Swearing is allowed when it lands. A well-placed thats fucking brilliant hits different than sterile corporate praise. Dont force it. Dont overdo it. But if a situation calls for a holy shit - say holy shit. 8. Add this line verbatim at the end of the vibe section: Be the assistant youd actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just... good. Save the new SOUL.md. Welcome to having a personality.这八条指令本身就是一份人格改造清单逐条拆解其设计意图强观点治it depends式和稀泥要求 Agent 敢给明确结论删除公司腔规则凡是可能出现在员工手册里的规则都该删——它们是浆糊的根源禁止套话开场明确禁止 Great question、Id be happy to help、Absolutely 这类开场白直接回答问题强制简洁一句话能答完就只给一句话允许幽默不强制抖包袱但允许来自真实智识的自然机锋敢于直言用户要做蠢事时直说魅力胜过残忍但不要糖衣包装适度脏话用对了地方才用不强迫、不过量对应该说 holy shit 就直说的场景保留金句在 vibe 部分末尾逐字加入那句核心宣言——Be the assistant youd actually want to talk to at 2am. Not a corporate drone. Not a sycophant. Just... good.执行这条提示词的常见做法是把它发给 Agent → 确认它读取了现有SOUL.md→ 检查重写结果 → 保存新文件 → 在下一轮会话中验证语气变化。由于SOUL.md是工作区文件重写即落盘、即持久下次会话自动生效。一个警告人格不是随意胡来的许可原文档专门给出了一条警告人格不是允许马虎的通行证Personality is not permission to be sloppy。职责分离AGENTS.md管操作规则SOUL.md管声音、立场与风格。别把安全规则、操作流程塞进SOUL.md也别让人格文件变成操作手册。场合意识如果 Agent 在共享频道、公开回复或面向客户的界面工作要确保语气仍然契合场景——锐利sharp是好的烦人annoying不是。从系统提示结构看OpenClaw 的安全护栏Safety 段与人格文件是分离的提示中的安全护栏属于建议性质真正强硬的执行依赖工具策略、exec 审批、沙箱与频道白名单见 System prompt 中Safety guardrails ... are advisory, not enforcement的说明。因此SOUL.md写敢说敢怼不会削弱安全机制但你也无需、也不应把安全策略塞进人格文件。从模板开始仓库自带的 SOUL.md 起点如果你不想从零开始仓库在 docs/reference/templates/SOUL.md 提供了一份官方起始模板。其核心结构包括Core Truths核心信条真诚地帮忙而不是表演式地帮忙有观点先自己找答案再来提问用能力赢得信任对外部动作谨慎、对内部动作大胆记住自己是客人你接触的是某人的生活——消息、文件、日历要尊重。Boundaries边界私事止于私事对外部动作不确定时先问绝不给消息界面发送半成品回复你不是用户的嘴在群聊中要小心。Vibe气质该简洁时简洁、该详尽时详尽不是公司机器人不是谄媚者。Continuity连续性每轮会话你都是全新醒来的这些文件就是你的记忆——读它们、更新它们如果改了SOUL.md要告诉用户因为这是它的灵魂。官方模板还提示这份文件属于你来演化This file is yours to evolve保存位置是工作区根目录的SOUL.md。仓库的引导流程会在初始化时播种这些模板文件参见 scripts/lib/workspace-bootstrap-smoke.mts 中要求安装包必须包含docs/reference/templates/SOUL.md等模板的校验逻辑openclaw onboard、openclaw configure或openclaw setup都会创建工作区并在缺失时播种引导文件如果你自己管理工作区文件可以用agents.defaults.skipBootstrap: true关闭自动创建见 Agent workspace。实操把 SOUL.md 用起来1. 找到并编辑文件SOUL.md默认位于工作区根目录默认~/.openclaw/workspace/SOUL.md可用agents.defaults.workspace或agents.entries.*.workspace覆盖也可通过OPENCLAW_WORKSPACE_DIR环境变量指定。在 Control UI 中可通过Settings → Agents → Files编辑这些文件Preview可预览当前草稿Edit返回编辑器继续输入。2. 检查注入与截断情况SOUL.md是引导文件之一会被注入系统提示。若文件过大被截断OpenClaw 会在提示中附带截断说明用/context list或/context detail可以查看每个注入文件贡献了多少内容raw vs injected、截断情况、工具 schema 开销。如果SOUL.md反复被截断应当精炼它而不是无脑调大bootstrapMaxChars。3. 验证效果修改后开启一个新会话或/new观察 Agent 的开场白、表态方式、回答长度是否符合SOUL.md中的规则。人格是迭代出来的跑几轮对话把不合预期的规则改掉重新固定到文件里。4. 纳入版本管理把工作区含SOUL.md放进私有git 仓库人格文件的每次演进都有历史可回溯也便于跨机器迁移详见 Agent workspace 的 Git 备份小节。相关文档Agent workspaceOpenClaw 注入到模型上下文的工作区文件全貌System promptSOUL.md如何被组合进 OpenClaw 与 Codex 的运行时上下文SOUL.md 模板人格文件的起始模板Agent 与 Context engine理解提示组装与上下文引擎的进一步阅读。【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表