cat-viking-memory（猫维京记忆）

Viking 记忆系统技能

功能

• 五级记忆层级自动管理（L0→L4）
• 重要记忆保护（永不降级）
• 向量相似度提及检测（动态重要性）
• 飞书群聊会话自动保存（需飞书插件）
• 跨 Agent 共享（global workspace）
• 自动降级与遗忘算法（LLM 压缩）

使用方式

1. 安装技能

确保以下文件已复制到你的技能目录：

cat-viking-memory/
├── config.json
├── SKILL.md
├── memory-pipeline/     # CLI 主入口和脚本
├── simple-viking/       # 向量搜索
└── references/          # 文档
    ├── README.md        # 详细使用说明
    └── 飞书集成说明.md

2. 基本配置

编辑 config.json 中的配置：

{
  "memory_workspace": "~/.openclaw/viking-{agent}",
  "auto_save_enabled": true,
  "feishu_integration": {
    "enabled": false
  }
}

3. 定时任务（推荐）

每天凌晨 3 点自动执行记忆降级：

# crontab -e
0 3 * * ~/.openclaw/workspace/agents/maozhuli/cat-viking-memory/memory-pipeline/memory-tier-cron.sh

4. 飞书自动保存（可选）

如需飞书群聊会话自动保存：

1. 确保 feishu 插件已安装并启用
2. 修改 config.json：

   "feishu_integration": {
     "enabled": true,
     "check_interval_ms": 300000,
     "timeout_ms": 1800000
   }

1. 在 feishu 插件配置中启用 SessionManager
2. 参考 references/飞书集成说明.md 详细步骤

5. 常用命令

# 加载记忆上下文
memory-pipeline mp_autoload

# 保存记忆
memory-pipeline mp_global "任务完成说明"

# 搜索记忆
sv_find "关键词"

# 手动触发降级（测试）
memory-pipeline/memory-tier-cron.sh

相关文档

• 详细使用说明：references/README.md
• 飞书集成指南：references/飞书集成说明.md
• 记忆文件格式：见 references/README.md 的"记忆文件格式"章节

技术架构

存储流程：
输入 → Ontology映射 → Viking存储 → 向量索引 → 检索

层级管理：
L0(0-1天) → L1(2-7天) → L2(8-30天) → L3(30-90天) → L4(90天+)

自动保存：
会话结束 → memory-session-hook.sh → mp_global → 存储

飞书集成：
FeishuSessionManager → 检测超时 → 触发 Hook → 保存

注意事项

• 存储规范：必须使用 memory-pipeline 命令存取，不要直接操作文件
• 重要记忆：使用 --important 标记永不忘记的关键信息
• 定期检查：建议每周检查 crontab 是否正常执行
• 权限：确保脚本有执行权限 chmod +x memory-pipeline/*.sh

版本历史

• v1.0.0 - 初始版本

- 五级记忆层级完整实现 - 飞书会话自动保存集成 - 向量搜索与语义检索 - 自动降级与遗忘算法

*基于 OpenViking 思想设计，专为 OpenClaw Agents 打造*