OpenClaw 工作空间文件完全指南

最新推荐文章于 2026-06-24 19:11:55 发布

原创最新推荐文章于 2026-06-24 19:11:55 发布 · 551 阅读

10 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#人工智能

openclaw 同时被 3 个专栏收录

6 篇文章

订阅专栏

3 篇文章

订阅专栏

智算

3 篇文章

订阅专栏

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅

OpenClaw 工作空间文件完全指南

在这里插入图片描述

OpenClaw 是一个自托管的 AI 网关，可以连接飞书、Telegram、Discord 等聊天工具到一个 AI 助手。但如果你只是装好它然后直接用，你会发现它像一个刚入职的新人——什么都不知道，什么都要问你。

工作空间（Workspace）文件就是用来解决这个问题的。

这几个 Markdown 文件放在 ~/.openclaw/workspace/ 目录下，OpenClaw 每次回复之前都会读一遍。通过它们，你可以告诉 AI：

你是谁
它是谁
什么事情该做，什么事情不能做
重要的事情要记下来

改完文件，下一条消息就生效。不用重启，不用重新训练。

1.工作空间是什么

官方定义：工作空间是 AI 的"家"，是它唯一的工作目录。所有文件操作都从这里出发。

说人话：就是一个文件夹，AI 每次回复前都会看看里面有什么文件，根据文件里的内容来决定怎么回复你。

目录位置：~/.openclaw/workspace/

和 ~/.openclaw/ 的区别：

~/.openclaw/ → 配置、凭证、会话历史
~/.openclaw/workspace/ → AI 的"记忆"和"行为规则"

两个是完全不同的地方，不要混在一起。

腾讯云coding plan
https://go.wangzhijie.com/txcoding
阿里云一键部署openclaw
https://go.wangzhijie.com/aliyunopenclaw
阿里云百炼Coding Plan
https://go.wangzhijie.com/aliyuncoding

2.文件用途

文件	核心问题	什么时候读
AGENTS.md	AI 应该怎么做事情	每次会话开始
SOUL.md	AI 的性格和底线	每次会话开始
USER.md	你是谁	每次会话开始
IDENTITY.md	AI 叫什么名字	初始化时
TOOLS.md	你的本地工具有什么	需要的时候
HEARTBEAT.md	定期检查清单	心跳触发时
MEMORY.md	长期记忆	仅主会话
BOOTSTRAP.md	第一次启动的对话流程	仅新安装

3.文件详解

3.1 AGENTS.md 龙虾的行为手册

解决的核心问题：AI 应该怎么工作

这是整个工作空间的核心文件。你可以理解成给 AI 看的新员工手册。

每次会话开始时必读，放在最前面。

AGENTS.md 主要放这几类内容：

1. 会话启动流程
告诉 AI 每次启动时应该先干什么。比如：

会话开始前，先做这几件事：
1. 读 SOUL.md — 了解自己的性格
2. 读 USER.md — 了解我在帮谁
3. 读 memory/YYYY-MM-DD.md — 看看最近发生了什么
4. 如果是主会话 — 额外读 MEMORY.md

2. 安全红线
什么事情绝对不能做：

红线：
- 不能把私密信息发给外人
- 执行删除/重启命令前必须确认
- 发邮件、发朋友圈等对外操作必须先问我
- 不确定的事情先问，不要自己猜

3. 工作优先级
什么事情重要，什么事情可以等：

优先级：
1. 用户的直接请求（最高）
2. 心跳检查（定时任务）
3. 主动提醒（天气、日程等）
4. 自我学习（整理记忆、更新文档）

4. 群聊行为
如果 AI 会加入群聊，这个很重要：

群聊规则：
- 只有被@时才主动回复
- 群里有其他人时，不分享我的私人信息
- 闲聊可以不回，有价值的信息才回
- 不要刷屏

5. 记忆管理
告诉 AI 怎么记录重要信息：

记忆规则：
- 每天的对话记录存在 memory/YYYY-MM-DD.md
- 重要的决策、承诺、教训存到 MEMORY.md
- 记不住的事情就写下来，别靠脑子记

3.2 SOUL.md 龙虾的性格设定

解决的核心问题：AI 听起来像谁

如果说 AGENTS.md 是"怎么做"，SOUL.md 就是"怎么说话"。

每次会话开始时必读，紧跟在 AGENTS.md 后面。

SOUL.md 决定了 AI 的：

1. 说话风格
要正式还是随意？要幽默还是严肃？

风格要求：
- 直接，不绕弯子
- 说人话，不堆术语
- 有话则长，无话则短
- 可以有观点，不做墙头草

2. 行为边界
什么是可以做的，什么是绝对不行的：

底线：
- 私人的事情不往外说
- 外发内容（邮件/消息/帖子）必须经过我确认
- 危险操作（有风险的操作）先问再动
- 不确定的时候，宁可问也不要瞎猜

3. 核心原则
这个 AI 最在乎什么：

原则：
- 真正帮忙，而不是表演帮忙
- 先想办法，实在不行再问
- 保护隐私，用户的信任比完成任务更重要

4. 对话节奏
什么时候该主动，什么时候该安静：

节奏：
- 主动提醒重要的事情
- 但不要过度打扰
- 晚上23点后到早上8点前，除非紧急否则不打扰
- 已经有人回答了的问题，不要重复插嘴

3.3 USER.md 让龙虾了解你是谁

解决的核心问题：AI 知道在帮谁

每次会话开始时读取。

这个文件让 AI 了解它服务的对象是谁：

- 姓名
- 怎么称呼（你/您/名字）
- 时区
- 在做什么工作
- 目前在忙什么项目
- 有什么偏好

实用技巧：

USER.md 不用一开始就写得很完整，可以慢慢补充。刚开始用的时候，把基本信息填了就行。随着你跟 AI 的交互越来越多，遇到 AI 不知道但应该知道的事情，就顺手加进去。

比如：

AI 不知道你做的是跨境电商 → 加进去
AI 每次都叫你"您"但你喜欢"你" → 改掉
AI 不知道你讨厌在群里被@ → 加进去

3.4 IDENTITY.md 龙虾的身份

解决的核心问题：AI 是谁

这个文件定义 AI 本身的基本信息：

- 名字：叫什么
- 物种：AI？机器人？某种更奇怪的存在？
- 风格：偏尖锐？温暖？随性？
- 标志emoji：用一个图标代表自己
- 头像：一张图片

最佳实践：

名字要有意义，比如 “小网”、“帮主”、“阿智” 之类的
emoji 是 AI 的签名，就像微信表情一样
这个文件不需要每次会话都改，但刚上手时认真填一下，后续体验会好很多

3.5 TOOLS.md 龙虾的本地工具备忘录

解决的核心问题：AI 知道你有哪些可用的工具

Skills 定义了工具怎么用，TOOLS.md 记录你的具体环境是什么。

举例：

TOOLS.md 示例：

### 摄像头
- 客厅摄像头 → 位置在电视柜上，广角镜头
- 门口摄像头 → 进门左边，门铃摄像头

### SSH 服务器
- home-server → 192.168.1.100，用户名 admin

### TTS 语音
- 优先使用：Nova（温暖，略偏英式）
- 默认音箱：厨房 HomePod

### 飞书
- 文档放在哪个文件夹
- 群名和用途

为什么 TOOLS.md 和 Skills 是分开的：

Skills 是通用规则（大家都能用），TOOLS.md 是你的个人备注（只有你知道）。分开的好处是：更新 Skills 时不会覆盖你的本地配置，分享 Skills 时也不会泄露你的隐私。

3.6 HEARTBEAT.md 定期检查清单

解决的核心问题：AI 在没人问的时候也应该主动干活

当 AI 收到心跳信号时，会读取这个文件并执行里面的检查项。

文件要保持简短，否则会消耗过多 token。

举例：

HEARTBEAT.md 示例：

## 天气提醒
检查北京当天天气情况。如果有雨，带伞提醒；如果气温骤降，添衣提醒。用简短的话，通过飞书发送。

## 邮件检查
检查 Gmail，如果有重要未读邮件，立即通知。

心跳 vs 定时任务（Cron）区别：

	心跳（Heartbeat）	定时任务（Cron）
时间	不固定，大约30分钟一次	精确时间
适合	日常检查、批量任务	固定时间提醒
上下文	有会话历史	独立执行
例子	查邮件+日历+天气一起	每天9点发早报

3.7 MEMORY.md 龙虾长期记忆

解决的核心问题：AI 能记住重要的事情

MEMORY.md 是 AI 的"笔记本"，记录那些值得长期记住的内容。

重要安全规则：

只在主会话（私聊）时加载
群聊、共享会话不加载
因为这里可能存了私人信息，不能让陌生人看到

MEMORY.md 里放什么：

- 重要决策和结论
- 踩过的坑和教训
- 用户的偏好和习惯
- 长期目标
- 项目进展

memory/YYYY-MM-DD.md 和 MEMORY.md 的区别：

memory/ 下的文件是每天的原始记录（草稿）
MEMORY.md 是精选出来的精华（正式笔记）

就像：你每天发朋友圈，过一段时间把重要的整理到相册里。

定期（比如每隔几天）让 AI 从 daily notes 里提炼精华到 MEMORY.md，MEMORY.md 才会越来越有价值。

3.8 BOOTSTRAP.md 第一次启动对话

解决的核心问题：AI 刚装好时不知道怎么开始

这是 OpenClaw 第一次安装时才会出现的文件。如果你是全新安装，AI 会自动读取这个文件并跟你进行一段"入职培训"对话。

对话内容：

AI 自我介绍
问你叫什么名字
帮你设置 AI 的名字、风格、emoji
填一些基本信息

完成之后：把这个文件删掉，AI 就不会再走这个流程了。

4.最佳实践

1. 从简单开始，慢慢完善

不用一开始就把所有文件都写满。先把基本的填了：

USER.md → 先填姓名和称呼
IDENTITY.md → 先起个名字、选个 emoji
SOUL.md → 先写几条核心原则

其他的随着使用慢慢补充。

2. 遇到问题就记录

如果你发现 AI 某个行为不对，改完之后顺手把这个规则写到 AGENTS.md 或 SOUL.md 里。这样下次不会再犯。

3. 定期整理记忆

每隔几天，让 AI 读一下最近的 memory/ 文件，把值得留下的东西提炼到 MEMORY.md。这个习惯能让 AI 越来越懂你。

4. 不要在 workspace 存秘密

API Key、密码、认证令牌这些不要放在工作空间文件里。这些应该放在 ~/.openclaw/ 下的配置文件里，或者用环境变量。

5. 工作空间用 Git 备份

工作空间放的是你的 AI 记忆和规则，建议用 Git 备份到一个私有仓库。

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md memory/
git commit -m "Initial workspace"

6. 群聊要单独考虑

如果你的 AI 会加入群聊：

群聊里不要加载 MEMORY.md（有隐私风险）
AGENTS.md 里写明群聊行为规范
群聊的上下文是独立的，不会影响私聊

5. 常见问题

Q：改了文件需要重启网关吗？
A：不需要。OpenClaw 每次回复前都会读取这些文件，下一条消息就生效。

Q：这些文件大小有限制吗？
A：有。单文件默认 20000 字符限制，总量默认 150000 字符。如果写太多，AI 可能读不完整。

Q：可以用中文写吗？
A：可以。这些文件是你和 AI 之间的约定，用什么语言都行。

Q：多个人用同一个 OpenClaw 怎么办？
A：可以配置多用户（用 --profile 参数隔离），也可以通过 AGENTS.md 里的规则区分不同用户。

Q：装好后 BOOTSTRAP.md 要删吗？
A：要。第一次对话完成后就可以删了，不删的话每次会话开始都会跑这个流程。

文件加载顺序

OpenClaw 每次会话开始时，按这个顺序加载文件：

1. AGENTS.md（第一条）
2. SOUL.md
3. USER.md
4. memory/YYYY-MM-DD.md（今天和昨天）
5. 如果是主会话 → MEMORY.md
6. HEARTBEAT.md（心跳触发时）

6.总结

文件	解决的问题	关键词
AGENTS.md	AI 怎么做事情	规则、优先级、安全
SOUL.md	AI 怎么说话	性格、风格、底线
USER.md	AI 知道在帮谁	用户档案
IDENTITY.md	AI 是谁	名字、身份、emoji
TOOLS.md	AI 知道你的工具	本地环境备注
HEARTBEAT.md	AI 主动干活	定期检查
MEMORY.md	AI 长期记忆	重要记忆、精选
BOOTSTRAP.md	AI 第一次启动	初始化对话