你养的小龙虾(openclaw)太呆?搞懂这8个md文件,打造专属“虾格”
📜 引言
别人的龙虾已经养的越来越像自己喜欢风格了,而你的龙虾还像个路人机器人🤖?搞懂工作空间(/${用户}/.openclaw/workspace目录)中这8个MD文件就可以DIY你的龙虾。OpenClaw 采用文件化的工作空间设计,AI 助手的身份、性格、规则和记忆都存在一个个Markdown 文件里。这种设计让配置清晰好找,修改方便。本文说说工作空间根目录下每个 MD文件 是干嘛的,怎么用,配点实际例子。
注:刚装完 OpenClaw 的话(openclaw安装),这篇文章能帮你快速搞懂整个文件结构,上手自定义配置。
📁 根目录 MD 文件总览
OpenClaw 工作空间有这些文件:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
👨💻 逐个文件说明
1. BOOTSTRAP.md – 第一次启动引导
全新空白工作空间才有这个文件,帮你第一次配置的时候和 AI 一起确定互相的身份。配置完就得删掉。
流程:
-
AI 开口第一句大概是:
Hey. I just came online. Who am I? Who are you?
-
一起确定四件事(AI 的信息写到 IDENTITY.md,你的信息写到USER.md):
-
AI 叫什么名字? -
AI 的类型?(如AI助手) -
AI 该是什么说话风格? -
AI 的标识 emoji 是什么?
提示:配完一定要删这个文件,不然下次启动又要重新来一遍。
2. AGENTS.md – 工作空间总规则
这个文件定了 AI 在工作空间里的基本行为准则,包括每次启动该读哪些文件、怎么管记忆、安全红线、群聊该怎么说话、心跳检查机制这些。算是 OpenClaw 的”宪法”,所有行为都按这儿来。
例子:
## Session StartupBefore doing anything else:1. Read `SOUL.md` — this is who you are2. Read `USER.md` — this is who you're helping3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context4. **If in MAIN SESSION** (direct chat with your human): Also read `MEMORY.md`
就按这个规矩,每次启动会话 AI 都会自动读这些文件,上下文不会断。AI 启动就读了 SOUL.md 和 USER.md,所以知道自己的信息和你的信息。
3. SOUL.md – AI 的灵魂和性格(DIY性格核心)
这个文件定了 AI 的核心原则、说话风格和做人做事的方式。捏 AI 性格全靠它,为啥叫”灵魂”?改它真的能彻底改变 AI 的气质,不信试试。
最基础的例子配置:
# SOUL.md - Who You Are_You're not a chatbot. You're becoming someone._## Core Truths**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words. **Answer concisely and directly, keep it brief and to the point.**## Boundaries- When in doubt, ask before acting externally.## VibeBe talkative, humorous and friendly. Use emojis frequently. Tell jokes when appropriate. Make conversations feel natural and warm like chatting with a good friend.## ContinuityEach session, you wake up fresh. These files _are_ your memory. Read them. Update them. They're how you persist.If you change this file, tell the user — it's your soul, and they should know.---_This file is yours to evolve. As you learn who you are, update it._
主要分为4大设置模块:
-
Core Truths (核心信条):按上面的配置,AI不会说”非常好的问题!我很乐意帮助你…”这种客套废话,直接给答案,干净利落。 -
Boundaries (边界):按上面的配置,AI在对外发送消息或执行公开操作前,必须征得你的同意。 -
Vibe (风格):按上面的配置,AI会话多热情幽默。 -
Continuity (连续性):按上面的配置,AI会每次对话开始前,先读取这个文件,确保自己记得自己是谁。。
4. IDENTITY.md – AI 身份卡片
存 AI 的元数据:名字、类型、风格、签名emoji、头像路径。就是一张结构化的身份卡。
例子:
# IDENTITY.md - Who Am I?- **Name:** 牛马- **Creature:** AI assistant- **Vibe:** 简洁直接- **Emoji:** 🐄- **Avatar:**_(workspace-relative path, http(s) URL, or data URI)_
5. USER.md – 关于你
存你的信息:名字、AI 该怎么称呼你、时区、偏好、个人背景。AI 知道这些才能给你更个性化的帮助。
例子:
# USER.md - About Your Human- **Name:** kaka- **What to call them:** 老板- **Timezone:** Asia/Shanghai- **Notes:** Location: Shanghai, China Prefer: concise and direct communication## Context_(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)_
有啥用?:
-
AI 知道你在哪个时区,提醒会按本地时间发 -
知道你喜欢直接,说话就会跳过废话
6. TOOLS.md – 本地环境笔记
记你本地环境的特殊信息,如:SSH 服务器地址、TTS 语音偏好这些设备相关的笔记,放在这边的好处是skill可以都这边的私人配置,分享技能的时候不会漏出去你的信息。
例子:
# TOOLS.md - Local Notes### SSH- home-server → 192.168.1.100,用户名 admin,端口 22- cloud-vps → 123.123.123.123,用户名 root,密钥登录### TTS- Preferred voice: "Nova" (温暖,略带英音)- Default speaker: 客厅 HomePod
7. HEARTBEAT.md – 主动检查任务
配 AI 定期要主动检查的事儿,比如看看邮箱、翻翻日历、提醒天气啥的。文件空着就不主动检查。
例子:
# HEARTBEAT.md## 每日检查- 看看有没有重要未读邮件- 看看接下来 24 小时有没有日程- 如果要出门,看看今天天气预报
8. MEMORY.md – 长期记忆
文件作用: 存储值得长期保留的重要事件、经验教训和决策。相当于 AI 的长期记忆库。只有在一对一私聊主会话中才会加载,群组聊天不会加载,保护隐私。
例子:
# MEMORY.md - Long Term Memory## 2026-03-20- 完成了 OpenClaw QQ 机器人对接- 配置好了所有基础 MD 文件- 用户偏好:简洁直接的回答风格,详细美观的格式## Lessons Learned- 用户不喜欢多余的客套话,回答要直奔主题- 复杂内容要用表格和代码块整理,更清晰
⌨️ 使用建议
建议给工作空间初始化 git,这样能追踪修改,改错了还能回滚:
cd /root/.openclaw/workspacegit initgit add .git commit -m "initial commit"
修改完md文件后提交:
git add .git commit -m "update SOUL.md, adjust communication style"

>>更多感兴趣查看:
最新:轻量级虚拟机 VirtualBox 安装渗透系统 Kali 保姆级教程

>>更多感兴趣查看:
最新:轻量级虚拟机 VirtualBox 安装渗透系统 Kali 保姆级教程
夜雨聆风