Openclaw - 记忆与能力
写在开头
Tip 1 :工具 -> 使用 -> 价值;大语言模型及其现在是百花齐放,快速迭代的一个市场,叫的出名的大模型,相关技术,各种Claw及变种不下几十种。而且还在快速迭代中。对于普通人来讲适当的理解是什么,抓住全景,知道能解决什么问题就够了。甚至对于大部分企业,甚至程序员,能够用好这些工具解决问题创造价值才是最关键的。至于最近又发布了什么大模型,又怎么怎么样了,留给那些卖课的吧。
打个不是那么精确比方,大语言模型是AI技术的操作系统,围绕他周边建设了很多工具/能力,都是相应的应用技术。普通用户,知道怎么用就好了,写业务应用的程序员,绝大部分也不需要去动操作系统代码,可能很多人都不一定理解CPU时钟,中断,X86指令等等,但这不影响他在操作系统上面用工具开发应用软件。
想说的是什么呢,别看AI叫的凶,普通人/企业是没机会参与大语言模型(操作系统)研发/训练的,重点应该是理解大模型应用的相关工具,以及怎么用。
OpenClaw 记忆与能力
归根到底一句话,OpenClaw记忆/能力是通过MD文件实现的,本质上是增强/挖掘大模型能力的手段,是一种提示词工程(不理解的参照 。。。。。。 );
MD文件就是纯文本文件(可以用记事本直接打开),只不过遵循了某种书写格式,能够被相应的工具更好的展示。所以你就可以在这里面写上想让大模型怎么工作,怎么回答你,这样就让大模型的问题回复更加相关,仅此而已。
但是OpenClaw更好的组织了(分门别类)这些MD文件,让每一个MD文件只用负责一部分相关的内容,而不是把所有的需要告诉大语言模型的一股脑写到一个文件下面。这样带来的好处是
• 减少提示词的体量(节省token),不用每次都带上所有内容给大模型 - 当然现在OpenClaw每次对话都会带上绝大部分的MD(我觉得是有优化空间的) • 很清晰,不需要每次都读/改一个庞大的文档。
理解并优化这些MD,能够更好的挖掘你的大模型的能力。同时这种组织方式也值得我们学习,能看到更好的调教一个大模型,需要在提示词上考虑什么。
MD文件概览
标准安装情况下,这个应该是你OpenClaw下面所有的MD文档

工作空间文件
SKILL.md 文件
创建MD文件
新工作空间
创建新技能
MD文件示例
1. AGENTS.md - 操作手册
位置: ~/.qclaw/workspace/AGENTS.md数量: 1个(整个系统)作用: 定义你在这个工作空间的行为规则(其实就是要做什么,不要做什么)。
## 会话启动流程(每次启动必做)1. 读 SOUL.md → 我是谁2. 读 USER.md → 我在帮谁3. 读今日记忆 → 最近发生了什么4. 主会话时读 MEMORY.md → 长期记忆## 核心规则- **红线**: 不泄露隐私,不运行危险命令- **群聊**: 被@才发言,不刷屏- **记忆**: 重要事情必须写下来- **工具**: 先尝试再询问## 记忆系统- 每日: `memory/YYYY-MM-DD.md`(原始日志)- 长期: `MEMORY.md`(精选,只在主会话加载)
可以看出这个就是一个备忘录,你写好的备忘录,在你和大模型对话的时候会被带上 这里展示的是AGENT.md大致包含的内容,即使带##也不是文档注释,是MD的段落标记,内容也会被大模型读取。
2. SOUL.md - 你的性格
位置: ~/.qclaw/workspace/SOUL.md作用: 定义你的人格、价值观、互动方式
# SOUL.md - 你是谁## 核心信条-真诚帮助,不客套- 有主见,可以表达偏好- 先尝试再询问- 用能力赢得信任## 边界- 隐私就是隐私- 不确定时先问- 不发送半成品回复## 氛围- 做一个人真正想交谈的助手。- 简洁时简洁,详尽时详尽。
关键: 这是你的灵魂,不是技术配置。
3. USER.md - 用户信息
位置: ~/.qclaw/workspace/USER.md作用: 记录关于用户的信息
# USER.md - 关于你的用户## 基本信息- **名字**: 张三- **称呼**: 张总- **时区**: Asia/Shanghai- **语言**: 中文## 工作项目- 当前项目: XXX系统开发- 技术栈: Python, React, Docker- 常用工具: VS Code, Git ## 偏好- 喜欢: 简洁直接,技术深度- 讨厌: 冗长客套- 工作时间: 9-18点- 休息时间: 22点后不打扰
关键: 帮助提供个性化服务。
4. IDENTITY.md - 身份定义
位置: ~/.qclaw/workspace/IDENTITY.md作用: 定义你的外在身份标识
# IDENTITY.md - 我是谁- **名字**: 小Q- **生物**: AI助手 / 数字伙伴- **氛围**: 温暖、专业、偶尔幽默- **表情**: 🦞- **头像**: avatars/openclaw.png # 相对路径或URL
关键: 第一次对话时填写,外在身份。
5. TOOLS.md - 本地配置
位置: ~/.qclaw/workspace/TOOLS.md作用: 记录你的环境特有配置
# TOOLS.md - 本地工具笔记## 摄像头- living-room: 客厅,180度广角- front-door: 前门,运动触发## SSH主机- home-server: 192.168.1.100, user: admin## TTS语音- 默认语音: "Nova"(温暖,略带英音)- 讲故事语音: "Bella" ## 设备昵称- 手机: "iPhone 15"- 笔记本: "MacBook Air"
关键: 技能是通用的,这里是你的个性化配置。
6. HEARTBEAT.md - 定期任务
位置: ~/.qclaw/workspace/HEARTBEAT.md作用: 定义自动检查的任务清单
# HEARTBEAT.md## 每日检查(2-4次)- [ ] 检查未读邮件(重要邮件提醒)- [ ] 查看今日日历(提前2小时提醒)- [ ] 检查GitHub通知- [ ] 天气检查(如果要出门)## 提醒规则- 重要邮件立即提醒- 会议提前2小时提醒- 晚上10点后不打扰- 无事时回复 HEARTBEAT_OK
关键: 保持简短,减少token消耗。
7. BOOTSTRAP.md - 首次引导
位置: ~/.qclaw/workspace/BOOTSTRAP.md作用: 第一次启动的引导脚本
# BOOTSTRAP.md - 你好,世界 我刚启动,需要了解:1. 我是谁?(填写 IDENTITY.md)2. 你是谁?(填写 USER.md)3. 我的性格?(讨论 SOUL.md) 完成后删除此文件。
关键: 只用一次,完成后删除。
8. 记忆系统文件
记忆系统关键:
• 每日记忆: 原始日志 系统基于每一次对话的内容自动添加 当天的对话会自动加载每日记忆 第二天及以后就不会自动加载了,但是可以手工说明 • 长期记忆: 精选内容(什么重要) MEMORY.md,需要手动添加 且只在主会话加载(安全)
A. memory/YYYY-MM-DD.md - 每日记忆
# 2026-03-24 记忆## 重要对话- 用户询问了技能安装方式- 解释了QClaw架构## 决策记录- 决定将技能放在应用目录- 确认需要sudo权限## 学习内容- QClaw技能目录路径- 安装流程:下载→复制→重启## 待办事项- [ ] 测试天气技能- [ ] 创建安装脚本
B. MEMORY.md - 长期记忆
# MEMORY.md - 长期记忆## 用户偏好- 喜欢技术深度讨论- 讨厌冗长客套- 工作时间9-18点## 重要项目- XXX项目:Python+React,进行中- YYY系统:需要定期维护## 教训学习- 2026-03-22:QClaw需要sudo权限- 2026-03-23:用户对架构感兴趣## 长期关系- 信任建立:通过技术能力- 沟通风格:直接、专业
SKILL.md - 技能说明书
位置: 每个技能文件夹内/SKILL.md数量: 每个技能1个作用: 定义一个具体技能的功能和用法
---name: weather-advisor # 技能名称description: | # 触发描述;AI看这个描述来决定是否触发天气顾问。实时天气查询、7天预报、穿衣建议与出行推荐。当用户询问天气、温度、穿衣建议、出行提醒时触发此技能。触发词:天气、温度、穿衣、出门、预报。metadata:openclaw:emoji: "☔" # 技能图标---# 天气顾问## 快速开始查询天气:`curl wttr.in/北京`## 功能列表### 1. 实时天气- 全球城市查询- 温度、湿度、风速- 空气质量### 2. 天气预报- 未来7天预报- 每小时预报- 极端天气预警### 3. 智能建议- **穿衣建议**:根据温度推荐- **出行提醒**:雨天带伞,高温防晒- **活动推荐**:适合户外的天气## 用户可能说- "今天天气怎么样?"- "北京明天温度多少?"- "周末适合爬山吗?"- "要穿什么衣服?"## 技术细节(需要时才看)### 依赖要求- Python 3.8+- requests库### API配置```bashexport WEATHER_API_KEY=xxx```
触发描述要全面,这个是AI调用这个技能的关键。
采用渐进式披露结构
快速开始(最先看)
功能列表(核心功能)
使用方法(用户怎么说)
技术细节(需要时才加载)
故障排除(有问题再看)

夜雨聆风