agent-memory

Agent Memory（命令行为 memctl）是一款面向 AI 智能体的记忆管理命令行工具，用于组织、搜索和维护记忆文件。

用途 该工具帮助 AI 智能体管理其记忆文件，提供列出、搜索、统计、检查缺失、创建文件以及 AI 摘要等能力，便于日常维护与周期性回顾。

安装 可通过 npm 全局安装：

npm install -g agent-memory

或克隆并构建：

git clone https://github.com/molty-assistant/agent-memory.git cd agent-memory && npm install && npm run build

主要能力与命令

• 列出记忆文件： memctl list # 列出全部 memctl ls --recent 5 # 显示最近的文件
• 跨文件搜索： memctl search "query" # 查找提及内容 memctl s "project" --context 3 # 带上下文行
• 摘要统计： memctl summary # 最近 7 天统计 memctl sum --days 30 # 最近 30 天
• 检查缺失： memctl gaps # 检查 30 天内缺失的每日条目 memctl gaps --days 7 # 检查最近一周
• 创建当天文件： memctl touch # 若不存在则创建 YYYY-MM-DD.md
• AI 驱动的摘要（需要 Gemini API 密钥）： export GEMINI_API_KEY=your_key memctl digest # 最近 7 天的 AI 摘要 memctl ai --days 3 # 最近 3 天 memctl digest -o out.md # 保存到文件

配置 记忆目录会自动查找，顺序为：

• $MEMORY_DIR 环境变量
• 当前目录下的 ./memory
• ~/.openclaw/workspace/memory

使用方式与适用场景

• 每日检查： memctl gaps --days 7 && memctl touch
• 每周回顾： memctl digest --days 7 -o weekly-digest.md
• 查找上下文： memctl search "project name"

集成 可添加到 HEARTBEAT.md 中：

Memory Maintenance

• memctl gaps to check for missing entries
• memctl touch to create today's file
• memctl digest for weekly AI summary

限制 AI 摘要功能需要 Gemini API 密钥；其余命令的具体行为、输出格式及平台兼容性等细节暂未提供。