乐于分享
好东西不私藏

你养的小龙虾(openclaw)太呆?搞懂这8个md文件,打造专属“虾格”

你养的小龙虾(openclaw)太呆?搞懂这8个md文件,打造专属“虾格”

📜 引言

别人的龙虾已经养的越来越像自己喜欢风格了,而你的龙虾还像个路人机器人🤖?搞懂工作空间(/${用户}/.openclaw/workspace目录)中这8个MD文件就可以DIY你的龙虾。OpenClaw 采用文件化的工作空间设计,AI 助手的身份、性格、规则和记忆都存在一个个Markdown 文件里。这种设计让配置清晰好找,修改方便。本文说说工作空间根目录下每个 MD文件 是干嘛的,怎么用,配点实际例子。

注:刚装完 OpenClaw 的话(openclaw安装),这篇文章能帮你快速搞懂整个文件结构,上手自定义配置。

📁 根目录 MD 文件总览

OpenClaw 工作空间有这些文件:

文件名
作用
要吗
AGENTS.md
工作空间总的规则和操作规范
✅ 要
BOOTSTRAP.md
第一次启动引导配置
❌ 用完删
SOUL.md
AI 助手的性格、核心原则和风格
✅ 要
IDENTITY.md
AI 身份信息(名字、类型、表情符号)
✅ 要
USER.md
你的个人信息和偏好
✅ 要
TOOLS.md
本地环境配置笔记
✅ 要
HEARTBEAT.md
定时主动检查任务配置
⚙️ 可选
MEMORY.md
长期记忆存储(仅主会话加载)
🧠 可选

👨‍💻 逐个文件说明

1. BOOTSTRAP.md – 第一次启动引导

全新空白工作空间才有这个文件,帮你第一次配置的时候和 AI 一起确定互相的身份。配置完就得删掉。

流程:

  1. AI 开口第一句大概是:
Hey. I just came online. Who am I? Who are you?
  1. 一起确定四件事(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.**## BoundariesWhen 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### SSHhome-server → 192.168.1.100,用户名 admin,端口 22cloud-vps → 123.123.123.123,用户名 root,密钥登录### TTSPreferred 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 保姆级教程

最新最详细小龙虾(openclaw)喂饭级安装使用教程

零失败3分钟龙虾(openclaw)急速对接QQ机器人

小龙虾(openclaw)使用免费ollama本地模型,告别Token焦虑

小龙虾(openclaw)免费使用ollama云端大模型教程