ClawHub

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

Data & APIs

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

Install

openclaw skills install memory-manager-secure

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脚本执行✅ 必需
curlHTTP 请求（智能筛选）✅ 必需
jqJSON 解析✅ 必需
python3API 调用和 JSON 处理✅ 必需
openclaw CLIcron 任务配置⚠️ 可选（用于自动配置）

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 名称匹配的环境变量（按优先级）
modelstudioBAILIAN_API_KEY → ALIYUN_API_KEY → DASHSCOPE_API_KEY
vllmVLLM_API_KEY → DEEPSEEK_API_KEY
openaiOPENAI_API_KEY
deepseekDEEPSEEK_API_KEY
anthropicANTHROPIC_API_KEY
googleGOOGLE_API_KEY → GEMINI_API_KEY
azureAZURE_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

📚 相关资源

📝 更新日志

  • 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 (洛琪希) 🐾 灵感来源：与老师的深夜对话

More in Data & APIs