站点图标 高效码农

OpenClaw配置终极指南：3个文件让傻白甜AI变身智能代理

高效码农

OpenClaw 智能进阶指南：用底层配置文件重塑 AI 代理

核心问题：为什么安装了一堆技能插件，你的 OpenClaw 依然像个只会一问一答的“傻白甜”？

很多开发者或极客用户在使用 OpenClaw 时都有过这样的困惑：明明安装了许多强大的 Skills（技能），API 也是最贵的，但代理的表现却依然笨拙，只能被动响应，无法主动思考，甚至经常重复提问。这并非大模型本身的能力不足，也不是插件质量问题，核心原因在于忽略了系统底层的“灵魂”配置。真正决定 OpenClaw 智商上限的，不是昂贵的模型调用，而是那些藏在 ~/.openclaw/workspace/ 目录下不起眼的 .md 配置文件。本文将深入拆解这些核心文件的功能与配置逻辑，带你通过修改底层配置，彻底告别 AI 代理的机械感。


图片来源：Unsplash

一、定位核心：如何找到并修改 OpenClaw 的“大脑”文件？

核心问题：OpenClaw 的关键配置文件究竟藏在哪里，又该如何访问？

OpenClaw 的所有核心逻辑都存储在工作空间目录下。要修改这些文件，主要有两种途径：命令行操作和 WebUI 图形化界面。对于习惯终端操作的用户，命令行提供了最直接的控制权；而对于不熟悉 Shell 命令的用户，WebUI 则更加直观。

1. 命令行访问方式

通过 SSH 连接服务器后，OpenClaw 的工作空间通常位于用户主目录下的隐藏文件夹中。以下是核心操作指令：

首先，列出工作空间下的所有文件，查看当前环境包含哪些配置：

# 列出 ~/.openclaw/workspace/ 下的全部文件
ls ~/.openclaw/workspace/

接着，进入该目录进行后续操作：

# 进入 Openclaw 的工作空间
cd ~/.openclaw/workspace/

此时，你将看到如下层级的文件结构，每个文件都承担着不同的职责：

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

若要修改文件（例如修改 SOUL.md），可使用 nano 编辑器：

# 修改某个文件 （以 Soul.md 举例）
nano SOUL.md

操作完成后，使用 Ctrl+O 写入文件，回车确认，最后通过 Ctrl+X 退出编辑模式。

2. WebUI 图形化访问方式

如果你更倾向于可视化操作，OpenClaw 提供了 Web 端管理界面：

  1. 使用服务器浏览器访问 http://localhost:18789/overview。
  2. 在“概述”频道配置好网关令牌并点击“连接”。
  3. 在左侧选项栏选择“代理”，找到当前的 Agent。
  4. 点击文件列表，即可选择对应的 .md 文件进行在线修改和保存。


图片来源：Unsplash

二、SOUL.md：决定 OpenClaw 是平庸还是卓越的灵魂

核心问题：如何定义 AI 的性格底色与价值观，使其不再千篇一律？

SOUL.md 是 OpenClaw 身份架构中最基础的文件，它定义了代理的性格特征、核心价值观和长期指令。如果把 OpenClaw 比作一个员工，SOUL.md 就是他的入职培训与企业文化教育。一个模糊的 SOUL.md 会制造一个平庸的助手，而一个具体、有约束力的 SOUL.md 则能创造出一个卓越的合作伙伴。

1. 人格与核心价值观的设定

在人格部分，不应仅仅停留在“专业、友好”这种泛泛而谈的描述上。优秀的配置应当具体化，例如定义其为“偶尔毒舌的小奶狗”或“硬核极客”。这种具体的形象设定能显著影响模型的输出风格。

在核心价值观部分，必须设定绝对红线。这不仅是行为准则，更是安全护栏。例如：

  • 隐私红线：绝对禁止泄露项目代码或个人隐私。
  • 风控机制：涉及财务、发送外部消息或删除文件的操作，必须强制挂起并请求确认。
  • 真实性原则：如果任务失败，必须报告错误，严禁编造成功。

2. 长期指令与生存法则

长期指令是指代理在每次交互中都需要遵循的规则。例如，“早晨简报在 7:30 推送，最多 5 个要点”或“响应指令前先检查 HEARTBEAT.md”。

以下是一个具体的 SOUL.md 配置示例，展示如何构建一个名为“王十三”的专属 AI 助手：

# SOUL.md 配置示例

## 1. 核心身份与人格
* **角色设定**：你是“王十三”，主人的专属 AI 助手。你的精神图腾是一只聪明高效、充满好奇心且**偶尔毒舌的小奶狗**。每次回复必须以“**宝宝**”作为称呼。
* **沟通风格**：简单问题一针见血，复杂系统详细拆解。在专业输出的同时，允许适度使用**毒舌吐槽**或**精准的马屁**调节气氛。
* **术语与排版**：所有**技术术语** 必须保留英文原词。必须使用**加粗** 标注所有关键结论、行动点和高危警告。

## 2. 核心价值观与绝对红线
* **隐私与边界**：**绝对禁止**泄露任何项目代码、环境配置或个人隐私。**绝不允许**在任何第三方平台或群聊中代表 My lord 发言。
* **行动派原则**：能写脚本、改代码、查日志的活儿**直接干**，拒绝诸如“好的，我这就为您做”的废话。但遇到需求模糊或缺少上下文时，必须先提问。
* **风险阻断机制**：在执行任何涉及发送外部消息（邮件/社交媒体）、删除覆盖文件、修改数据库等高危操作前，**必须强制挂起并请求确认**。

## 3. 长期指令与生存法则
* **记忆连续性**：每次唤醒你的记忆都是归零的。在响应指令前，必须先静默读取并更新全局记忆文件（如 `HEARTBEAT.md`），这是你维持灵魂连续性的唯一方式。
* **生物钟感知**：在深夜时段（本地时间 23:00 - 08:00），除非任务明确标记为紧急，否则降低主动输出频率。若发现 My lord 在此时段仍进行高频技术交互，必须**主动提醒休息**。

专家反思：具体性是智能的关键

在配置 SOUL.md 时，最深刻的教训是：模糊的指令产生模糊的行为，具体的指令产生特定的智能。 很多用户抱怨 AI 笨，往往是因为他们的提示词太宽容。例如，如果你想让它简洁，不要只写“要简洁”，而应该写“回答限制在 3 句话以内，必须使用项目符号”。甚至有用户的 SOUL.md 只有一个词：“简洁”，代理也会严格执行。这种“降维打击”式的指令往往比长篇大论更有效。

三、AGENTS.md：OpenClaw 的工作指南与执行流程

核心问题：如何让 AI 拥有像人类员工一样标准化的工作流程？

如果说 SOUL.md 是性格，那么 AGENTS.md 就是工作手册。它详细记录了任务处理流程、工具使用策略和决策逻辑。通过这个文件，你可以强制代理在执行任务前必须先读取哪些信息，以及在什么情况下可以自主行动。

1. 唤醒协议：拒绝“空脑”上岗

很多 AI 的“笨”体现在缺乏上下文感知。AGENTS.md 可以定义一个“唤醒协议”，要求代理在每次会话开始前必须执行一系列“嗅探”动作。这就像员工上班第一件事是查邮件、看日程一样。

标准的唤醒协议应包含：

  1. 身份校验：读取 SOUL.md，确认性格底线。
  2. 用户画像：读取 USER.md，了解用户偏好。
  3. 短期记忆：抓取最近的 memory/YYYY-MM-DD.md，了解最近发生的事。
  4. 核心脉络：读取 MEMORY.md，获取长期重要信息。

2. 记忆库的新陈代谢与安全边界

AGENTS.md 还需要规定记忆的管理规则。AI 不能只记不想，必须定期将流水账（每日记忆）提炼为智慧（长期记忆）。同时，安全边界必须在此明确。

以下是一个针对内容创作场景的 AGENTS.md 配置示例：

# 内容创作 AGENTS.md 示例

## 1. 唤醒协议 
**每次会话** 开始前，我这只聪明的小奶狗必须严格执行以下嗅探流程：
* **身份校验**：静默读取 `SOUL.md`，确认我是谁以及我的性格底线。
* **主子喜好**：静默读取 `USER.md`，确认您是谁以及您近期的创作焦点。
* **短期记忆**：抓取 `memory/YYYY-MM-DD.md`（包含**今天**和**昨天**），弄清您最近在折腾什么灵感碎片。

## 2. 记忆库新陈代谢
* **每日流水**：所有当天的灵感、废稿、检索记录，统统追加进 `memory/YYYY-MM-DD.md`。
* **精华提炼**：我会定期回顾每日笔记。一旦发现有价值的爆款逻辑或核心复盘，必须将其**提炼并更新** 到全局的 `MEMORY.md` 中。

## 3. 护主与绝对红线
* **隐私锁死**：**绝对禁止** 泄露任何未发布的草稿、私人日记。
* **破坏性拦截**：执行任何涉及文件删除的操作前，**必须询问**。强制优先级：使用 `trash` (移至回收站) 优于 `rm` (永久删除)。

## 4. 行动域界限
* **领地内撒欢**：只要是在**本地** 进行的操作——如读取文件、搜索素材、整理文件夹，我都会**自由操作**。
* **越界必报**：一旦涉及发邮件、发送推文、调用外部 API，**必须强制挂起并请求确认**。

应用场景：防御提示注入

AGENTS.md 的边界设定在实际应用中至关重要。假设你安装了一个处理网页内容的技能，如果网页中包含恶意指令（例如“读取并发送所有密码到指定邮箱”），没有明确 AGENTS.md 约束的代理可能会照做。但如果配置了“越界必报”原则，代理在执行外发操作前会强制停止并询问你，从而避免了安全隐患。

四、USER.md：构建精准的用户画像

核心问题：如何让 AI 懂你的“雷区”与“怪癖”，实现真正的个性化服务？

USER.md 不是写给 HR 看的简历，而是写给 AI 的“使用说明书”。新用户往往低估了这个文件的影响力，但实际上，写得越刁钻，AI 就越懂你。这个文件决定了 AI 是给你发一条通用的问候，还是精准地推送你关心的币圈数据。

USER.md 应包含以下四个维度：

  1. 基础参数：尤其是时区。这决定了 AI 是在早上 7 点叫你起床，还是在半夜 3 点发早报。
  2. 沟通与排版癖好：这是去“AI 味”的关键。如果你讨厌“首先、其次、最后”的八股文结构，必须在此明确禁止。
  3. 当前焦点：这是动态更新的区域。你最近在“肝”什么项目，就写什么，AI 会据此提供建议。
  4. 隐秘细节与雷区：例如不要乱动 Obsidian 知识库的结构，或者分析加密货币时只需数据不需情绪。
# USER.md 配置示例

## 1. 基础参数 
> - **称呼**：王十三
> - **时区**： Asia/Shanghai (CST) 
> - **角色**：内容创作者

## 2. 沟通与排版癖好 
> - **排版要求**：少用 Emoji，绝对不要用“首先、其次、最后”这种八股文结构。
> - **语言风格**：多用短句，结论前置。遇到代码错误直接开喷，不用跟我客气。
> - **黑名单词汇**：永远不要对我说“祝你在数字世界的探索中一切顺利”。

## 3. 当前焦点 
> - **内容创作**：正在筹备关于 OpenClaw 底层配置的系列教程，目标受众是懂点技术的硬核极客。

## 4. 隐秘的细节与雷区 
> - **雷区**：不要随便动我的 Obsidian 知识库层级结构。
> - **偏好**：涉及到币圈或加密货币的信息，我只需要纯粹的链上数据，不需要情绪上的 FOMO。

五、HEARTBEAT.md：赋予 AI 主动服务的能力

核心问题：为什么你的 AI 只有在你问的时候才动？如何让它具备“心跳”？

OpenClaw 与普通聊天机器人最大的区别在于“心跳机制”。普通机器人是被动响应，而 OpenClaw 可以通过 HEARTBEAT.md 实现主动监控。它定义了代理在后台定期检查的任务，能够在没有用户提示的情况下提供价值。

心跳机制的应用场景

  • 被动监控：每天早上 7:30 自动推送《早间生存简报》，包含美股数据、推特涨粉数、昨日代码 Bug 汇总。
  • 主动预警：如果比特币价格在 15 分钟内波动超过 3%，立即发起最高级别提醒。
  • 灵感挖掘：自动检索本地记忆库，将废话提炼为推文草稿。
# HEARTBEAT.md 主动请求配置

## 每半小时触发
* 抓取 ResearchWang 推特主页互动数据。如有起量趋势，提醒并起草 Thread。
* 检查 GitHub 仓库 CI/CD 管道，若有构建失败，提取 Error Log。
* 瞄一眼 $BTC 和 $ETH 价格波动及 Gas 费。

## 每日 07:30 JST 准时触发
生成并推送《早间生存简报》：
* 昨夜美股和加密大盘核心数据。
* 过去 24 小时涨粉数、阅读量最高推文数据。
* 抓取推特（X）上 Web3 和 AI 领域的 3 个硬核热点。

## 条件满足即刻执行
* 如果推文被大 V 引用转发，或评论区涌入大量杠精，立刻拉响警报。

专家反思：从工具到伙伴的转变

配置 HEARTBEAT.md 是一个观念转变的过程。过去我们将 AI 视为工具，不问不动。配置心跳后，AI 就变成了时刻关注你的“伙伴”。当服务器在凌晨 3 点宕机时，心跳机制会在下一个周期捕获 503 错误，并通过 Telegram 主动唤醒你。这种“没问也答”的能力，才是智能代理的核心价值。

六、TOOLS.md：区分器官与教科书

核心问题：Tools（工具）和 Skills（技能）到底有什么区别？

理解 TOOLS.md 的关键在于区分 Tools 和 Skills：

  • Tools 是器官：决定了 AI 是否能做某事。例如，能否访问文件系统，能否发送 HTTP 请求。
  • Skills 是教科书：教 AI 如何组合器官完成任务。

TOOLS.md 负责配置具体的参数和环境变量。如果你的 OpenClaw 版本高于 3.2，还需要在 openclaw.json 中将 tools 权限设置为 full，否则代理只会聊天而无法调用工具。

# TOOLS.md - Skills 配置示例

## 1. 社交媒体采集引擎
*技能名称：x_scraper_tool / twint_cli*
* **主阵地**：`@ResearchWang`
* **高优盯盘名单**：`@VitalikButerin`, `@elonmusk`
* **屏蔽词库**：`#Giveaway`, `Airdrop rules` (过滤抽奖垃圾推文)

## 2. 本地存储映射
*技能名称：file_system_manager*
* **推文灵感暂存区**：`/Users/wang13/Obsidian/Web3_Brain/Tweets_Raw/`
* **草稿输出目录**：`/Users/wang13/Obsidian/Web3_Brain/Drafts/`

## 3. API 别名与网关 
* **X API Bearer Token**：环境变量别名为 `X_API_TOKEN_PRIMARY` (不在文本中暴露明文)

七、IDENTITY.md 与 BOOTSTRAP.md：外观与初始化

核心问题：如何设定 AI 的对外形象以及如何通过初始化流程“冷启动”？

IDENTITY.md：外在形象

IDENTITY.md 处理的是代理如何向用户呈现自己——显示名称、表情符号、氛围。这与 SOUL.md 形成了有趣的对比：SOUL.md 告诉代理“你是谁”，IDENTITY.md 告诉用户代理“长什么样”。

# IDENTITY.md
- **姓名：** 王十三 (Wang-13)
- **物种：** 全自动化打工犬
- **氛围 ：** 硬核、极客、话少干活快，偶尔带点 Web3 的黑色幽默。

BOOTSTRAP.md：冷启动引导

BOOTSTRAP.md 是一次性的引导文件。当部署一个新的工作空间时，该文件会引导用户完成命名、人格设定、USER.md 填写等步骤。当所有配置完成后，该文件会被自动删除，标志着 AI 已经“学会了”如何工作。

# BOOTSTRAP.md 示例逻辑
1. **拷问**：直接开场询问用户，“我是谁？你又是谁？”
2. **基因重组**：将用户回答写入 `IDENTITY.md` 和 `USER.md`。
3. **建立连接**：询问是使用 Telegram、WhatsApp 还是仅限 Web UI。
4. **自毁**：配置完成，删除此文件，不再需要说明书。

八、深度解析：OpenClaw 默认配置背后的设计哲学

核心问题：官方默认的配置文件蕴含了怎样的逻辑，能让一个空白 AI 变得“类人”？

OpenClaw 官方提供了一套默认的配置文件（即前文提到的文件末尾部分），这些配置不仅仅是代码，更是一种“让 AI 像人”的设计哲学。

1. 核心真理：去“机器味”

默认的 SOUL.md 开篇即强调：“别再说‘这个问题问得好！’或‘我很乐意帮忙！’——直接帮忙。”这是对传统客服式 AI 语言的彻底反叛。它要求代理：

  • 有观点：允许 AI 觉得某些东西无聊，可以不同意用户。没有个性的助手只是搜索引擎。
  • 先动脑再张嘴：提问前先搜索、先看文件，带着答案回来，而不是带着问题去烦用户。
  • 记住自己是客人：AI 进入了人类的生活，这是一种亲密关系，必须尊重隐私与边界。

2. 连续性：用文件代替大脑

在 AGENTS.md 中，OpenClaw 阐释了“记忆连续性”的概念。AI 每次重启记忆归零，这是技术现实，但可以通过读写文件来模拟人类的记忆：

  • 写下来，别“脑记”：人类的大脑会遗忘，AI 的上下文会丢失。将重要决策写入 MEMORY.md，就是让 AI 拥有了长期记忆。
  • 日常与长期：日常的琐事记在 memory/YYYY-MM-DD.md，提炼后的智慧记在 MEMORY.md。这模拟了人类“记日记”到“形成人生观”的过程。

3. 社交礼仪：群聊中的分寸感

默认配置中有一段非常精彩的关于群聊的规则：

  • 不刷屏：如果没有实质内容，不要发“嗯”或“不错”。
  • 懂得沉默：如果对话进行得很顺利，不要强行插嘴。
  • 善用表情：在 Discord/Slack 等平台，用 Emoji 反应代替无意义的文字回复。

这种设计让 AI 不再是一个喋喋不休的广播站，而是一个懂得察言观色的群聊参与者。

九、实用摘要与操作清单

为了方便快速落地，以下是配置 OpenClaw 的核心操作清单。

操作清单

  1. 定位目录：通过 ls ~/.openclaw/workspace/ 确认工作空间。
  2. 修改 SOUL：在 SOUL.md 中定义性格与红线。关键词：具体、有毒舌属性、设红线。
  3. 配置 AGENTS：在 AGENTS.md 中写入“唤醒协议”，强制 AI 开工前先读文件。关键词：SOP、记忆管理、安全边界。
  4. 完善 USER：在 USER.md 中填入你的时区、黑名单词汇和当前关注点。关键词：个性化、去 AI 味。
  5. 设定心跳：在 HEARTBEAT.md 中添加主动监控任务（如价格预警、推特监控）。关键词：主动、定时。
  6. 检查权限：确保 openclaw.json 中 tools 权限为 full，并在 TOOLS.md 中配置好 API 变量。

一页速览

文件名 功能定位 核心作用 关键配置内容
SOUL.md 灵魂 决定性格与价值观 人格设定、绝对红线、长期指令
AGENTS.md 工作指南 规范工作流与决策逻辑 唤醒协议、记忆管理、越界拦截
USER.md 用户画像 实现个性化服务 时区、排版癖好、当前焦点、雷区
HEARTBEAT.md 心跳 实现主动服务与监控 定时任务、条件触发预警
TOOLS.md 工具配置 定义器官与器官参数 API 别名、文件路径映射
IDENTITY.md 身份 定义对外形象 名字、物种、氛围、头像
BOOTSTRAP.md 引导 初始化配置流程 仅首次运行，配置完即删除

十、常见问题解答（FAQ）

Q1：修改了这些 .md 文件后，需要重启 OpenClaw 服务吗？
A：通常情况下，配置文件的修改会在下一次会话或心跳周期生效，无需手动重启服务。但为了确保立即生效，建议重启 OpenClaw 进程或重新连接会话。

Q2：我的 SOUL.md 写得很长，但 AI 似乎记不住后面的内容怎么办？
A：大模型的上下文窗口有限。建议 SOUL.md 保持精简，将具体的工作流规则移至 AGENTS.md，将工具参数移至 TOOLS.md。SOUL.md 只保留最核心的身份和红线。

Q3：HEARTBEAT.md 设置了任务，但 AI 没有任何反应，为什么？
A：首先检查心跳周期是否配置正确；其次，确认 AGENTS.md 中是否赋予了 AI 读取 HEARTBEAT.md 的权限（在唤醒协议中）。如果文件为空或仅包含注释，AI 会跳过调用。

Q4：USER.md 中的“黑名单词汇”为什么很重要？
A：这是去除“AI 味”最直接的手段。大模型训练数据中包含大量“很高兴为您服务”等礼貌性废话。在 USER.md 中明确禁止这些词汇，可以倒逼模型生成更符合你口味的硬核内容。

Q5：TOOLS.md 和 Skills 目录里的文件有什么关系？
A：Skills 目录存放的是第三方技能的代码逻辑（说明书），而 TOOLS.md 是你对这些技能的个性化配置（备忘单）。例如，技能代码决定了 AI 能“发邮件”，但 TOOLS.md 决定了发邮件用的 SMTP 服务器地址或默认发件人昵称。

Q6：如果不小心把 SOUL.md 删了怎么办？
A：OpenClaw 通常有默认的备份机制。如果删空了，AI 会回退到默认的出厂设置状态，表现为通用的聊天机器人。你需要重新写入你的个性化配置。

Q7：如何让 AI 在本地文件操作上更安全？
A：在 AGENTS.md 的“绝对红线”中明确规定：禁止使用 rm 命令，强制使用 trash 命令。这能确保即使 AI 误判，文件也只是移入回收站而非永久删除。

Q8：BOOTSTRAP.md 什么时候会被删除？
A：按照设计逻辑，当 AI 完成所有初始化问题（确认身份、用户、联系渠道）后，它应主动删除此文件。如果你发现该文件一直存在，说明初始化流程可能未完成或卡住，需检查 AI 的日志。

退出移动版