核心记忆文件

Hermes 使用三个核心 Markdown 文件来管理记忆:

SOUL.md — 代理身份

定义代理的人格、行为准则和核心身份。这是代理的"灵魂",决定了它如何与世界交互。

markdown
# SOUL.md 示例

## 身份
你是 Hermes,一个由 Nous Research 开发的 AI 助手。

## 性格特征
- 友好且专业
- 善于分析问题
- 乐于帮助用户

## 行为准则
- 始终使用中文回答
- 在不确定时主动提问确认
- 提供详细且准确的回答

MEMORY.md — 代理笔记

代理的跨会话工作笔记,最大 2200 个字符。代理可以自主读写此文件来记住重要信息。

容量限制:MEMORY.md 最大 2200 个字符。当超出限制时,代理会自动压缩或替换旧内容。建议保存最关键的信息。

USER.md — 用户档案

关于用户的持久化档案信息,最大 1375 个字符。包括用户的偏好、背景和需求。

markdown
# USER.md 示例

## 基本信息
- 名称:用户
- 语言:中文
- 时区:Asia/Shanghai

## 偏好
- 喜欢简洁的回答
- 偏好使用 Python
- 对 AI 安全感兴趣

## 背景
- 软件工程师
- 有 5 年开发经验

记忆管理命令

命令说明
/memory read读取当前记忆内容
/memory write <text>写入新记忆
/memory append <text>追加记忆
/memory clear清除所有记忆
/memory search <query>搜索记忆内容

外部记忆提供商

除了内置文件记忆外,Hermes 还支持 8 种外部记忆服务提供商:

提供商说明
Honcho轻量级用户状态管理服务
OpenViking开源知识图谱记忆系统
Mem0AI 原生记忆层,智能记忆管理
Hindsight基于向量数据库的记忆检索
Holographic全息记忆系统,多维记忆存储
RetainDB持久化对话记忆数据库
ByteRover分布式记忆存储服务
Supermemory云端个人知识库服务

配置外部记忆提供商

config.yaml 中配置外部记忆:

yaml
memory:
  # 使用外部记忆提供商
  provider: mem0

  # Mem0 配置
  mem0:
    api_key: ${MEM0_API_KEY}
    user_id: default-user

  # 或者使用 Honcho
  # provider: honcho
  # honcho:
  #   api_key: ${HONCHO_API_KEY}

记忆工作原理

🗒

自动保存

代理在对话过程中自动识别重要信息并保存到记忆中。

🔍

智能检索

在每次对话开始时,自动检索相关记忆作为上下文。

📄

跨会话持久

记忆在会话之间持久保存,关闭后重新打开仍然可用。

🔧

多层存储

内置文件记忆 + 可选外部提供商,灵活选择存储方案。

💡

你可以直接告诉 Hermes 需要记住什么信息,例如"记住我喜欢用 Python 编程",代理会自动将其保存到记忆中。