如何快速搭建Memory OS：10分钟本地部署Hermes Agent持久化内存系统

如何快速搭建Memory OS：10分钟本地部署Hermes Agent持久化内存系统

【免费下载链接】memory-osA 7-layer memory operating system for Hermes Agent — persistent memory with Qdrant, structured facts, fabric recall, auto-curated wiki, and surgical context injection. Runs locally, any LLM provider.项目地址: https://gitcode.com/gh_mirrors/me/memory-os

Memory OS是一个为Hermes Agent设计的7层内存操作系统，提供持久化内存功能，包括Qdrant向量存储、结构化事实管理、智能召回、自动整理知识库以及精准上下文注入。它可以在本地运行，并支持任何LLM提供商，让你的AI助手拥有长期记忆和高效信息管理能力。

图：Memory OS系统架构展示，融合了海马（记忆象征）和赫尔墨斯（Hermes）元素，体现持久化内存与智能代理的核心功能

为什么选择Memory OS？

Memory OS为Hermes Agent带来了革命性的持久化内存能力，让AI助手能够：

• 记住过去的对话和决策（Icarus Fabric）
• 高效搜索你的文档库（Qdrant向量数据库）
• 交叉引用你提到的事实（fact_store）
• 自动整理和优化知识库内容

准备工作：所需环境与工具

在开始部署前，请确保你的系统满足以下要求：

• Hermes Agent 0.14.0+
• Python 3.11+
• Docker 24.0+
• 16 GB RAM（推荐，最低8 GB）
• OpenRouter API密钥（仅当使用OpenRouter作为嵌入后端时需要，本地Ollama/vLLM/llama.cpp无需密钥）

一键安装：最快部署方法

Memory OS提供了便捷的一键安装脚本，只需在终端中运行以下命令：

curl -sSL https://raw.githubusercontent.com/ClaudioDrews/memory-os/main/setup.sh | bash

这个脚本会自动安装所有组件：Docker堆栈（Redis + Qdrant + Worker）、Icarus插件、SQLite数据库、wiki库和环境变量。脚本是幂等的，可以安全地重复运行。

手动安装：分步指南

如果你需要更多控制权，可以按照以下步骤手动安装Memory OS：

1. 克隆代码仓库

首先，克隆Memory OS的代码仓库到本地：

git clone https://gitcode.com/gh_mirrors/me/memory-os cd memory-os

2. 安装Icarus插件

将Icarus插件复制到Hermes的插件目录：

cp -r icarus/ ~/.hermes/plugins/icarus/

3. 设置数据库

安装Python依赖并创建必要的数据库：

pip install -r requirements.txt python setup/setup_db.py

这将创建两个SQLite数据库：state.db（会话历史、 lineage、反思预算）和memory_store.db（事实、实体、内存库）。

4. 配置Docker服务

进入docker目录并创建环境变量文件：

cd docker cat > .env << EOF OPENROUTER_API_KEY=sk-or-... REDIS_PASSWORD=$(openssl rand -hex 16) EMBEDDING_DIMS=4096 COLLECTION_NAME=knowledge_base LOG_LEVEL=INFO EOF

启动Docker服务堆栈：

docker compose up -d

5. 配置环境变量

编辑Hermes配置文件~/.hermes/.env，添加必要的环境变量：

FABRIC_DIR=/home/your-user/vault/fabric OPENROUTER_API_KEY=sk-or-... ICARUS_EXTRACTION_MAX_TOKENS=4096 ICARUS_EXTRACTION_MODEL=deepseek/deepseek-v4-flash EMBEDDING_DIMS=4096

6. 启用Icarus插件

编辑~/.hermes/config.yaml，确保Icarus插件已启用：

enabled: - hermes-achievements - icarus

重启Hermes网关使配置生效：

hermes gateway restart

验证安装：确认系统正常运行

安装完成后，验证各组件是否正常工作：

# 检查Docker服务状态 docker compose ps # 检查Qdrant健康状态 curl -s http://localhost:6333/healthz # 检查Redis连接 redis-cli -a "$REDIS_PASSWORD" ping # 验证Icarus插件是否加载 hermes status

在Hermes聊天界面中，你还可以使用以下命令测试功能：

/plugins fabric_brief() qdrant_search("test query") fact_store(action='probe', entity='test')

添加内容：开始使用你的持久化内存系统

创建wiki目录结构并添加你的第一个文档：

mkdir -p ~/vault/wiki/raw echo "# My notes" > ~/vault/wiki/raw/notes.md

Worker会自动检测并索引新文件，使你的内容可以被Hermes Agent检索和使用。

维护脚本：保持系统健康运行

Memory OS提供了一系列维护脚本，帮助你保持系统健康：

你可以使用Hermes的cron功能来安排这些脚本的运行。

常见问题解决

Qdrant集合显示0个点

检查EMBEDDING_DIMS=4096是否与集合模式匹配。不匹配会导致向量被静默拒绝。

Fabric条目被截断

确保.env中设置了ICARUS_EXTRACTION_MAX_TOKENS=4096，并在设置后重启网关。

上下文注入不工作

检查OpenRouter API密钥是否已设置，context_enhancer.py是否可导入，以及修改hooks.py后是否重启了网关。

总结

通过本指南，你已经了解了如何快速搭建Memory OS，为Hermes Agent添加强大的持久化内存能力。无论是使用一键安装脚本还是手动分步部署，你都可以在短短10分钟内拥有一个功能完善的本地内存操作系统。

随着使用时间的推移，Memory OS会不断优化和整理你的知识库，让Hermes Agent变得越来越智能，真正成为你的得力助手。

完整的安装指南和高级配置选项，请参考项目中的setup/install.md文件。系统架构的详细说明可以在layers/目录中找到。

【免费下载链接】memory-osA 7-layer memory operating system for Hermes Agent — persistent memory with Qdrant, structured facts, fabric recall, auto-curated wiki, and surgical context injection. Runs locally, any LLM provider.项目地址: https://gitcode.com/gh_mirrors/me/memory-os