MEMORY.md 自动管理 Skill
🧠 自动创建和维护 OpenClaw 长期记忆文件，让 AI 助手拥有持续的记忆能力！
⚠️ 安全警告
请使用 v1.0.10 或更高版本！
- ❌ v1.0.0 - v1.0.9: 可能包含不安全的占位符
- ✅ v1.0.10+: 已修复安全问题
- ✅ v1.0.14+ (推荐): 最新安全版本
# 检查版本
clawhub info memory-manager-zx
# 更新到最新版本
clawhub install memory-manager-zx@latest📦 安装
# 本地安装
cd ~/.openclaw/workspace/skills
# 复制此目录到 memory-manager🚀 快速开始
一键安装
cd ~/.openclaw/workspace/skills/memory-manager
./install.sh手动配置
# 1. 创建 MEMORY.md 模板
openclaw memory init
# 2. 配置每日更新任务 (每天午夜 00:00)
openclaw cron add --name "MEMORY 每日更新" \
--schedule "0 0 * * *" \
--message "检查当天会话，更新 MEMORY.md"📋 功能
运行时依赖
| 工具 | 用途 | 是否必需 |
|---|---|---|
bash | 脚本执行 | ✅ 必需 |
curl | HTTP 请求（智能筛选） | ✅ 必需 |
jq | JSON 解析 | ✅ 必需 |
python3 | API 调用和 JSON 处理 | ✅ 必需 |
openclaw CLI | cron 任务配置 | ⚠️ 可选（用于自动配置） |
1. 自动创建 MEMORY.md
提供标准化的长期记忆模板：
# MEMORY.md - [助手名称] 的长期记忆
## 👤 关于用户
## 🏠 系统环境
## ⚙️ 核心配置
## 📅 重要事件
## 📌 待办事项2. 每日自动更新（智能筛选）
通过 cron 任务在每天午夜自动：
- 检查当天会话历史 (
memory/YYYY-MM-DD.md) - 规则预过滤 - 使用 30+ 关键词模式快速匹配
- LLM 分析 - 调用 Qwen 模型提炼重要事件
- 脱敏检测 - 自动识别 Token/Secret 等敏感信息
- 更新 MEMORY.md 的「重要事件记录」
3. 手动整理记忆
⚠️ 重要: 自动更新不会智能筛选内容，建议定期手动整理：
- 阅读
memory/YYYY-MM-DD.md每日日志 - 手动提炼重要事件到 MEMORY.md
- 可使用
openclaw cron配置定期提醒整理
⚙️ 配置选项
🔌 API 配置（可选）
智能筛选会自动读取 OpenClaw 配置！
工作原理
1. 读取 ~/.openclaw/openclaw.json
2. 找到第一个配置的 provider（有 baseUrl）
3. 自动提取 API 地址和默认模型
4. 根据 provider 名称匹配对应的 API Key 环境变量配置 API Key
只需配置一个环境变量，Skill 会自动匹配：
# 添加到 ~/.bashrc（推荐）
# 根据你的服务商选择：
# 阿里云百炼 (modelstudio)
export BAILIAN_API_KEY="your-api-key-here"
# DeepSeek / vLLM
export DEEPSEEK_API_KEY="xxx"
# OpenAI
export OPENAI_API_KEY="your-api-key-here"
# 通用备用
export OPENCLAW_API_KEY="xxx"支持的服务商
| provider 名称 | 匹配的环境变量（按优先级） |
|---|---|
modelstudio | BAILIAN_API_KEY → ALIYUN_API_KEY → DASHSCOPE_API_KEY |
vllm | VLLM_API_KEY → DEEPSEEK_API_KEY |
openai | OPENAI_API_KEY |
deepseek | DEEPSEEK_API_KEY |
anthropic | ANTHROPIC_API_KEY |
google | GOOGLE_API_KEY → GEMINI_API_KEY |
azure | AZURE_OPENAI_API_KEY |
| 其他 | OPENCLAW_API_KEY → API_KEY |
查看当前配置
# 查看 OpenClaw 配置的 provider
cat ~/.openclaw/openclaw.json | jq '.models.providers'
# 查看默认模型
cat ~/.openclaw/openclaw.json | jq '.agents.defaults.model.primary'降级模式
如果未配置 API Key，自动切换到规则匹配模式（免费，无需 API）。
⚠️ 安全与隐私说明：
脚本会做什么：
- ✅ 读取
~/.openclaw/openclaw.json获取 API 地址 (baseUrl) 和 provider 名称 - ✅ 从环境变量读取 API Key（如
BAILIAN_API_KEY） - ✅ 向 LLM 提供商 API 发送请求（用于智能筛选）
- ✅ 在日志中显示 API Key 的部分内容（如
sk-sp-be...dc57）
脚本不会做什么：
- ❌ 不会读取
openclaw.json中的 API Key 字段 - ❌ 不会将 API Key 写入任何文件
- ❌ 不会将 API Key 发送到非提供商地址
- ❌ 不会上传会话内容到 Skill 作者的服务器
配置建议：
# 只在你信任的 LLM 提供商处配置 API Key
export BAILIAN_API_KEY="your-api-key-here" # 阿里云
export DEEPSEEK_API_KEY="xxx" # DeepSeek
export OPENAI_API_KEY="your-api-key-here" # OpenAI
# 不配置 Key 时，自动使用规则模式（无需网络）降级模式： 如果 API 不可用（欠费/网络问题），自动切换到规则匹配模式。
cron 调度
# 每天午夜更新
0 0 * * *
# 每 6 小时更新 (更频繁)
0 */6 * * *
# 每周一上午 9 点周总结
0 9 * * 1内容筛选规则
混合模式筛选流程：
| 类型 | 记录 | 说明 |
|------|------|------|
| 配置变更 | ✅ | TTS 切换、模型配置、频道设置等 |
| 技能安装/发布 | ✅ | 新 Skills、插件、clawhub publish |
| 系统修改 | ✅ | 版本升级、环境变化、修复完成 |
| 定时任务 | ✅ | cron 创建/更新、定期检测 |
| 重要决定 | ✅ | 技术选型、方案切换 |
| 日常闲聊 | ⏭️ | 跳过（LLM 自动识别） |
| 简单问答 | ⏭️ | 跳过（规则预过滤） |
**脱敏保护：**
- ✅ 自动检测 API Key / Token / Secret
- ✅ 识别 sk-, ghp_, clh_, tvly- 等模式
- ⚠️ 检测到敏感信息时添加警告标记
---
## 📁 文件结构
memory-manager/ ├── SKILL.md # 此文件 ├── README.md # 快速入门 ├── LICENSE # MIT 许可证 ├── _meta.json # ClawHub 元数据 ├── install.sh # 安装脚本 ├── templates/ │ └── MEMORY.md.template # MEMORY.md 模板 └── scripts/ ├── init-memory.sh # 初始化脚本 └── update-memory.sh # 智能更新脚本（混合模式）
---
## 🔧 使用示例
### 初始化 MEMORY.md
./scripts/init-memory.sh
生成：MEMORY.md - Roxy 的长期记忆
👤 关于用户
- 称呼：老师
- 时区：Asia/Shanghai
🏠 系统环境
- OpenClaw 版本：2026.4.5
- 主机：Ubuntu
📅 重要事件
- 2026-04-07: 初始创建
📌 待办事项
- [ ] ...
### 手动触发更新
./scripts/update-memory.sh
### 查看更新历史
openclaw cron runs --jobId <MEMORY 更新任务 ID>
---
## 🧩 与其他 Skills 配合
| Skill | 配合方式 |
|-------|----------|
| `edge-tts` | 记录 TTS 配置变更 |
| `tavily-search` | 记录搜索发现 |
| `bqb-sticker` | 记录表情包使用偏好 |
---
## 📊 记忆结构建议
### 必需部分
👤 关于用户 # 用户偏好、称呼、时区
🏠 系统环境 # OpenClaw 版本、主机信息
⚙️ 核心配置 # 模型、TTS、频道配置
📅 重要事件 # 按日期记录的重要变更
📌 待办事项 # 进行中的任务
### 可选部分
💡 项目笔记 # 长期项目进展
🔧 故障记录 # 遇到的问题及解决方案
📚 学习记录 # 新学到的知识/技能
🎯 目标追踪 # 长期目标和进度
---
## ⚠️ 注意事项
1. **隐私保护** - MEMORY.md 可能包含敏感信息，注意文件权限chmod 600 ~/.openclaw/workspace/MEMORY.md
2. **文件大小** - 定期清理过时的待办事项，避免文件过大
3. **备份** - 建议将 MEMORY.md 纳入版本控制或定期备份
4. **会话隔离** - 在共享/群组环境中，注意不要泄露他人隐私
---
## 🔍 故障排查
### MEMORY.md 未自动创建
检查 cron 任务
openclaw cron list
手动运行初始化
./scripts/init-memory.sh
### 更新任务未执行
查看 cron 状态
openclaw cron status
查看任务日志
openclaw cron runs --jobId <任务 ID>
### 内容未更新
检查 memory/ 目录
ls -la ~/.openclaw/workspace/memory/
手动触发更新
./scripts/update-memory.sh
---
## 📚 相关资源
- [OpenClaw Cron 文档](https://docs.openclaw.ai/cron)
- [OpenClaw Sessions 文档](https://docs.openclaw.ai/sessions)
- [记忆管理最佳实践](https://docs.openclaw.ai/best-practices/memory)
---
## 📝 更新日志
- **2026-04-08 (1.0.3)** - 实现智能筛选（混合模式）✨
- 🧠 规则预过滤 + LLM 分析 + 脱敏检测
- 🔍 30+ 关键词模式快速匹配
- 🤖 Qwen 模型提炼重要事件
- 🔐 自动检测 API Key / Token / Secret
- 💰 成本优化：无匹配时跳过 LLM 调用
- **2026-04-08 (1.0.2)** - 修复文档夸大问题
- ⚠️ 明确说明自动更新不做智能筛选
- 删除对不存在文件的引用
- 添加隐私风险提醒
- **2026-04-07 (1.0.0)** - 初始版本
- MEMORY.md 模板
- 每日更新 cron 配置
- 安装脚本
---
## 📄 许可证
MIT License - 详见 [LICENSE](LICENSE) 文件
_作者：Roxy (洛琪希) 🐾_
_灵感来源：与老师的深夜对话_