MEMORY.md Manager - 长期记忆管理 (安全版)

自动创建并每日智能筛选更新 MEMORY.md 长期记忆文件，支持敏感信息脱敏和多服务商 API 安全调用。

Security Scan

Skill 的声明、安装脚本和运行时指令在功能上相互一致：它会在本地读取 OpenClaw 配置与可选的环境变量来调用用户配置的 LLM 提供商，未发现与其“记忆管理”目标不相称的权限或隐藏远端下载。

Purpose & Capability

Skill 名称/描述（自动创建并按规则+LLM 更新 MEMORY.md）与脚本行为一致：创建/更新本地文件、读取 ~/.openclaw/openclaw.json 以确定 provider 与 baseUrl、并（可选）使用环境变量中的 API Key 调用外部 LLM。所需工具（bash、curl、jq、python3）与任务匹配。

Instruction Scope

运行时会读取 ~/.openclaw/openclaw.json、检查 memory/ 下的会话文件并（在配置了 API Key 且检测到匹配内容时）把匹配的会话片段发送到用户配置的 provider API。此行为与描述一致，但会将会话内容和（通过 Authorization header）用户的 API Key 发往该 provider 的 baseUrl ——这有隐私/泄露风险，需确保 provider/baseUrl 为可信源。脚本也会在日志中显示被部分掩码的 API Key（前/后若干字符）。

Install Mechanism

无远程下载或不受信任的 URL；install.sh 在本地生成脚本并提示用户确认。没有 extract/download 行为，写入仅限于用户的 OpenClaw workspace 下的目录，风险较低。

Credentials

没有要求必须的环境变量（registry 列为 none），但在启用智能筛选时会优先读取常见 LLM API Key 环境变量（OPENAI_API_KEY、DEEPSEEK_API_KEY 等），这与功能需求一致。值得注意：若用户在环境中设置这些密钥，脚本会使用并以 Authorization: Bearer 形式发送到从 openclaw.json 得到的 API URL；仅在规则模式（未配置 key）下不会进行网络调用。

Persistence & Privilege

skill 并未设置 always:true，也不会在安装脚本中强行创建 cron 任务——setup-cron.sh 仅打印创建命令并提示用户确认，install.sh 也要求交互确认。技能不会修改其他 skills 的配置。

Assessment

总体上这是一个自洽的本地记忆管理脚本包，但在安装前请注意：1) openclaw.json 中的 provider.baseUrl 决定了脚本将数据发往何处，确保该 URL 和 provider 是你信任的（恶意或错误的 baseUrl 会把会话内容和你的 API Key 发送到不期望的主机）；2) 若不希望任何会话被发送到外部 LLM，可不在环境中设置任何 API Key（脚本会降级到本地规则模式）；3) 脚本会在控制台输出部分掩码的 API Key（仅前后几字符），如果控制台日志对他人可见，这会暴露部分密钥信息；4) MEMORY.md 可能含敏感信息，遵循建议将其文件权限设为 600 并仅为受信任用户可读；5) 安装时注意交互提示（cron 创建需要你手动同意/运行命令），并在首次运行前查看 scripts/update-memory.sh 的行为以确认符合你的隐私策略。

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

内容筛选规则

混合模式筛选流程：

规则预过滤 → LLM 分析 → 脱敏检测 → 更新 MEMORY.md

类型	记录	说明
配置变更	✅	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 文档
• OpenClaw Sessions 文档
• 记忆管理最佳实践

---

📝 更新日志

• 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 文件

作者：Roxy (洛琪希) 🐾 灵感来源：与老师的深夜对话