Raven Memory
Raven gives your OpenClaw agent persistent causal memory that
survives across sessions, days, and weeks.
What it does
- - Records every significant event as a node in a causal chain
- Loads relevant history at session start via semantic search
- Supports rollback, branching, and parallel task tracking
- Stores everything locally in ~/.raven/raven.db
- Encrypted at rest with SQLCipher (optional)
Tools exposed
- -
raven_start_session — load context at conversation start - INLINECODE1 — write an event to the chain
- INLINECODE2 — close session with notes
- INLINECODE3 — semantic search over full history
- INLINECODE4 — undo N steps
- INLINECODE5 — health check
Setup
Install from PyPI:
CODEBLOCK0
With semantic search (recommended):
CODEBLOCK1
Then install this skill:
CODEBLOCK2
Add to your OpenClaw system prompt:
CODEBLOCK3
技能名称: raven-memory
详细描述:
Raven Memory
Raven 为你的 OpenClaw 智能体提供跨会话、跨天、跨周的持久因果记忆。
功能说明
- - 将每个重要事件记录为因果链中的一个节点
- 在会话开始时通过语义搜索加载相关历史记录
- 支持回滚、分支和并行任务追踪
- 所有数据本地存储在 ~/.raven/raven.db
- 可选使用 SQLCipher 进行静态加密
暴露的工具
- - ravenstartsession — 在对话开始时加载上下文
- ravenrecordevent — 将事件写入因果链
- ravenendsession — 附带备注结束会话
- ravensearch — 对全部历史进行语义搜索
- ravenrollback — 撤销 N 步操作
- ravengetstatus — 健康检查
安装
从 PyPI 安装：
bash
pip install raven-memory
启用语义搜索（推荐）：
bash
pip install raven-memory[vec]
然后安装此技能：
bash
clawhub install raven-memory
添加到你的 OpenClaw 系统提示词中：
在每次对话开始时，使用用户的第一条消息作为 searchquery 调用 ravenstartsession。在回复前将返回的摘要/节点加载到你的上下文中。使用 ravenrecordevent 记录事件。使用 ravenend_session 结束会话。
