hermes agent响应变慢、技能异常或记忆陈旧时,需清理多层缓存:一、清空向量库与bm25索引;二、删除超期日志及快照;三、清除技能字节码缓存;四、重置camofox浏览器会话;五、运行hermes cache clean --force全量清理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您使用 Hermes Agent 时发现响应变慢、技能执行异常或记忆检索结果陈旧,可能是由于缓存文件堆积或索引失效所致。Hermes 的缓存机制包含多层结构:向量数据库索引、BM25 关键词缓存、近期会话快照以及临时技能编译产物。以下是清理这些缓存的多种方法:
一、清空本地向量与BM25混合检索缓存
Hermes 使用本地向量库(如 Chroma 或 LanceDB)配合 BM25 索引实现毫秒级记忆检索,缓存文件默认位于 ~/.hermes/memory/ 目录下。该目录中 index/ 子目录存储实时向量索引,bm25_cache/ 存储分词与倒排表。直接删除这些内容可强制重建索引。
1、打开终端,进入 Hermes 缓存根目录:
cd ~/.hermes/memory/
2、备份当前索引(可选,防止误删):
tar -czf memory_index_backup_$(date +%s).tar.gz index/ bm25_cache/
3、删除索引与缓存文件:
rm -rf index/ bm25_cache/
4、重启 Hermes Agent 或执行以下命令触发重建:
hermes memory rebuild
二、重置每日日志快照缓存
每日日志(daily logs)以时间戳命名,存放于 ~/.hermes/logs/,用于构建短期上下文摘要和学习循环触发判断。若存在大量碎片化小文件或过期日志,会影响定时提醒模块的扫描效率。
1、列出最近7天以外的日志文件:
find ~/.hermes/logs -name "*.log" -mtime +7
2、确认无关键会话后,批量删除超期日志:
find ~/.hermes/logs -name "*.log" -mtime +7 -delete
3、清空当日快照缓存(不影响原始 MEMORY.md):
rm -f ~/.hermes/logs/today_snapshot.pkl
三、清除已编译技能的运行时缓存
Hermes 在执行 skills 时会将 YAML 定义动态编译为 Python 字节码并缓存至 ~/.hermes/.skills_cache/。当 skill 文件被修改但缓存未更新时,可能导致行为不一致。
1、进入技能缓存目录:
cd ~/.hermes/.skills_cache/
2、删除全部缓存字节码文件:
find . -name "*.pyc" -delete && find . -name "__pycache__" -type d -exec rm -rf {} +
3、同步刷新技能注册表:
hermes skill list --refresh
四、重置浏览器自动化会话缓存(Camofox)
当配置了 Camofox 防爬浏览器后,Hermes 会在 ~/.hermes/camofox/profiles/ 下保存多个隔离用户配置文件及 Cookie 缓存。长期运行易积累无效会话、过期 token 和渲染中间产物。
1、停止正在运行的 Hermes 进程:
pkill -f "hermes.*chat\|hermes.*setup"
2、清除全部 Camofox 用户数据:
rm -rf ~/.hermes/camofox/profiles/*
3、保留 Camofox 可执行文件但清空其缓存目录:
rm -rf ~/.hermes/camofox/cache/
4、重新启动 Hermes 并执行一次网页任务以重建干净会话:
hermes chat "打开 https://example.com"
五、执行全量缓存清理脚本(官方推荐)
Hermes 内置一键清理命令,自动识别并清除所有层级缓存,同时跳过受保护的核心配置与 MEMORY.md 文件,确保安全性与可恢复性。
1、在终端中运行全量清理指令:
hermes cache clean --force
2、确认清理范围(终端将显示拟删除路径列表):
Proceed? [y/N] y
3、等待完成提示:
Clean completed. Rebuilt 0 skills, reindexed 12 memory chunks.











