hermes agent本身免费开源，隐形费用源于默认启用的openai、azure等商业api后端；需检查config.yaml中model.provider、禁用语音/图片云回退、切换至ollama或腾讯混元lite等本地/免费替代方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Hermes Agent 过程中发现账户余额异常减少、API 调用配额快速耗尽或收到第三方服务商的账单，则可能是由于本地部署表象下实际调用了隐性收费的云 API。Hermes Agent 本身为 MIT 协议开源项目，不向用户收取任何许可费或平台服务费；但其功能模块（如语音转文字、图片生成、大模型推理）默认支持多后端切换，部分后端需依赖 OpenAI、Azure、Replicate、讯飞星火等商业 API。以下是识别与规避隐形成本的具体操作步骤：
一、确认 Hermes Agent 核心框架是否收费
Hermes Agent 主体代码完全开源且永久免费，采用 MIT 许可协议，允许商用、修改与分发，不设任何授权墙或功能阉割。所有费用均源于外部依赖项，而非 Hermes 自身。其 GitHub 仓库持续公开更新，Star 数已超 6.6 万，无闭源插件或订阅制核心组件。
1、访问官方 GitHub 仓库：https://github.com/NousResearch/hermes-agent
2、查看 LICENSE 文件，确认为 MIT 协议文本
3、执行 git clone https://github.com/NousResearch/hermes-agent.git 验证可完整拉取全部源码
二、排查 config.yaml 中隐性付费 provider
模型推理链路由 config.yaml 中 model.provider 字段控制，若该值为 openai、anthropic、azure、spark、groq（非免费 tier）等，即表示每次对话请求均经由对应云服务商计费接口转发，费用按 token 数、调用次数或时长实时结算，即使未显式配置 API Key，部分 provider 也可能启用带额度限制的试用接口并自动扣费。
1、执行 hermes config list 查看当前生效的 model.provider 与 model.default 值
2、打开 ~/.hermes/config.yaml 文件，检查 model.provider 字段是否为 openai、anthropic、spark、azure 等商业标识
3、若确认为商业 provider，立即执行 hermes config set model.provider ollama 或 hermes config set model.provider llama.cpp 切换至本地免密推理后端
4、运行 hermes config set model.base_url http://localhost:11434/v1（适配 Ollama）或指定本地 GGUF 模型路径，确保请求不再外发
三、禁用语音转文字模块的云回退机制
speech_to_text.py 插件内置多级 fallback：当本地 whisper.cpp 不可用时，会自动尝试 Ollama → Replicate → Azure Speech → OpenAI Whisper API。其中仅 whisper.cpp 和 ollama-embedded 完全离线零成本；其余全部触发外部计费，OpenAI Whisper API 按音频分钟数计费（$0.006/分钟），且无免费额度。
1、执行 hermes tool list | grep speech 确认当前激活的语音工具名称及状态
2、编辑 ~/.hermes/tools/speech_to_text.py，搜索 provider == "openai" 或 "api.openai.com/v1/audio"，定位发起请求的代码段
3、将匹配行注释或替换为 provider = "whisper.cpp" 并保存文件
4、重启 Hermes Agent 使变更生效
四、锁定图片生成模块为本地 Stable Diffusion
image_generation.py 默认启用 Replicate 或 Azure AI Image Generation 等云服务，单次调用费用从 $0.01 至 $0.05 不等。若未手动指定 provider，系统可能静默启用试用额度接口，导致额度耗尽后服务中断或转为计费模式。
1、检查 ~/.hermes/config.yaml 是否存在 image_generation_provider 字段及其值
2、若字段值为 replicate、azure、fal、stability，执行 hermes config set image_generation_provider stable-diffusion
3、确保本地已部署 Stable Diffusion WebUI 并监听 http://127.0.0.1:7860
4、验证调用日志中不再出现 replicate.com/v1/predictions 或类似云服务 URL
五、切换至腾讯混元等国产免费模型替代方案
腾讯混元 Lite 完全免费且兼容 OpenAI API 格式，Hermes 原生支持，无需修改代码即可接入。相较 OpenAI/Gemini 等国际模型，混元 Lite 提供无限制调用、毫秒级响应、中文语义强对齐等优势，适用于日常问答、文档处理、轻量编程等高频场景。
1、登录腾讯云百炼平台，进入“API Key 管理”，创建新 Key 并复制
2、执行 hermes setup，在 provider 选项中选择 tencent-hunyuan
3、填入 API Key 与模型名 hunyuan-lite
4、运行 hermes config list | grep model 确认 model.provider 已更新为 tencent-hunyuan
