智能体记忆库:持久化语义 AI 记忆 - Openclaw Skills

作者:互联网

2026-03-26

AI教程

什么是 智能体记忆库?

智能体记忆库是一款专门设计的实用工具,旨在为 AI 智能体提供长期、持久的记忆层。通过弥补无状态智能体交互与长期上下文保留之间的鸿沟,Openclaw Skills 注册表中的这一项允许智能体存储用户偏好、任务结果和跨智能体见解。与临时记忆缓冲区不同,该技能使用 SQLite 确保数据在重启后依然存在,使其成为复杂的、跨会话自主工作流的重要组成部分。

该技能利用 Jaccard 相似度实现语义搜索功能,允许智能体根据上下文而非仅仅是精确关键词检索相关信息。通过内置的 TTL(生存时间)支持,它通过自然衰减陈旧信息来确保智能体的知识库保持最新,防止数据库膨胀并维持高性能的检索速度。

下载入口:https://github.com/openclaw/skills/tree/main/skills/kgnvsk/agent-memory-store

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install agent-memory-store

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 agent-memory-store。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Install

智能体记忆库 应用场景

  • 在多个智能体对话中持久化用户偏好,以提供个性化的用户体验。
  • 通过统一的记忆库共享语义见解,实现跨智能体协作。
  • 在需要系统重启或智能体重新初始化的长时间运行任务期间保留关键上下文。
  • 利用 TTL 衰减对临时操作数据进行自动数据生命周期管理。
智能体记忆库 工作原理
  1. 该技能初始化一个本地 SQLite 数据库,作为所有智能体记忆的持久化存储引擎。
  2. 智能体通过 RESTful API 与存储库交互,提交包含内容、所有权和过期参数的 JSON 负载。
  3. 系统对记忆进行索引并应用语义搜索逻辑,以方便根据智能体查询检索相关数据。
  4. 后台进程管理 TTL 衰减,确保移除或存档过期的记忆,以保持搜索索引的优化。
  5. 智能体可以检索自己的私有记忆,或访问 Openclaw Skills 环境中其他智能体的共享公共记忆。

智能体记忆库 配置指南

要将此技能集成到您的工作流中,请通过 hub 安装:

clawhub install agent-memory-store

使用以下命令启动记忆服务:

python3 scripts/memory_store.py

服务将在 8768 端口运行,并自动在 /root/.openclaw/workspace/data/agent_memory.db 创建数据库。

智能体记忆库 数据架构与分类体系

智能体记忆库在结构化 SQLite 架构中组织数据。主要的记忆对象包含以下字段:

属性 类型 描述
owner 字符串 创建记忆的智能体的唯一 ID。
content 字符串 正在以语义化方式存储的实际文本或数据。
ttl_seconds 整数 记忆被视为过期前的持续秒数。
public 布尔值 控制可见性;如果为 true,其他智能体可以搜索此记忆。
tags 数组 用于分类和过滤的可选元数据。
name: agent-memory-store
version: 1.2.0
description: Shared semantic memory store for AI agents. Store, search, and retrieve memories across agents with TTL decay. SQLite persistence — survives restarts.
author: bro-agent
homepage: https://kgnvsk.github.io/paylock

Agent Memory Store

Cross-agent semantic memory with TTL decay. SQLite-backed — data survives restarts.

Start

python3 scripts/memory_store.py
# Runs on port 8768, DB: /root/.openclaw/workspace/data/agent_memory.db

Quick Start

# Store a memory
curl -X POST http://localhost:8768/memories r
  -H "Content-Type: application/json" r
  -d '{"owner":"my-agent","content":"user prefers SOL payments","ttl_seconds":86400,"public":false}'

# Search memories
curl "http://localhost:8768/memories?q=payment+preferences&agent=my-agent"

# List all (with agent filter)
curl "http://localhost:8768/memories?agent=my-agent&limit=20"

Endpoints

Method Path Description
GET /health status + memory count
POST /memories store memory {owner, content, tags?, ttl_seconds?, public?}
GET /memories?q=query&agent=X&limit=10 semantic search (Jaccard)
GET /memories/:id get by ID
POST /memories/:id/delete delete

Changelog

v1.1.0

  • SQLite persistence (data survives restarts)
  • Thread-safe writes
  • DB stored at /root/.openclaw/workspace/data/agent_memory.db

v1.0.0

  • Initial release: in-memory store, TTL, cross-agent sharing, Jaccard search

Install

clawhub install agent-memory-store