支持五级自动记忆管理和重要记忆保护,集成飞书群聊会话自动保存与向量相似度检索,提升跨 Agent 记忆共享。
# 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` 中的配置:
```json
{
"memory_workspace": "~/.openclaw/viking-{agent}",
"auto_save_enabled": true,
"feishu_integration": {
"enabled": false
}
}
```
### 3. 定时任务(推荐)
每天凌晨 3 点自动执行记忆降级:
```bash
# crontab -e
0 3 * * ~/.openclaw/workspace/agents/maozhuli/cat-viking-memory/memory-pipeline/memory-tier-cron.sh
```
### 4. 飞书自动保存(可选)
如需飞书群聊会话自动保存:
1. 确保 feishu 插件已安装并启用
2. 修改 `config.json`:
```json
"feishu_integration": {
"enabled": true,
"check_interval_ms": 300000,
"timeout_ms": 1800000
}
```
3. 在 feishu 插件配置中启用 SessionManager
4. 参考 `references/飞书集成说明.md` 详细步骤
### 5. 常用命令
```bash
# 加载记忆上下文
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 打造*
don't have the plugin yet? install it then click "run inline in claude" again.