Hermes Agent 记忆优化：从 76% 爆满到 17% 的扩容与清理实录

背景

Hermes Agent 有两个持久化记忆存储，在每次对话的开头注入到系统提示里，帮 AI 跨会话保持上下文：

存储类型	默认限制	用途
Memory（个人笔记）	2,200 字符	环境事实、项目约定、工具技巧
User Profile（用户画像）	1,375 字符	用户偏好、身份信息、沟通风格

随着日常使用，记忆条目不可避免地膨胀，很快撞到天花板。

有次顺手看了眼 memory 状态 ——12 条记忆，1,672 / 2,200 字符，76%。

更麻烦的是，里面有大量纯配置类信息：Stalwart 邮箱的 SMTP 参数、Firecrawl 配置、火山引擎 API Key 等等。这些东西本来就在 config.yaml 和 .env 里存着，在 memory 里又放了一份，纯属浪费。

最初的想法是借助外部工具。holographic 是一个号称能「扩展 AI 上下文记忆」的 Python 包。于是装了试试：

1
pip install holographic

结果很惨烈。holographic 版本太老（0.0.1），安装时把 Hermes Agent 0.14.0 的核心依赖全部降级：

Hermes 本身和 firecrawl-py、mcp 等工具全部罢工。立刻 pip uninstall 回滚。

教训：不要往 Hermes 的 venv 里装第三方包，依赖冲突的风险远大于收益。

回滚后换个思路。直接在 Hermes 安装目录里搜：

1
grep -r "memory_char_limit\|2200" /usr/local/lib/hermes-agent/

在 hermes_cli/config.py 找到了默认值：

1
"memory_char_limit": 2200,   # ~800 tokens at 2.75 chars/token

又在 agent/agent_init.py 里确认了 config.yaml 可以覆盖它：

1
memory_char_limit=mem_config.get("memory_char_limit", 2200),

也就是说，根本不需要任何插件 ——memory_char_limit 本身就是 config.yaml 的可配置项，只是很少人知道。

一行命令：

1
hermes config set memory.memory_char_limit 8000
2
hermes config set memory.user_char_limit 4000

配置项	默认值	新值	增幅
`memory_char_limit`	2,200	8,000	3.6x
`user_char_limit`	1,375	4,000	2.9x

扩容后同样的 1,360 字符只占 17%。但空间多了不等于可以乱塞，关键在于清理。

扩容治标，关键还要治本。memory 里不应该存 API Key、端口号、SMTP 参数这类纯配置 —— 它们在 config.yaml / .env 里已经有了。

清理掉三条：

再看一眼前后对比：

1
清理前: 12 条 / 1,672 字符 / 76% 🟡
2
扩容前:  8 条 / 1,360 字符 / 61%（旧限制）
3
扩容后:  8 条 / 1,360 字符 / 17%（新限制）🟢

这次优化沉淀出一个判断标准：

一句话：memory 存的是「事实」和「偏好」，不是「配置」。配置放配置文件。

如果把大量配置类数据塞进 memory，不仅浪费空间，更重要的是 —— 配置改了还得记得同步改 memory，迟早不一致。从根源上分开，才是最省心的做法。