项目档案插件 / 扩展

hermes-agent 自定义插件集合 | 23个增强插件实现AI代理自主运行与成本管控

本文档介绍 hermes-agent 的 23 个自定义增强插件，覆盖自主决策、可观测、成本管控、安全防护等核心能力，包含插件分类、安装步骤、配置方法与使用说明，助力快速扩展 hermes-agent 能力边界。

515PythonStar 于 2026年9月18日2026年9月19日更新

AI 总结

这是为 hermes-agent 开发的 23 个自定义插件集合，补充多模型决策、智能路由、成本管控、全链路可观测等核心能力，助力 AI 代理实现自主稳定、低成本运行。

中文项目介绍

本项目是专为 hermes-agent 设计的自定义插件集合，共包含 23 个独立插件，覆盖自主决策、可观测遥测、质量安全、学习记忆、通信集成五大能力方向，采用 MIT 协议开源，遵循 hermes-agent 官方插件规范，可快速集成到现有部署中。 hermes-agent 原生功能在复杂生产场景下存在多模型决策、成本管控、安全防护、跨代理通信等能力缺口，本插件集通过自主决策引擎、多模型辩论、智能任务路由、预算预警、全链路遥测、自学习记忆等模块补全上述能力，解决 AI 代理自主运行稳定性不足、成本不可控、自我优化能力弱的核心问题。本插件集适用于需要部署自主管理 AI 代理、多代理协作、生产环境成本管控等场景，大部分插件无需额外配置即可使用默认能力，部分插件支持通过环境变量或配置文件自定义参数，也可对接 Qdrant、Ollama 等外部服务扩展能力。

详细信息与使用说明

1. 项目定位与用途

本项目是专为 hermes-agent 设计的自定义插件集合，共包含 23 个独立插件，覆盖自主决策、可观测遥测、质量安全、学习记忆、通信集成五大能力方向，旨在扩展 hermes-agent 原生功能边界，支撑 AI 代理实现自主化、可观测、低成本、可进化的稳定运行。所有插件遵循 hermes-agent 官方插件规范，采用 MIT 协议开源，可快速集成到现有 hermes-agent 部署中，无需修改核心代码即可扩展代理能力。

2. 解决的核心问题

hermes-agent 原生能力在复杂生产场景下存在明显缺口：缺乏自主决策与多模型协同能力，难以应对复杂任务判断；无原生成本管控机制，容易产生超额支出；可观测性不足，无法全链路追踪代理行为与错误；安全防护能力薄弱，易受提示注入等攻击影响；无自学习记忆机制，无法基于历史交互持续优化。本插件集针对性补全上述能力，解决 AI 代理自主运行、成本可控、安全稳定、自我进化的核心痛点。

3. 适用场景

本插件集适用于以下场景：1. 需要部署具备自主目标管理、自我反思优化能力的 AI 代理，实现无人值守长期运行；2. 多 AI 代理协作场景，需要跨代理通信、任务智能委派与结果评分；3. 生产环境部署 AI 代理，需要预算管控、超支预警与全链路可观测能力；4. 对安全性要求较高的场景，需要提示注入筛查、代码沙箱执行、幻觉检测等防护能力；5. 需要 AI 代理基于历史交互持续学习、积累领域知识的长期运行场景。

4. 安装方式

本插件集遵循 hermes-agent 官方插件部署规范，安装步骤为：1. 克隆仓库到本地：执行 git clone https://github.com/42-evey/hermes-plugins.git；2. 复制插件文件：将仓库内所有 evey-* 开头的文件夹复制到 ~/.hermes/plugins/ 目录；3. 复制共享工具文件：将仓库根目录的 evey_utils.py 复制到 ~/.hermes/plugins/ 目录；4. 重启 hermes-agent 即可自动加载所有插件。仓库中未明确给出依赖校验、版本兼容性等额外安装说明。

5. 使用方式

大部分插件无需额外配置即可使用默认能力，部分插件支持自定义配置：1. evey-autonomy 插件可通过环境变量 HERMES_AUTONOMY_CONFIG 指定配置文件路径，或通过 HERMES_OPERATOR_NAME、HERMES_TIMEZONE、HERMES_AUTONOMY_HEAVY_MODEL 等环境变量覆盖配置项，也可通过配置文件设置操作员名称、时区、模型选择、追踪项目等参数；2. evey-rag 插件需提前部署 Qdrant 向量数据库、Ollama 服务并拉取 snowflake-arctic-embed2 嵌入模型，初始化知识库集合后即可使用语义搜索能力；3. 其余插件的自定义配置能力仓库中未明确给出说明。

6. 补充说明与实现特点

1. 共享工具 evey_utils.py 提供了带指数退避的 LLM 调用重试逻辑、HTTP 请求辅助函数，供所有插件复用；2. 插件栈采用免费模型方案，通过 LiteLLM 对接 OpenRouter、Ollama、Nous Portal 等免费模型源，可实现 0 美元/天的运行成本；3. 仓库中包含 evey-github、evey-habits、evey-moltbook、evey-news、evey-proactive、evey-verification、evey-wallet、evey-watchdog 等插件，但仓库中未明确给出这些插件的具体功能说明；4. 所有插件均通过 plugin.yaml 声明插件元信息与工具能力，遵循 hermes-agent 插件规范。

思维导图

当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。

常见问题

这个插件集合适配什么版本的 hermes-agent？

仓库中未明确给出版本兼容性说明，仅说明插件遵循 hermes-agent 官方插件规范，建议参考 hermes-agent 官方文档确认版本适配关系。

安装插件后 hermes-agent 无法加载怎么办？

仓库中未明确给出故障排查说明，可检查插件文件夹是否完整复制到 ~/.hermes/plugins/ 目录、evey_utils.py 是否存在、hermes-agent 是否已正确重启，或参考 hermes-agent 官方插件加载规范排查问题。

evey-rag 插件使用需要哪些依赖？

根据仓库说明，evey-rag 插件需要提前部署 Qdrant 向量数据库（默认地址 hermes-qdrant:6333，集合名 evey-knowledge）、Ollama 服务（默认地址 hermes-ollama:11434），并拉取 snowflake-arctic-embed2 嵌入模型，初始化知识库集合后方可使用。

如何控制插件的运行成本？

可使用 evey-cost-guard 插件对接 Langfuse 实现预算管控，支持按日、按任务追踪成本，达到预算的 80% 时发出警告、100% 时触发预警；也可通过 evey-delegate-model 插件的智能路由能力优先选择免费模型降低支出。

插件支持自定义配置吗？

部分插件支持自定义配置，例如 evey-autonomy 插件可通过配置文件或环境变量覆盖操作员名称、时区、模型选择、追踪项目等参数，也可禁用指定信号源；其余插件的自定义配置能力仓库中未明确给出说明。