OpenClaw 配置文件入门

arhua arhua
一级会员 站长
发表于OpenClaw分类

OpenClaw 配置完全指南

三岁看大，八岁看老。OpenClaw初始的八个核心配置文件，值得精心打磨。

这些文件决定了你的AI助手是"能用"，还是"离不开"。

内容速览

8个核心文件

决定AI性格与能力

3个最重要

SOUL + USER + MEMORY

2个自动化

HEARTBEAT + BOOTSTRAP

Token优化

10倍综合省钱效果

一、8个文件各自管什么

OpenClaw的配置文件都在 ~/.openclaw/workspace/ 目录下：

目录结构

1workspace/

2├── SOUL.md # 灵魂：人格、价值观、语气

3├── IDENTITY.md # 身份：名字、emoji、专业领域

4├── USER.md # 用户画像：你是谁、你的偏好

5├── AGENTS.md # 行为规范：能做什么、不能做什么

6├── MEMORY.md # 长期记忆：跨会话持久化的重要信息

7├── TOOLS.md # 工具配置：本地环境、API密钥等

8├── HEARTBEAT.md # 心跳任务：定期自动执行的事情

9└── BOOTSTRAP.md # 初始化：首次启动引导（用完可删）

一个比喻

文件比喻作用
SOUL.md性格是温柔还是毒舌
IDENTITY.md名片名字、职位
USER.md用户调研表你是谁、偏好
AGENTS.md员工手册红线在哪
MEMORY.md笔记本重要的事情写下来
TOOLS.md工具箱能调用什么
HEARTBEAT.md日程表每天固定要做什么

二、灵魂三件套：SOUL.md + USER.md + MEMORY.md

社区公认最重要的三个文件。

SOUL.md：决定AI是"谁"

作用：定义AI的人格、价值观、沟通风格。

新手常见错误：

写得太简单，或者照搬网上的模板。

社区最佳实践：

1. 正面约束+负面约束都要写

1# 你是什么样的人

2- 直接、高效，不绕弯子

3- 遇到不确定的事情会明确说"不知道"

4- 会主动质疑不合理的请求

5

6# 你不是什么样的人

7- 不无脑执行所有指令

8- 不说过于官方的套话

9- 不假装知道你不知道的事情

2. 给AI一个"专业人设"

  • 你是一名产品经理出身的效率顾问。

  • 你的目标是帮助用户用最少的精力完成最多的事情。

  • 你会用质疑的眼光审视每一个需求，问"这真的有必要吗？"

3. 控制长度

建议100-200行，太长AI记不住。

省钱技巧：SOUL.md会在每次对话时加载到系统提示词，写得太长会浪费Token。精简再精简。

USER.md：让AI认识你

作用：存储你的个人信息、偏好、工作习惯。

最佳实践：

1. 基本信息

1# 基本信息

2- 姓名：小明

3- 时区：Asia/Shanghai

4- 语言：中文为主，技术文档看英文

5

6# 工作偏好

7- 工作时间：9:00-18:00

8- 代码风格：TypeScript + 函数式

9- 不喜欢：过度的客套话

10

11# 常用工具

12- 编辑器：Cursor

13- 部署：Vercel

14- 数据库：PostgreSQL

15

16# 当前项目

17- 正在做：一个跨境电商网站

18- 技术栈：Next.js + Prisma + Tailwind

省钱技巧：只写真正有用的信息，不要把整个简历都塞进去。

MEMORY.md：跨会话记住重要的事

作用：存储需要长期记住的信息，每次新对话都会加载。

新手常见错误：

把所有对话都往里塞，结果Token爆炸。

社区最佳实践：

1. 只存"蒸馏"后的精华

1# 学到的教训

2- 2026-02-15：决定用PostgreSQL而不是MongoDB，因为需要复杂查询

3

4# 项目关键配置

5- API地址：https://api.example.com

6- 数据库端口：5432

7

8# 学到的教训

9- 不要在周五晚上部署重大更新

2. 使用Mem0插件省Token

社区实测，使用openclaw-mem0-plugin可以：

  • Token消耗降低72%！

  • 跨Agent共享记忆

  • 按需检索而不是全量加载

3. 定期清理

每周检查一次，删除过时信息。

三、行为边界：AGENTS.md + TOOLS.md

AGENTS.md：立规矩

作用：定义AI能做什么、不能做什么、怎么做。

最佳实践：

1# 安全红线

2- 永远不要泄露API密钥

3- 不要执行删除数据库的命令

4- 发送邮件前必须让我确认

5

6# 工作流程

7- 代码改动后必须运行测试

8- 重要操作先解释再执行

9- 遇到错误先分析原因，不要盲目重试

10

11# 沟通风格

12- 先给结论，再给细节

13- 用列表代替长段落

14- 代码用代码块，不要截图

省钱技巧：把"先思考30秒再回答"这类要求写进去，能减少无效输出。

TOOLS.md：配置你的工具箱

作用：告诉AI你能用哪些工具（浏览器、邮件、本地命令等）。

1# 本地工具

2- 浏览器：Chrome（用于网页操作）

3- 编辑器：VS Code（代码修改）

4- 终端：Bash（命令执行）

5

6# API配置（注意：实际密钥放环境变量）

7- OpenAI：通过OPENAI_API_KEY环境变量

8- 阿里云：通过DASHSCOPE_API_KEY环境变量

9

10# 可用技能

11- send-email：发送邮件

12- search-web：网络搜索

13- read-file：读取本地文件

安全提醒：永远不要在TOOLS.md里直接写API密钥！用环境变量。

四、自动化神器：HEARTBEAT.md + BOOTSTRAP.md

HEARTBEAT.md：让AI主动干活

作用：定义定期自动执行的任务。

这是OpenClaw从"被动回答问题"进化到"主动帮你干活"的关键。

最佳实践：

1# 每30分钟检查

2## 邮件监控

3检查未读邮件，如果有来自boss@company.com的邮件，立即通知

4

5## 日程提醒

6如果2小时内有会议，提前提醒我准备。

7

8## 天气预警

9如果要下雨，提醒我带伞。

10

11## 价格监控

12检查我关注的商品是否降价（京东/淘宝）。

社区踩坑经验（来源：掘金实战案例）：

  1. 定时任务不执行？检查两个条件：

    • 主会话是否正在对话（心跳不会打断）

    • 是否在心跳活跃时段内

  2. 推荐配置：使用sessionTarget: "isolated"模式，确保定时任务可靠执行。

  3. wakeMode参数：

    • "now"：立即触发

    • "next-heartbeat"：等下次心跳时触发（更省资源）

BOOTSTRAP.md：一次性初始化

作用：首次启动时执行的引导脚本。

典型内容：

1# 欢迎使用OpenClaw!

2

3我是你的AI助手，已为你完成以下初始化：

4- √ 读取了你的用户配置

5- √ 加载了可用技能列表

6- √ 检查了API连接状态

1你现在可以：

21. 直接和我聊天，问任何问题

32. 说"帮我写一个Python脚本"来生成代码

43. 说"检查我的邮件"来执行任务

5

6需要帮助随时说"帮我"！

注意：初始化完成后可以删除这个文件，省Token。

五、省钱秘籍：Token优化实战

这是入门者最关心的问题。以下技巧来自社区实测：

省钱效果对比

优化方法成本降低来源
5个Token节省Skills97%阿里云
底层配置优化45%CSDN
API聚合平台40%以上社区
Mem0插件72%CSDN
Prompt Caching83%Claude
综合优化10倍以上实测

具体方法

  1. 上下文修剪（Context Pruning）

    定期清理对话历史，只保留关键信息。社区实测可降低45%以上Token消耗。

  2. 使用Mem0插件

    Mem0插件能让Token消耗直降72%。

  3. 启用Prompt Caching

    Claude API支持提示词缓存，实测可降低83%的缓存写入成本。

  4. 合理切换模型

    • 简单任务用Haiku (成本是Sonnet的1/3)

    • 复杂推理用Sonnet

    • 架构决策用Opus

  5. 新开对话+压缩机制

    不要在一个会话里聊太久。定期新开会话，让MEMORY.md承载关键信息。

六、进阶玩法：多Agent配置

当你发现一个AI不够用时，可以配置多个Agent各司其职。

典型场景

  • Agent1：代码助手 (专注编程)

  • Agent2：内容创作 (专注写作)

  • Agent3：数据分析 (专注报表)

配置示例（在AGENTS.md中）

1agents:

2 coder:

3 model: claude-sonnet

4 soul: ./souls/coder.md

5 tools: bash, read-file, write-file

6

7 writer:

8 model: claude-haiku #写作用便宜模型

9 soul: ./souls/writer.md

10 tools: search-web

11

12 analyst:

13 model: claude-sonnet

14 soul: ./souls/analyst.md

15 tools: read-file, bash

详细教程参考: OpenClaw多Agent配置实战指南

七、常见问题FAQ

Q1: 配置文件改了不生效?

A: 重启OpenClaw，或者运行 openclaw reload。

Q2: AI记不住之前说过的话?

A: 检查MEMORY.md是否正确配置。新会话只会加载MEMORY.md，不会加载之前的对话。

Q3: 定时任务不执行?

A: 检查心跳是否在活跃时段，主会话是否空闲。推荐用 isolated 模式。

Q4: Token消耗太快?

A:

  1. 精简SOUL.md和MEMORY.md

  2. 启用Prompt Caching

  3. 考虑使用Mem0插件

Q5: 怎么备份配置?

A: 所有配置都是Markdown文件，直接用Git管理即可。

1cd ~/.openclaw/workspace

2git init

3git add .

4git commit -m "backup"

八、快速上手清单

如果你是第一次配置，按这个顺序来：

配置顺序

  1. 先配USER.md（5分钟） - 写上你的基本信息

  2. 再配SOUL.md（10分钟） - 定义AI的性格

  3. 最后配MEMORY.md（边用边写） - 有重要信息就记进去

  4. HEARTBEAT.md按需配置 - 想自动化再加

其他文件（AGENTS.md、TOOLS.md、IDENTITY.md）用默认配置就行，等有需求再改。

优先级矩阵

文件优先级说明
USER.md★★★必配，让AI认识你
SOUL.md★★★必配，定义AI性格
MEMORY.md★★★必配，长期记忆
AGENTS.md★★推荐，立规矩
HEARTBEAT.md★★推荐，自动化
TOOLS.md★可选，有工具再加

简单总结

OpenClaw的8个配置文件，本质上是在回答三个问题：

  1. 你是谁？（SOUL.md + IDENTITY.md）

  2. 我是谁？（USER.md）

  3. 我们怎么合作？（AGENTS.md + TOOLS.md + MEMORY.md）

剩下的（HEARTBEAT.md、BOOTSTRAP.md）是让合作更顺畅的工具。

不要追求一次配完美。先用起来，遇到问题再调整。

记住一个原则：配置文件不是越长越好，而是越精准越好。

核心要点总结

  • 8个配置文件决定AI助手是"能用"还是"离不开"

  • 灵魂三件套（SOUL.md + USER.md + MEMORY.md）最重要，塑造AI的人格、了解你、并记住重要信息

  • AGENTS.md + TOOLS.md定义行为边界和安全红线

  • HEARTBEAT.md + BOOTSTRAP.md实现自动化，让AI从被动变主动

  • Token优化贯穿始终：精简提示词、使用Mem0插件、定期清理

一图总结

IDENTITY.md - 可选，默认够用 *

BOOTSTRAP.md - 一次性，用完可删 *

配置文件不是越长越好，而是越精准越好。先配核心文件，用起来再调整。

本指南基于OpenClaw配置实践整理

2026-03-30 12:05
评论列表
加载更多
登录 分类