安全扫描
OpenClaw
安全
high confidence该技能的代码和指令与其声明的目的(本地 SQLite 后端存储)一致,无网络调用或意外的凭据请求,但包中未声明运行时/安装要求(Node/npm 和本地 SQLite 依赖),安装前应确认。
评估建议
该包似乎做了它宣称的事情:一个本地 SQLite 后端存储,带有 TypeScript 实现的向量搜索。安装前确认您有 Node.js 和 C 工具链(better-sqlite3 是本地模块,可能在 npm 安装时编译)。由于注册表条目未声明 Node/npm 或文件系统写入访问权限,请验证运行时环境,并在处理敏感数据时在沙盒中运行。审查或固定依赖版本,并考虑加密或限制默认以明文 JSON 存储在 DB 中的敏感数据。如果需要网络化持久化或大规模向量搜索,计划用 ANN 索引或适当的向量启用 DB 替换内存中的 TS 向量搜索。...详细分析 ▾
ℹ 用途与能力
名称/描述、SKILL.md 和源文件都描述了一个带有嵌入和语义搜索的本地 SQLite 后端内存管理器 — 这是一致的。然而,注册表元数据未声明所需的二进制文件或环境,而包中包括 Node TypeScript 源代码和依赖于 better-sqlite3 的 package.json。实际上,这需要 Node.js 运行时和依赖项安装(better-sqlite3 是一个可能需要 C 工具链的本地模块)。该技能还需要文件系统访问以获取 SQLite DB 路径。这些运行时要求未在注册表中声明,应予以注意。
✓ 指令范围
SKILL.md 保持在范围内:创建一个带有 SQLite 路径的 MemoryManager,CRUD,向量搜索和清理。运行时指令和代码不读取无关系统文件,访问环境变量,或调用外部网络端点。测试仅使用临时目录。无指令请求将数据发送到第三方。
ℹ 安装机制
注册表未列出安装规格,但包中包括源文件和依赖于 better-sqlite3 的 package.json。没有 URL 下载或远程脚本;安装通过 npm(隐式)。该 npm 依赖项可能会调用本地编译(better-sqlite3),需要工具,并可能在受限环境中失败。明确安装规格或声明所需二进制文件(node/npm)的缺乏是一个需要注意的不一致,但不是恶意的。
✓ 凭证需求
该技能不请求任何环境变量、秘密或无关凭据。代码同样不读取环境变量或尝试访问凭据。其数据访问仅限于您提供的 SQLite DB 路径。
✓ 持久化与权限
该技能不请求永久/始终启用的包含,并不会修改其他技能或全局代理设置。它仅将数据持久化到您实例化的 SQLite 数据库(默认:内存,除非您传递文件系统路径)。默认允许自主调用(正常),但这里没有与其他令人担忧的权限结合。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv0.1.02026/3/7
● 无害
安装命令 点击复制
官方npx clawhub@latest install agent-memory-persistence
镜像加速npx clawhub@latest install agent-memory-persistence --registry https://cn.clawhub-mirror.com
技能文档
AI 代理长期记忆持久化
使用此技能时,代理需要跨会话的持久内存存储。
提供的功能
- 基于 SQLite 的文本、元数据和嵌入向量持久化
- 内存项的 CRUD 操作
- 基于余弦相似性的语义检索向量搜索
- 包括过期清理在内的内存生命周期操作
- 支持按用户、会话、类型和时间窗口过滤
项目结构
src/MemoryStore.ts:低级 SQLite 存储引擎src/VectorIndex.ts:存储嵌入的向量相似性搜索src/MemoryManager.ts:代理使用的高级 APIsrc/types.ts:共享 TypeScript 契约
使用模式
- 使用 SQLite 路径创建
MemoryManager。 - 写入包含
content、可选metadata和可选embedding的记忆。 - 通过会话/用户或使用
searchByVector()进行语义查找来查询记忆。 - 定期调用
cleanupExpired()删除过期记忆。
备注
- 嵌入作为 JSON 数组存储在 SQLite 中。
- 向量搜索使用 TypeScript 实现的余弦相似性,以保持部署简单,避免 SQLite 扩展。
- 如果记忆量显著增长,考虑用 ANN 索引或 SQLite 向量扩展替换
VectorIndex,同时保留MemoryManagerAPI。
数据来源:ClawHub ↗ · 中文优化:龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制