openclaw-easy-tutorial-zh-cn

让助手更像「你的」：人设、习惯与记忆

读完这一节，你会知道助手的「人设、习惯与记忆」都放在哪里、改哪几个文件就能让助手更像你想要的风格，以及如何用记忆让助手跨对话记住重要信息。不需要改配置或写代码，用记事本或任意编辑器改几份 Markdown 文件即可。

助手的「办公室」：工作区

OpenClaw 的助手有一个固定的工作区（Workspace）：可以理解成助手的「办公室」——里面放着它的行事准则、性格设定、对你的了解，以及每天的记录。助手读写文件时，默认都在这个目录里；你改这里的文件，就会影响助手每次对话时「看到」的内容。

默认位置：~/.openclaw/workspace（~ 代表你的用户主目录；在 macOS 上往往是 /Users/你的用户名/.openclaw/workspace）。
若你安装时跑过向导，这个文件夹和里面的初始文件通常已经建好了；若没有，可在终端执行 openclaw setup，会帮你创建并放入默认文件。

工作区和 ~/.openclaw/ 不一样：后者存的是配置、密钥、会话记录等，不要把人设、记忆和配置混在一起。工作区建议当成「助手的私人记忆本」，可以单独用 Git 做备份（见下方「可选：给工作区做备份」）。

改人设与习惯：这几个文件各管什么

工作区里有几份 Markdown 文件（.md），助手在每次对话开始时都会读它们。你改哪一份，就影响哪一块「人设」或「习惯」。

文件	通俗理解	适合写什么
AGENTS.md	助手的「工作守则」	怎么做事、优先顺序、遇到某类问题该怎么处理；和记忆怎么配合使用。
SOUL.md	助手的「性格与边界」	说话口气、身份感、什么能做、什么坚决不做。
USER.md	「用户是谁」	你的称呼、偏好、背景，方便助手用「你」和你对话。
IDENTITY.md	助手的「名字与形象」	助手叫什么、用什么 emoji、整体气质。
TOOLS.md	工具使用说明（给助手看的笔记）	你本地有哪些工具、怎么用、有什么约定；不决定助手能不能用某个工具，只是提示。

还有两个和「记忆」有关的：

memory/YYYY-MM-DD.md：按天的日记，一天一个文件（如 memory/2025-03-10.md），助手会在对话开始时读「今天 + 昨天」的日记，用来延续上下文。
MEMORY.md（可选）：你希望助手长期记住的事，比如重要决定、偏好、关键事实；只在主会话里加载，群聊等场景不会读，避免泄露隐私。

下面给每一类各举一个简单示例，你照着改就行；不必全写，缺的可以不写或留空，助手会照常运行。

AGENTS.md：工作守则

例如希望助手「优先用中文回答、重要决定先总结再执行」：

- 回复优先使用中文；若用户用英文提问，可用英文回答。
- 在做可能产生较大影响的行动前，先简短总结计划，再执行。
- 不确定时主动询问用户，不要猜测用户意图。

SOUL.md：性格与边界

例如希望助手「像一位靠谱的同事，不代做违法或越权的事」：

- 语气：专业、友好、像一位靠谱的同事。
- 不做：代写违法内容、冒充他人、未经授权访问系统；不承诺无法兑现的结果。
- 若用户请求超出边界，礼貌说明原因并建议替代做法。

USER.md：用户是谁

例如简单写一下自己，方便助手称呼你：

- 称呼：小明。
- 角色：个人用户，主要用助手做日常备忘、写作和简单任务。
- 偏好：回复简洁一点，长内容分段或列要点。

IDENTITY.md：助手的名字与形象

例如给助手起个名、定个调子：

- 名字：小爪。
- 形象：一只靠谱的助手，用爪爪帮你打点事情；回复时偶尔用 🐾 表达「收到」或「完成」。

记忆：让助手「记得住」

助手的「记忆」就是工作区里的 Markdown 文件：没有神秘的黑盒，你打开文件就能看到内容。模型并不会自动记住上上次聊了什么，只有写进这些文件的内容，下次对话时才会被读进去。

memory/YYYY-MM-DD.md：按天的记录，适合「今天发生了啥、做了啥决定」这类流水账。助手在会话开始时会读「今天 + 昨天」两天的文件。
MEMORY.md：长期重要信息，比如「用户不喜欢被称呼您」「项目 X 的截止日是下周五」。只在你主会话（私聊、控制台）里加载，不会在群聊里读，避免把私人信息带进群。

怎么往记忆里写？ 你可以自己编辑这些 .md 文件；更省事的方式是直接跟助手说：「把这件事记下来」或「记住：我更喜欢简洁的回复」。助手会调用记忆相关工具，把内容写到对应的文件里。若你希望某件事一定要长期记住，可以说「把这条写进 MEMORY.md」。

改完文件要重启吗？

不用。助手在每次新对话开始时都会重新读工作区里的这些文件。你改完保存后，新开一次对话（新发一条消息或刷新后重新聊）就会用上新内容。若你正在同一条长对话里，当前对话已经加载过旧内容，要等到下次新会话才会读到你的修改。

可选：给工作区做备份

工作区里是人设和记忆，丢了会可惜。可以把它当成一个私有 Git 仓库备份到 GitHub / GitLab 等（务必选私有仓库，别把人设和记忆公开）。

在工作区目录下执行：

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md memory/
git commit -m "备份工作区"

再在 GitHub/GitLab 上新建一个私有仓库，把本地仓库 git remote add origin <地址> 后 git push。以后有重要修改就 git add .、git commit、git push 一次即可。注意：不要把 API Key、密码等写进工作区；若有必要，用占位符，真实密钥放在别处（如环境变量或 ~/.openclaw/）。

本节要点

助手的「人设、习惯与记忆」都在工作区里，默认是 ~/.openclaw/workspace。
AGENTS.md：工作守则、优先级、怎么用记忆；SOUL.md：性格、口气、边界；USER.md：你是谁、怎么称呼你；IDENTITY.md：助手名字与形象；TOOLS.md：给助手看的工具说明（不控制开关）。
记忆 = 工作区里的 Markdown：memory/YYYY-MM-DD.md 按天记录，MEMORY.md 放长期重要信息（仅主会话加载）；可以让助手「把这件事记下来」自动写入。
改完文件保存即可，新开对话会读新内容；可选用私有 Git 仓库备份工作区，不要提交密钥。

常见问题

Q：我没有 AGENTS.md 或 SOUL.md，怎么办？
在终端执行 openclaw setup，会在工作区里创建缺失的默认文件，不会覆盖你已有的文件。若你希望完全自己管理这些文件，可在配置里设 agent.skipBootstrap: true 关闭自动创建。

Q：TOOLS.md 写了某工具，助手为什么还是不用？
TOOLS.md 只是给助手看的说明，不控制「能不能用」某个工具。工具是否可用由配置和权限决定；TOOLS.md 的作用是告诉助手「有这个工具、大概怎么用、你有什么约定」。

Q：MEMORY.md 和 memory/ 里的文件有什么区别？
MEMORY.md 适合长期、精选的重要信息（偏好、决定、关键事实），且只在你的主会话里加载。memory/YYYY-MM-DD.md 是按天的流水账，助手会读「今天 + 昨天」来延续近期上下文；群聊等场景不会读 MEMORY.md，避免把你的私人记忆带进群。

Q：工作区默认路径能改吗？
可以。在 ~/.openclaw/openclaw.json 里设置 agent.workspace 为你想要的路径（支持 ~）。改完后若新路径下还没有那些 .md 文件，可执行 openclaw setup --workspace <路径> 生成默认文件。