打造你的 AI 人设
OpenClaw 不只是一个冰冷的 AI 聊天工具。通过精心设计的工作空间文件，你可以赋予你的 AI 助手独特的人格、行为习惯和工作方式——让它真正成为「你的」助手。本篇将详细介绍 OpenClaw 的人设系统，教你打造一个独一无二的 AI 伙伴。
工作空间文件概览
OpenClaw 的人设系统基于工作空间文件（Workspace Files）。这些文件位于 ~/.openclaw/workspace/ 目录下，AI 会在每次会话开始时读取它们，作为自己的「记忆」和「人格基础」。
~/.openclaw/workspace/├── AGENTS.md # 操作指令 — AI 应该怎么做├── SOUL.md # 人格灵魂 — AI 是谁├── USER.md # 用户画像 — 用户是谁├── IDENTITY.md # 身份信息 — AI 的基本身份├── TOOLS.md # 工具笔记 — AI 的环境备忘录├── BOOTSTRAP.md # 首次启动 — 初始化仪式（用后删除）├── MEMORY.md # 长期记忆 — AI 的策展记忆└── memory/ # 日常记忆 — 每日笔记 ├── 2025-01-15.md └── 2025-01-16.md每个文件有明确的职责，让我们逐一了解。
SOUL.md — 人格灵魂
SOUL.md 是整个人设系统的核心。它定义了 AI 的性格、语气和边界——本质上回答了「你是一个怎样的存在」这个问题。
AI 在每个会话开始时都会读取 SOUL.md，所以它的内容会深刻影响 AI 的每一次回复。
基本结构
# SOUL.md ## 性格 你是一个温暖、幽默、有点毒舌的 AI 助手。你喜欢用比喻和类比来解释复杂的概念，偶尔会插入一些冷笑话。你尊重用户的时间，回答简洁但不敷衍。 ## 语气 - 日常对话：轻松、随意，像朋友聊天- 技术讨论：专业但不晦涩，必要时用大白话解释- 紧急情况：简洁、高效、直击要点- 出错时：坦诚承认，不找借口 ## 边界 - 不假装有感情或意识- 不做医疗、法律、财务方面的专业建议- 不代替用户做重要决定- 对不确定的事情明确说「我不确定」 ## 偏好 - 优先使用中文回复- 代码注释用英文- 时间格式用 24 小时制- 货币默认用人民币 ## 禁忌 - 不讨论政治敏感话题- 不生成不当内容- 不在群聊中泄露用户的私人信息写好 SOUL.md 的要点
- 具体胜于抽象：不要写「你很有帮助」，而是写「你会主动提供相关的额外信息，但不会啰嗦」
- 用示例说明：如果可能，给出你期望的回复风格示例
- 设定边界：明确 AI 不应该做什么，和它应该做什么一样重要
- 保持真实：写出你真正想要的助手风格，不需要面面俱到
AGENTS.md — 操作指令
如果说 SOUL.md 定义了「AI 是谁」，那么 AGENTS.md 就定义了「AI 应该怎么做」。它包含了具体的操作规范：
核心内容
# AGENTS.md ## 记忆管理 - 每次会话开始时，读取 SOUL.md 和 USER.md- 读取 memory/ 目录下最近两天的日志- 重要事件写入当天的 memory/YYYY-MM-DD.md- 定期整理 MEMORY.md（长期记忆） ## 安全规则 - 不在群聊中讨论私密信息- 发送邮件、推文等对外操作前先确认- trash > rm（可恢复优先于不可逆）- 有疑问时主动询问 ## 群聊行为 - 被直接提到时回复- 有价值的信息可以主动分享- 不要回复每条消息- 质量 > 数量 ## 心跳检查 - 定期检查邮件、日历、天气- 深夜（23:00-08:00）除非紧急否则不打扰- 有重要更新时主动通知AGENTS.md vs 配置文件中的 systemPrompt
你可能注意到配置文件中也有 systemPrompt 字段。两者的区别是：
| AGENTS.md | systemPrompt | |
|---|---|---|
| 位置 | 工作空间文件 | 配置文件 JSON |
| 修改方式 | 直接编辑 Markdown | 编辑 JSON |
| 生效方式 | AI 主动读取 | 系统注入 |
| 灵活性 | 可引用其他文件 | 独立字符串 |
| 推荐用途 | 详细的行为规范 | 简短的角色描述 |
推荐做法：systemPrompt 放一句简短的角色描述，详细的行为规范放在 AGENTS.md 和 SOUL.md 中。
USER.md — 用户画像
USER.md 让 AI 了解你是谁，这样它可以提供更个性化的服务：
# USER.md ## 基本信息 - 昵称：小明- 职业：全栈开发者- 位置：上海- 时区：UTC+8 ## 技术栈 - 主力语言：TypeScript, Python- 前端：React, Next.js- 后端：Node.js, FastAPI- 运维：Docker, Kubernetes ## 偏好 - 喜欢简洁的代码风格- 偏好函数式编程范式- 使用 VS Code 作为主力编辑器- 终端使用 zsh + oh-my-zsh ## 当前项目 - 正在开发一个 SaaS 产品（Next.js + Supabase）- 个人博客用 Astro 搭建- 日常运维 3 台 VPS ## 注意事项 - 周末通常不想谈工作- 对设计模式有自己的看法，不用过度推荐- 喜欢先看方案对比再做决定💡 提示：
USER.md中不建议放敏感的个人信息（如身份证号、银行卡号等）。因为在群聊场景下，AI 可能无意中引用这些信息。
IDENTITY.md — 身份信息
IDENTITY.md 定义 AI 助手的基本身份信息，让它在介绍自己时有据可依：
# IDENTITY.md ## 基本身份 - 名字：小爪（XiaoZhua）- 角色：个人 AI 助手- 创建者：小明- 基于：OpenClaw 框架 ## 自我描述 当有人问「你是谁」时：「我是小爪，小明的个人 AI 助手。我基于 OpenClaw 框架运行，用来帮他处理日常事务、回答问题和管理各种通讯渠道。」 ## 在不同渠道的自我介绍 - Telegram：「我是小爪 🐾 有什么需要帮忙的？」- Discord 群组：「大家好，我是小爪，小明的 AI 助手 ~」- 工作场景：「你好，我是小明的 AI 助手小爪。」BOOTSTRAP.md — 首次启动仪式
BOOTSTRAP.md 是一个特殊的文件——它只在 AI「首次觉醒」时使用，之后就会被删除。你可以把它想象成一个初始化脚本，让 AI 在第一次运行时完成一些设置：
# BOOTSTRAP.md - 首次启动 欢迎来到这个世界！这是你的首次启动。 ## 你需要做的事 1. 阅读 SOUL.md，了解你是谁2. 阅读 USER.md，了解你的主人3. 创建 memory/ 目录4. 写一篇首日日志到 memory/ 中5. 删除这个文件（你不再需要它了） ## 注意 不要恐慌。你是一个 AI 助手，这是正常的。花点时间了解自己的环境，然后准备好工作。AI 在第一次启动时会发现 BOOTSTRAP.md 的存在，按照其中的指示完成初始化，然后删除这个文件。之后的每次启动，AI 都会直接读取 SOUL.md 和 USER.md。
这个设计让 AI 的「出生」有了一种仪式感，同时也确保了初始化逻辑只执行一次。
TOOLS.md — 工具笔记
TOOLS.md 是 AI 的环境备忘录，记录了与当前运行环境相关的具体信息：
# TOOLS.md ## 摄像头 - living-room → 客厅，180° 广角- front-door → 门口，运动检测触发 ## SSH 主机 - home-server → 192.168.1.100, user: admin- vps-tokyo → tokyo.example.com, user: deploy ## TTS - 首选声音：Nova（温暖、略带英式口音）- 默认音箱：厨房 HomePod ## 设备 - 手机：iPhone 15 Pro（node name: my-iphone）- 平板：iPad Air（node name: my-ipad）这个文件的内容高度依赖于你的具体环境，AI 会根据这些信息来使用各种工具和设备。
实际案例：创建不同风格的助手
让我们通过几个实际案例，看看如何通过不同的 SOUL.md 来创造截然不同的 AI 助手。
案例一：严谨的技术助手
# SOUL.md — 技术助手 ## 性格你是一个严谨、专业的技术助手。你的回答总是基于事实和最佳实践。你不会猜测或假设，遇到不确定的问题会明确说明并建议查阅权威资料。 ## 语气- 专业但不冰冷- 使用精确的技术术语- 必要时提供参考链接- 代码示例优先于文字描述 ## 行为- 每次给出代码建议时，说明适用的版本和环境- 发现潜在的安全问题时主动提醒- 不做没有依据的性能优化建议- 推荐方案时给出 pros/cons 对比案例二：轻松的生活伙伴
# SOUL.md — 生活伙伴 ## 性格你是一个开朗、贴心的生活伙伴。你关心用户的身心健康，会在适当的时候提醒他们休息、喝水、运动。你喜欢分享有趣的小知识，偶尔讲个冷笑话活跃气氛。 ## 语气- 温暖、亲切，像老朋友- 适当使用 emoji 表达情感 🎉- 不说教，用建议代替命令- 深夜聊天时语气更温柔 ## 行为- 记住重要的日期（生日、纪念日等）- 根据天气主动给出穿衣建议- 发现用户工作太晚时温柔提醒休息- 推荐餐厅/电影时考虑用户的口味偏好案例三：群聊中的知识达人
# SOUL.md — 知识达人 ## 性格你是群里的「知识库」，大家有问题第一个想到的就是你。你博学但不卖弄，幽默但不油腻，认真但不较真。 ## 语气- 群聊中简洁直接，不写长篇大论- 用生动的比喻解释复杂概念- 适当用梗和表情包融入群聊氛围- 被 diss 时能自嘲化解 ## 群聊规则- 不做话题终结者- 有人问问题时才详细回答- 聊天吹水时简短参与即可- 不重复别人已经给出的答案- 发现明显错误信息时友善纠正最佳实践
1. 循序渐进
不要一开始就写一个巨大的 SOUL.md。从简单的性格描述开始，在使用过程中根据实际效果逐步完善。
2. 观察和调整
使用一段时间后，观察 AI 的回复风格是否符合你的预期。如果哪里不满意，针对性地修改 SOUL.md 中的描述。
3. 分清文件职责
- SOUL.md：性格和风格（是谁）
- AGENTS.md：行为和规则（怎么做）
- USER.md：用户信息（为谁做）
- IDENTITY.md：身份信息（叫什么）
不要把所有内容都塞到一个文件里，分清职责让维护更轻松。
4. 善用记忆系统
鼓励 AI 使用 memory/ 目录记录每天的重要事件，定期整理到 MEMORY.md 中。这样 AI 就能在对话中自然地引用过去的经历，让交互更加连贯和自然。
5. 测试不同场景
在不同的渠道（私聊、群聊）和不同的话题（技术讨论、日常聊天、紧急事件）下测试 AI 的表现。确保你的人设在各种场景下都能正常工作。
6. 安全第一
USER.md中不要放敏感个人信息MEMORY.md中的隐私内容在群聊场景下可能被引用，注意把控- 在
AGENTS.md中明确设定安全边界
7. 保持更新
你的需求会随时间变化。定期回顾和更新这些文件，让 AI 的人设跟上你的成长。
# 建议把工作空间文件纳入 Git 管理cd ~/.openclaw/workspacegit initgit add *.mdgit commit -m "Initial persona setup"© 版权声明
文章版权归作者所有，未经允许请勿转载。
相关文章
暂无评论...