AgentOS内存——给Claude代码一个永久内存
Claude Code在会话之间会忘记一切。这解决了这个问题。
AgentOS Memory是一个MCP(模型上下文协议)服务器,它为Claude Code提供持久、可搜索的内存——在每个会话、每个项目中,永远如此。它在本地运行,将所有内容存储在SQLite中,不需要任何外部服务。```bash
curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/install.sh | bash
______________________________________________________________________
## 为什么?
每次启动Claude Code会话时,您都是从零开始的。你重新解释你的堆栈。重新描述你的偏好。重新讲述你三周前做出的决定。今天是土拨鼠日,但对于你的人工智能助手来说。
AgentOS内存为Claude Code提供了一个实际的内存。存储事实。稍后搜索它们。导入您的ChatGPT历史记录。它在会话、项目甚至机器之间持续存在(如果同步SQLite文件)。
______________________________________________________________________
## 特性
- 🧠 **持久内存** --在所有Claude Code会话中存储事实、决策和上下文
- 🔍 **全文搜索** -SQLite FTS5在没有矢量数据库或API的情况下为您提供快速、相关的结果
- 📔 **会话日志** --日志对话转向;再也不会因为压缩而失去上下文
- 🕸️ **知识图谱** --店铺结构化主题→谓语→客观事实
- 📥 **导入您的历史记录** --从ChatGPT导出、Claude文件或任何标记中引入内存
- ⚡ **零依赖** --仅限SQLite。没有Postgres,没有Redis,没有API密钥,没有云
- 🔌 **独立工作或与AgentOS配合使用** --单独使用,或作为完整AgentOS网格的一部分使用
- 🏃 **即时安装** --一个 `curl | bash`,适用于macOS和Linux
______________________________________________________________________
## 安装```bash
curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/install.sh | bash
安装程序:
- 检查
bun(如果缺少,则安装) - 将服务器下载到
~/.agentos-memory/ - 跑
bun install - 在Claude Code注册为用户级MCP服务器
安装后,启动任何Claude Code会话,工具就会自动可用。
手动安装 (如果你愿意的话):```bash
git clone https://github.com/joemc1470/agentos-memory.git ~/.agentos-memory
cd ~/.agentos-memory && bun install
claude mcp add -e AGENTOS_MODE=standalone -s user agentos-memory -- bun ~/.agentos-memory/src/index.ts
______________________________________________________________________
## 快速开始
安装后,打开Claude Code并尝试:```
Use memory_add to remember: I prefer TypeScript over Python, always use strict mode
结束会话。打开一个新的:```
Use memory_search to find my language preferences
每次克劳德都会找到的。
______________________________________________________________________
## 建筑```
Claude Code Session
│
│ MCP (stdio)
▼
┌──────────────────────────────────┐
│ AgentOS Memory Server │
│ ┌────────────┐ ┌─────────────┐ │
│ │ 11 Tools │ │ Config │ │
│ └────────────┘ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────┐ │
│ │ Standalone Mode │ │
│ │ SQLite + FTS5 │ │
│ │ ~/.agentos-memory/data/ │ │
│ │ ├── memories.db │ │
│ │ │ ├── memories (FTS5) │ │
│ │ │ ├── journal (FTS5) │ │
│ │ │ └── facts (FTS5) │ │
│ └────────────────────────────┘ │
│ OR │
│ ┌────────────────────────────┐ │
│ │ Full AgentOS Mode │ │
│ │ Mem0 + Qdrant + KG │ │
│ │ 3-tier memory search │ │
│ │ Context Engine │ │
│ └────────────────────────────┘ │
└──────────────────────────────────┘
工具参考
🧠 记忆
| 工具 | 说明 |
|---|---|
memory_search |
在存储的记忆中进行全文搜索。返回评分结果。 |
memory_add |
持久地存储一个事实、偏好或决定。 |
用途:```
memory_add: "The production database is PostgreSQL 15 on AWS RDS, us-east-1"
memory_search: "production database"
→ returns the fact above in future sessions
### 📔 期刊
|工具|说明|
|------|-------------|
| `journal_entry` |记录与参与者、主题和情绪的对话。 |
| `journal_search` |按主题或关键字搜索过去的日记条目。 |
日记是你谈话的保险。当LCM压缩你的上下文时,期刊就拥有了一切。
### 🏛️ 记忆宫殿
|工具|说明|
|------|-------------|
| `palace_auto_file` |文件结构化知识——架构决策、系统事实、人员信息、里程碑。 |
### 🕸️ 知识图谱
|工具|说明|
|------|-------------|
| `kg_add_fact` |添加a `subject → predicate → object` 事实上。可在独立模式下通过FTS5进行搜索。 |
**例子:**```
kg_add_fact: subject="alice", predicate="prefers", object="dark mode always"
kg_add_fact: subject="project-x", predicate="uses", object="React + TypeScript"
🔭 上下文引擎
| 工具 | 说明 |
|---|---|
context_startup |
获取启动上下文摘要(独立内存统计数据,AgentOS模式下的完整上下文)。 |
context_task |
搜索与特定任务相关的记忆。 |
context_conversation |
搜索与当前主题相关的记忆。 |
🔧 系统
| 工具 | 说明 |
|---|---|
agent_status |
运行状况检查--在独立模式下显示内存计数,在完全模式下显示服务状态。 |
📥 导入
| 工具 | 说明 |
|---|---|
memory_import |
从ChatGPT、Claude、markdown文件或纯文本导入内存。 |
导入您的记忆
来自ChatGPT
- 转到ChatGPT→ 设置→ 数据控制→ 导出数据
- 下载并解压缩导出
- 在克劳德代码中:```
Use memory_import with source="chatgpt" and file_path="/path/to/conversations.json"
每一次对话都变成了可搜索的记忆。
### 来自克劳德记忆文件```
Use memory_import with source="claude" and file_path="default"
读取 ~/.claude/memory/*.md --每个标题/部分都成为记忆。
从任何Markdown文件```
Use memory_import with source="markdown" and file_path="/path/to/notes.md"
按标题拆分。每个部分=一个内存。
### 从纯文本```
Use memory_import with source="text" and file_path="/path/to/notes.txt"
用双换行符分隔。每段=一段记忆。
配置
通过环境变量设置(in .mcp.json 或传递给安装程序):
| 变量 | 默认值 | 描述 |
|---|---|---|
AGENTOS_MODE |
full |
standalone 仅适用于SQLite, full 对于AgentOS |
AGENTOS_URL |
http://localhost:8092 |
AgentOS API终结点(仅限完全模式) |
AGENTOS_TOKEN |
(空) | 身份验证令牌(仅限完整模式) |
AGENTOS_USER_ID |
user |
内存命名空间的用户ID |
MEM0_PRIMARY_URL |
http://localhost:8766 |
Mem0主(仅全模式) |
MEM0_BACKUP_URL |
http://localhost:8767 |
Mem0备份(仅限完整模式) |
LOCAL_CACHE_URL |
http://localhost:8768 |
本地语义缓存(仅限完整模式) |
KG_URL |
http://localhost:8092 |
知识图(仅全模式) |
更改您的用户ID (对团队有用):```bash
claude mcp add \
-e AGENTOS_MODE=standalone \
-e AGENTOS_USER_ID=yourname \
-s user agentos-memory \
-- bun ~/.agentos-memory/src/index.ts
______________________________________________________________________
## 独立与全代理操作系统
### 独立模式(`AGENTOS_MODE=standalone`)
适用于 **零外部服务**.所有存储在 `~/.agentos-memory/data/memories.db`.
- ✅ 没有API密钥
- ✅ 无需互联网
- ✅ 适用于任何有面包的机器
- ✅ SQLite FTS5全文搜索
- ✅ 所有11个工具都工作
- ⚠️ 搜索基于关键字(无语义/矢量搜索)
- ⚠️ 无多代理同步
### 完全代理操作系统模式(`AGENTOS_MODE=full`)
需要跑步 AgentOS 安装。
- ✅ 三层内存搜索(本地缓存→ Mem0主→ 备份)
- ✅ 通过Qdrant进行矢量/语义搜索
- ✅ 全上下文引擎(启动数据包、任务上下文)
- ✅ 知识图(Chloe KG节点)
- ✅ 跨网格的多代理内存同步
- ✅ 带有自动分类功能的记忆宫
- ⚠️ 需要在本地运行AgentOS
______________________________________________________________________
## 数据位置```
~/.agentos-memory/
├── src/ ← MCP server source
├── data/
│ └── memories.db ← Your memory database (back this up!)
└── node_modules/
备份你的记忆:```bash
cp ~/.agentos-memory/data/memories.db ~/memories-backup-$(date +%Y%m%d).db
**跨机器同步:**```bash
# Any file sync that handles SQLite will work:
rsync -av ~/.agentos-memory/data/memories.db user@other-machine:~/.agentos-memory/data/
手动测试
验证服务器在没有Claude Code的情况下是否正常工作:```bash
List all tools
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
| AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null \
| jq '.result.tools[].name'
Add a memory
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"memory_add","arguments":{"text":"test memory"}}}' \
| AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null
Check status
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"agent_status","arguments":{}}}' \
| AGENTOS_MODE=standalone bun ~/.agentos-memory/src/index.ts 2>/dev/null | jq .
______________________________________________________________________
## 卸载```bash
curl -fsSL https://raw.githubusercontent.com/joemc1470/agentos-memory/main/uninstall.sh | bash
或手动:```bash
claude mcp remove agentos-memory -s user
rm -rf ~/.agentos-memory
______________________________________________________________________
## 路线图
- \[ \] **托管层** --云同步+语义搜索,无需运行自己的基础设施
- \[ \] **Web用户界面** --浏览和管理您的回忆 `localhost:8765`
- \[ \] **CLAUDE.md自动注入** --自动将相关内存注入会话上下文
- \[ \] **向量搜索** --通过以下方式进行可选的本地嵌入 `llama.cpp` 或 `Ollama`
- \[ \] **记忆衰退** --自动过期陈旧记忆,增强频繁访问的记忆
- \[ \] **团队同步** --跨Claude Code实例共享内存命名空间
______________________________________________________________________
## 贡献
欢迎在 github/joemc1470/agentos-memory.```bash
# Dev setup
git clone https://github.com/joemc1470/agentos-memory.git
cd agentos-memory
bun install
# Test the server
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
| AGENTOS_MODE=standalone bun src/index.ts 2>/dev/null | jq .
堆栈: TypeScript+Bun+SQLite(Bun:SQLite)+MCP SDK
许可证
麻省理工学院——随心所欲。
部分 AgentOS 项目——一个持久的、多代理的人工智能基础设施层。