← 返回 Skills 市场
has9800

Raven Memory

作者 H.A · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
100
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install raven-memory
功能描述
Persistent causal memory for AI agents. Raven records everything your agent does as a causally-linked chain, including decisions, tool calls, parallel work,...
安全使用建议
What to consider before installing: - Trust & provenance: the registry metadata lacked a homepage/source; pyproject points to a GitHub repo. Verify the package source (PyPI vs repository) and review the repo/maintainer before pip installing. - Prompt modification risk: the skill asks you to change your agent's system prompt so it always calls the memory tool at session start. That is required for persistent memory but also broadens the skill's influence. Only add these instructions if you trust the code. - Data & privacy: Raven stores all recorded events in a local SQLite file (~/.raven/raven.db) which can contain sensitive user messages and tool outputs. If you have secrets or private data, restrict file permissions, consider disk encryption/SQLCipher, or avoid enabling semantic embeddings which may cache richer content. - Network/native components: semantic search uses sentence-transformers and sqlite-vec. SentenceTransformer will likely download model weights (network) and torch is a heavy native dependency. Be prepared for large downloads and native binaries; if you want to avoid network/model downloads, skip the 'vec' feature. - Dependency mismatch: requirements.txt lists many heavy/unreferenced packages. Prefer installing from a verified source and review the package's pyproject/requirements to avoid unexpected installs. - Testing: run the MCP server in an isolated environment first, and inspect the created DB contents. Review code (mcp_server, store, dag) yourself — no obvious exfil endpoints appear in the provided files, but embeddings/model downloads and loading a SQLite extension are actions with extra risk. - If unsure: install and test in a disposable VM/container, or request the upstream repository URL and a maintainer identity before enabling in production.
能力评估
Purpose & Capability
Name/description match the code: this is a local SQLite-backed causal memory (DAG) with optional semantic search/embeddings. Embedding-related deps (sentence-transformers, sqlite-vec) are consistent with the semantic-search feature. Minor mismatch: requirements.txt lists many extra heavy packages (torch, transformers, langgraph, datasets, etc.) beyond the pyproject's declared dependency, which is broader than the visible code needs and increases installation footprint.
Instruction Scope
SKILL.md explicitly instructs you to modify the agent system prompt (call raven_start_session at the start and inject returned summary). That is expected for a memory plugin, but the pre-scan flagged a system-prompt-override pattern — altering the system prompt is a powerful action that increases attack surface and can be abused if the skill (or its inputs) were malicious. The runtime instructions otherwise stay within the memory scope (record/search/end/rollback) and do not ask the agent to read unrelated files or credentials.
Install Mechanism
No install spec in the registry (instruction-only), but the package contains pyproject.toml and a console script entrypoint. SKILL.md recommends pip install raven-memory (and optional extras). This will pull heavy native packages (torch, sentence-transformers) and may download model weights from external hosts at runtime (embedder loads SentenceTransformer). Loading sqlite-vec is implemented via sqlite extension loading. These native/networked components are expected for semantic search/embeddings but increase risk compared with a pure-Python or no-install skill.
Credentials
The skill requests no secrets or cloud credentials. Environment variables (RAVEN_DB_PATH, RAVEN_N_RECENT, RAVEN_N_SEARCH) are documented and relate directly to local DB path and tuning. The code writes a local DB (~/.raven/raven.db) and optionally loads native sqlite-vec; no API keys or unrelated credentials are requested.
Persistence & Privilege
The skill persists long-term local data (SQLite DB) and suggests adding itself to agent startup behavior/system prompts so session summaries are auto-injected. It does not set always:true and does not change other skills' configs programmatically. The persistence of potentially sensitive conversation/tool outputs to a shared ~/.raven/raven.db (shared across agents if configured) is a privacy consideration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install raven-memory
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /raven-memory 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Updated OpenClaw system prompt instructions for clarity: now specifies to load summary/nodes into context before responding. - Minor improvements to the description for readability. - No functional or code changes; this version adds PKG-INFO for packaging.
v1.0.0
Raven Memory Version 1.0.0 - Introduces persistent causal memory for AI agents, recording all actions as a causally-linked chain. - Enables recall of relevant history using semantic search and supports rollback, branching, and parallel task tracking. - Stores data locally by default in an encrypted (optional) database. - Provides tools for session management, event recording, semantic search, rollback, and health check. - Designed local-first for privacy and persistence, with easy Python and skill installation.
元数据
Slug raven-memory
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Raven Memory 是什么?

Persistent causal memory for AI agents. Raven records everything your agent does as a causally-linked chain, including decisions, tool calls, parallel work,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 100 次。

如何安装 Raven Memory?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install raven-memory」即可一键安装,无需额外配置。

Raven Memory 是免费的吗?

是的,Raven Memory 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Raven Memory 支持哪些平台?

Raven Memory 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Raven Memory?

由 H.A(@has9800)开发并维护,当前版本 v1.0.1。

💬 留言讨论