OpenClaw 核心配置文件：USER.md — 用户画像

置顶 | 发表于 | 分类于

我们在使用 OpenClaw 时都有过这样的困惑：明明安装了许多强大的 Skills（技能），API 也是最贵的，但代理的表现却依然笨拙，只能被动响应，无法主动思考，甚至经常重复提问。这并不一定是大模型本身的能力不足，也不是插件质量问题，核心原因在于忽略了系统底层的“灵魂”配置。真正决定 OpenClaw 智商上限的，不是昂贵的模型调用，而是那些藏在 /.openclaw/workspace/ 目录下不起眼的 .md 配置文件。本文将深入拆解这些核心文件的功能与配置逻辑，带你通过修改底层配置，彻底告别 AI 代理的机械感。
OpenClaw 的所有核心逻辑都存储在工作空间目录(**/.openclaw/workspace/** )下。如果不熟悉命令行界面的话，也可以在 Web UI 中查看和编辑。位置如下图：
alt text
打开这个目录，我们会看到如下层级的文件结构，每个文件都承担着不同的职责：

  • AGENTS.md：LLM的工作手册，代理调度规则与标准作业程序。
  • BOOTSTRAP.md：初始化序列与核心系统提示词。
  • HEARTBEAT.md：定时执行逻辑与主动任务状态自检。
  • IDENTITY.md：代理身份定义与系统边界约束。
  • MEMORY.md：长期上下文数据与既定规则的持久化存储。
  • SOUL.md：LLM的性格，响应语气、行为特征及输出格式配置。
  • TOOLS.md：工具授权注册表及调用参数规范。
  • USER.md：用户(你的)画像数据，包含特定偏好与交互限制配置。
  • memory/：存储日常运行日志与短期上下文。
  • skills/：已安装的第三方技能扩展目录。
    今天我们介绍 USER.md 文件，这是 OpenClaw 的核心文件。

什么是 USER.md？

USER.md 存放你的静态画像：称呼、习惯、禁忌、时区、常用语言等。它由你主动维护，用来在每一轮对话里稳定传递“你是谁、你希望对方怎么对你”。与 MEMORY.md 里由对话沉淀的动态事实形成互补。

适合写进去的内容

  • 称呼与身份：希望代理如何称呼你；你在团队中的角色（可选）。
  • 偏好：长文/短答、先结论还是先背景、是否使用 emoji、默认语言。
  • 禁忌：不希望讨论的主题、不要自动执行的操作（与 TOOLS.md 的安全边界可交叉引用）。
  • 环境与约束：常用系统（Windows/WSL）、工作时段、时区。

示例

1
2
3
4
5
6
7
8
# USER.md
## 称呼
- 叫我「Ben」即可
## 偏好
- 默认中文；技术名词可保留英文
- 回复先给结论，再给步骤与命令
## 禁忌
- 不要替我执行未确认的删除或覆盖文件操作

与 MEMORY.md 的区别

维度 USER.md MEMORY.md
谁维护 你手动维护 对话中沉淀，也可手改
内容性质 稳定偏好与约束 项目进展、决策、待办等事实
典型更新频率 低 中高

注意事项

  • 避免写敏感信息：如真实密码、token；若必须记录，请用环境变量或密钥管理，并在文中只写“从何处读取”。
  • 与 IDENTITY 区分：IDENTITY.md 描述的是代理是谁；USER.md 描述的是你是谁。
  • 定期同步：若工作习惯改变，记得更新 USER.md，否则旧偏好会长期影响行为。
-------------本文结束感谢您的阅读-------------