如何找到这些关键文件
方式一：命令行
通过 Cursor 或 VSCode 连接服务器，在终端中定位配置文件目录。文件层级清晰，找到对应 .md 文件直接编辑保存即可。
方式二：WebUI
- 在服务器浏览器中访问
http://localhost:18789/overview - 在「概述」页面配置网关令牌并连接
- 左侧选项栏选择「代理」，进入当前 Agent
- 点击「文件」，选择对应 .md 文件进行修改和保存
SOUL.md：决定 Agent 平庸还是卓越
SOUL.md 是整个身份架构中最基础的文件，定义了代理的性格、核心价值观和长期指令。一个优秀的 SOUL.md 包含三个关键部分：
- 人格：定义交互风格，如「专业但平易近人」「简洁明了，优先使用项目符号」「主动呈现相关信息」
- 核心价值观：行为准则，如「用户隐私至关重要，绝不泄露数据」「有财务影响的操作前必须确认」「为事实性声明标注来源」「任务失败时报告错误而非编造成功」
- 长期指令：行为指导，如「早晨简报在 7:30，最多 5 个要点」「总结邮件时优先突出行动项」「响应前先检查 HEARTBEAT.md」
关键原则：保持简短和具体。模糊指令如「要有帮助」会产生模糊行为，而「最多 5 个要点，确认后再删除任何文件」会产生精确行为。有用户的 SOUL.md 只写了一个词——「简洁」（Terse），Agent 就会照做。
特定于工作流的规则应移到 HEARTBEAT.md 或 AGENTS.md 中，SOUL.md 只保留身份和通用价值观。
AGENTS.md：Agent 的工作指南
AGENTS.md 是日常行为配置文件，详细记录任务处理流程、工具使用策略、决策逻辑和操作规范。核心包含三部分：
- 优先级铁律：明确什么最重要。例如「准确性 > 速度，先验证再汇报」
- 标准化流程：定义处理特定任务的步骤。例如「Review 代码时，先揪出安全漏洞，再挑剔代码风格」
- 高危警告：明确的禁止规则。没有边界规则，Agent 可能会执行网页上看到的恶意指令——提示注入是真实威胁，需要通过明确规则来防御
USER.md：让 Agent 真正懂你
USER.md 不是简历，而是写给 Agent 的「使用说明书」。写得越具体，Agent 就越懂你。它存储用户的偏好、背景、工作习惯等信息，在提升交互质量方面起着关键作用，但其影响力往往被新用户低估。
HEARTBEAT.md：心跳机制，主动执行
这是让 Agent 从「被动响应」变为「主动工作」的关键。HEARTBEAT.md 定义了代理在后台定期检查的任务，使其能在没有用户指令的情况下主动提供价值。
典型场景：凌晨 3 点服务器宕机，心跳机制在下一个周期捕获问题，通过 Telegram 发送消息——「暂存服务器返回了 503 错误，需要我看看吗？」你没有主动询问，但 Agent 自己注意到了。
TOOLS.md：Skills 配置清单
理解 Tools 和 Skills 的区别至关重要：
- Tools 是器官——决定 Agent「能不能」做某件事
- Skills 是教科书——教 Agent「如何」组合工具完成任务
Tools 就像手，没有手什么都做不了；Skills 是说明书，告诉你如何用手完成特定工作。
注意：如果版本高于 3.2，需要在 openclaw.json 中将 tools 权限设置为 full，否则 Agent 只能聊天。
IDENTITY.md：对外的身份信息
IDENTITY.md 定义 Agent 的外在形象——显示名称、表情符号、主题和问候语。它与 SOUL.md 形成精妙的分层设计：
- SOUL.md 定义行为（代理如何思考和决策）
- IDENTITY.md 定义外观（代理如何呈现自己）
- Config 定义权限
这种分离允许在保持核心人格不变的前提下自由调整对外形象——就像一个人可以换不同的衣服但性格不变。
BOOTSTRAP.md：一次性引导文件
BOOTSTRAP.md 为全新工作空间准备初始化引导，交互式地引导用户完成：命名代理、设置人格、填写 USER.md。Agent 会逐步询问并根据回答配置相应文件。
实操建议
配置这些文件的优先级建议：先写 SOUL.md 和 USER.md（决定 Agent 的基本智商和个性化程度），再配置 AGENTS.md（规范工作流程），最后设置 HEARTBEAT.md（实现主动监控）。记住核心原则——指令越具体，Agent 表现越好。与其堆砌插件，不如花 30 分钟认真写好这几个配置文件。