ascottbell-maasv-memory

基于 maasv 的结构化长期记忆，含三信号检索、知识图谱与实体抽取，完全自托管。

## 概述（中文）

基于 maasv 的结构化长期记忆，含三信号检索、知识图谱与实体抽取，完全自托管。

## 技能正文

# maasv 记忆

面向 OpenClaw 智能体的结构化长期记忆，由 [maasv](https://github.com/ascottbell/maasv) 驱动。

用包含三信号检索（语义 + 关键词 + 知识图谱）、实体抽取、时间版本与经验学习的认知层替换默认记忆后端。

**maasv 完全自托管。** 没有 maasv 云服务。你在自己的机器上运行服务器，所有数据存储在你拥有并控制的本地 SQLite 文件中。不会向 maasv 发送任何数据。

## 安装

本技能需要 `@maasv/openclaw-memory` 插件与运行中的 maasv 服务器。

### 1. 启动服务器

```bash
pip install "maasv[server,anthropic,voyage]"
cp server.env.example .env  # fill in API keys (see below)
maasv-server
```

### 2. 安装插件

```bash
openclaw plugins install @maasv/openclaw-memory
```

### 3. 激活

```json5
// ~/.openclaw/openclaw.json
{
  plugins: {
    slots: { memory: "memory-maasv" },
    entries: {
      "memory-maasv": {
        enabled: true,
        config: {
          serverUrl: "http://127.0.0.1:18790",
          autoRecall: true,
          autoCapture: true,
          enableGraph: true
        }
      }
    }
  }
}
```

## 必需凭证

maasv 服务器需要 LLM 提供商（用于实体抽取）与嵌入提供商（用于语义搜索）。在 `.env` 文件中配置：

| 变量 | 必需 | 用途 |
|----------|----------|---------|
| `MAASV_LLM_PROVIDER` | 是 | `anthropic` 或 `openai` |
| `MAASV_ANTHROPIC_API_KEY` | 使用 Anthropic 时 | 实体抽取的 LLM 调用 |
| `MAASV_OPENAI_API_KEY` | 使用 OpenAI 时 | 实体抽取的 LLM 调用 |
| `MAASV_EMBED_PROVIDER` | 是 | `voyage`、`openai` 或 `ollama` |
| `MAASV_VOYAGE_API_KEY` | 使用 Voyage 时 | 嵌入生成 |
| `MAASV_API_KEY` | 可选 | 用认证保护 maasv 服务器端点 |

**完全本地运行**（无云调用）时，使用 `ollama` 作为嵌入提供商与本地 LLM。maasv 针对通过 Ollama 的 [Qwen3-Embedding-8B](https://ollama.com/library/qwen3-embedding) 优化，内置 Matryoshka 维度截断。本地配置见 [maasv README](https://github.com/ascottbell/maasv)。

## 数据与网络行为

- **maasv 无云服务。** 服务器在你的机器上运行，数据库是你磁盘上的 SQLite 文件。你拥有全部数据。
- **唯一的外部调用是到你自己的 LLM/嵌入提供商**（Anthropic、OpenAI、Voyage）— 使用你自己的 API 密钥，从你的机器发出。若使用 `ollama`，零数据离开你的机器。
- **插件仅与 localhost 通信**（`127.0.0.1:18790`）。不进行外部网络调用。
- **autoCapture** 将对话摘要发送到本地 maasv 服务器进行实体抽取。抽取的实体存储在本地 SQLite 数据库中。
- **autoRecall** 从本地 SQLite 数据库读取并将相关记忆注入智能体上下文。
- **无遥测、无分析、无回传。** maasv 不收集或传输任何数据。

## 你将获得

- **`memory_search`** — 跨记忆库的三信号检索
- **`memory_store`** — 去重感知的记忆存储
- **`memory_forget`** — 永久删除
- **`memory_graph`** — 知识图谱：实体搜索、档案、关系
- **`memory_wisdom`** — 记录推理、记录结果、搜索过往决策

## 链接

- **插件 (npm)：** [@maasv/openclaw-memory](https://www.npmjs.com/package/@maasv/openclaw-memory)
- **服务器 + 核心 (PyPI)：** [maasv](https://pypi.org/project/maasv/)
- **源码：** [github.com/ascottbell/maasv](https://github.com/ascottbell/maasv)