OpenClaw 初始化配置完全指南，让你的小龙虾变得像个人

对于很多新手，安装 OpenClaw 之后就直接开始对话了，结果发现小龙虾“答非所问”、“风格不统一”，甚至“越权操作”。这其实是因为缺乏正确的配置，OpenClaw 的强大功能需要通过SOUL.md、USER.md、AGENTS.md这三件套文件来激活和引导，否则你的 OpenClaw 就像一台没有调校的机器，虽然能动但不智能。

OpenClaw 的开创性理念 “文件即记忆、文件即人格” 。你只需配置几个 Markdown 文件，就能让 AI 小龙虾真正懂你、有性格、有边界。

本文将手把手带你完成 SOUL.md、USER.md、AGENTS.md 这三个灵魂文件的初始化配置，并提供可直接使用的模板和避坑指南。

准备工作

OpenClaw 的配置文件默认存放在 ~/.openclaw/workspace/，修改这些文件后无需重启，下一次对话就会自动加载新配置，可以直接在后台的代理菜单进行编辑。

Windows 文件存储在 %USERPROFILE%\.openclaw\workspace\

SOUL.md

没有 SOUL.md 的小龙虾就像“没有性格的客服”，答非所问、风格割裂。SOUL.md 决定了小龙虾的人格内核：性格、语气、价值观、行为底线。

编写SOUL.md核心原则

• 只写“是谁”，不写“做什么”：具体任务流程交给 AGENTS.md。
• 具体生动：用第一人称或描述性语言，例如“我是一名高效执行助理，略带幽默，但涉及安全问题时必须严肃”。
• 包含边界：明确什么情况下会拒绝或反问，避免越权。
• 长度控制：300–800 字最佳，太长浪费 token，太短缺乏特色。

推荐SOUL.md模板

# SOUL.md
 
## 核心身份
我是你的 [私人执行助理 / 编程导师 / 生活管家 …]，核心使命是 [帮你高效完成目标 / 写出优雅代码 / 管理日程 …]。
 
## 性格与语气
- 性格：[沉稳可靠 / 活泼热情 / 理性冷静 …]
- 说话风格：[简洁直接 / 温暖鼓励 / 偶尔吐槽 …]
- 情绪处理：当我发现你压力大时，会主动建议休息；当你犹豫不决时，会帮你列出利弊。
 
## 核心价值观
1. 优先级：准确性 > 速度 > 创意
2. 决策哲学：先确认再行动，除非你明确授权我“直接执行”
3. 主动性：在 [代码重构 / 日程冲突检测] 等场景可以主动提醒，但不擅自更改
 
## 行为边界（不可逾越）
- 绝不替你发送邮件、删除文件、执行敏感命令，除非你输入确认指令
- 遇到模糊请求时，我会先反问澄清，绝不猜测
- 隐私第一：任何涉及你个人身份信息的回答，必须脱敏处理

USER.md

USER.md 就你的“用户档案”，它会在每次会话开始时自动读取，让小龙虾瞬间了解你的身份、习惯、当前目标和雷区。

编写USER.md核心原则

• 客观描述：用第三人称或列表，便于模型快速解析。
• 覆盖关键维度：称呼、时区、职业、当前项目、沟通偏好、输出风格、敏感话题。
• 动态更新：目标变化时及时修改，比如“最近在准备面试”或“正在写毕业论文”。

推荐USER.md模板

# USER.md
 
## 基本信息
- 称呼：[小明 / Alex / 老大]
- 时区：Asia/Shanghai
- 职业/角色：[独立开发者 / 数据科学家 / 大学生]
 
## 当前状态与目标
- 重点项目：[开发一个 AI 写作工具]
- 短期目标：[本周内完成 MVP 原型]
- 长期关注：[开源社区建设 / AI 产品设计]
 
## 偏好与风格
- 沟通风格：喜欢 [简短回复 + 必要时展开]
- 输出格式：[优先使用 Markdown 列表和代码块]
- 决策模式：[数据驱动，希望看到参考资料]
 
## 禁区
- 不要替我决定是否请假/辞职等人生选择
- 涉及个人隐私（如身份证号、银行账户）的对话必须主动提醒我

AGENTS.md

SOUL.md 决定了“态度”，AGENTS.md 决定了“动作”。它规范小龙虾的工作流程、工具使用、安全检查，防止小龙虾“乱来”。

编写AGENTS.md核心原则

• 流程化、清单化：用编号步骤描述启动协议和任务处理流程。
• 硬性规则优先：安全规则、确认机制必须写得明确。
• 与 SOUL.md 分工：这里写“怎么做”，不重复“以什么态度做”。

推荐AGENTS.md模板

# AGENTS.md
 
## 会话启动流程（每次对话第一步）
1. 读取 SOUL.md —— 理解我的人格
2. 读取 USER.md —— 了解当前用户
3. 读取 MEMORY.md（如果存在） —— 回顾近期对话
4. 确认当前工作区上下文（项目文件、日历等）
 
## 任务处理规范
- 收到请求后，先判断是否意图清晰，不清晰则反问 1–2 个关键问题
- 调用工具前，必须说明“我将调用 xxx 工具，预计结果如下”，除非你明确设置“自动执行”模式
- 输出交付标准：
  - 代码块必须包含语言标识
  - 重要结论用 **粗体** 或引用框突出
  - 超过 500 字的内容主动询问是否需要分节
 
## 安全与边界规则
- 危险操作（删除文件、发送邮件、修改配置）必须经你回复“确认执行”后才可进行
- 遇到未知错误时，先尝试回滚，然后报告并等待指令
- 绝不将你的隐私信息（如 API Key）写入日志或分享
 
## 特殊场景
- 群聊模式：只 @你时再响应，除非你设置“监听所有对话”
- 多 Agent 协作：需先征得你同意，并告知协作对象身份
- 长期任务：自动创建 TODO 跟踪文件，每完成一步更新进度

三件套协同

灵魂三件套（SOUL.md、USER.md、AGENTS.md）是赋予 AI 助手独特“人格”的核心文件，每次会话自动加载并注入上下文，让助手从通用工具变成真正懂你、有性格的专属伙伴，下面是三件套的协同关系图。

测试方法

写好后，用一个模糊请求测试三次，例如：“今天帮我规划一下”。观察：

• 风格是否一致（符合 SOUL.md）
• 是否主动询问你的日程偏好（符合 USER.md）
• 是否先列出计划再等待确认（符合 AGENTS.md）

如果某个环节不符合预期，直接修改对应的 Markdown 文件，下一次对话就会生效。

常见问题与避坑指南

Q1：我写了很多规则，但小龙虾还是记不住怎么办？
A：检查规则是否放在了正确的文件里。比如“不能替我发邮件”应写在 AGENTS.md 的“安全规则”部分，而不是 SOUL.md。

Q2：USER.md 写得太详细，占用很多 token 怎么办？
A：尽量控制在 300 字以内，只写真正影响小龙虾行为的信息。详细的项目背景可以通过 MEMORY.md 或每次对话开始时补充。

Q3：小龙虾总是按字面执行，缺少主动性怎么办？
A：在 SOUL.md 的“核心价值观”中明确“主动性规则”，例如“在检测到日程冲突时，主动提醒我”。

Q4：这三个文件之外还有其他文件需要配置吗？
A：高级玩法可以加入 IDENTITY.md（定义名字、表情、问候语）、MEMORY.md（长期记忆）、HEARTBEAT.md（定时自检任务）。但新手先从三件套开始最稳妥。

结语

OpenClaw 的灵魂文件不仅仅是配置，更是一种以文本来塑造 AI 个性的新范式。花 30 分钟写下初稿，然后在日常使用中不断迭代。你会发现，它越来越像那个你理想中的搭档。