应设置消费上限防止Hermes Agent按量付费账单突增：一、阿里云控制台绑定预付卡并设日消费阈值；二、本地.env配置API熔断机制；三、在DashScope等上游平台设独立额度账户；四、部署代理网关拦截超额请求；五、启用计算巢原生配额策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用Hermes Agent的按量付费模式，但发现账单突增或费用失控，则可能是由于未设置消费上限导致Token调用无约束累积。以下是防止意外扣费的多种设置方法：
一、在阿里云控制台绑定预付卡并设置日消费阈值
通过阿里云成本监控系统对Hermes Agent所依赖的后端服务（如百炼API、ECS实例、OSS存储）实施硬性支出拦截，确保费用触达即止。
1、登录阿里云控制台，进入账号中心，完成实名认证与支付方式绑定。
2、前往成本监控 > 成本预警页面，单击“高额消费预警”区域的“详情”按钮开通功能。
3、在弹出抽屉页中，选择“按量付费产品日消费预警”，输入单日最高可接受金额（建议设为当前月均日消费的120%），并勾选短信、邮件、站内信通知方式。
4、在“产品选择”中仅勾选Hermes Agent实际调用的服务（如dashscope-api、ecs-shared、oss-standard），最多支持10个产品。
二、在Hermes Agent本地配置文件中启用API调用熔断机制
通过修改运行时环境变量，在Agent启动层限制每小时/每日最大Token消耗量，从源头阻断高频请求引发的费用雪崩。
1、打开Hermes Agent项目根目录下的.env文件（路径通常为~/.hermes/.env或项目内.env.local）。
2、添加以下两行环境变量：
MAX_TOKENS_PER_HOUR=50000
MAX_COST_PER_DAY_USD=15.0
3、确认已安装并启用token-limiter插件（若未安装，执行：pip install token-limiter）。
4、重启Hermes Agent服务，使熔断策略生效。
三、在API服务商后台（如DashScope、MiniMax）设置独立额度账户
绕过Hermes Agent自身逻辑，直接在上游模型提供商侧锁定调用权限与资金池，实现跨框架、跨部署形态的统一管控。
1、访问DashScope控制台，进入“API密钥管理 > 额度管理”页面。
2、点击“新建子账户”，填写用途为Hermes-Agent-Prod，并分配独立API Key。
3、在该子账户下设置“日额度上限”，数值需低于主账户预警阈值的80%，形成双重防护。
4、将新生成的API Key填入Hermes Agent的.env文件中DASHSCOPE_API_KEY字段，替换原有密钥。
四、部署轻量级代理网关拦截超额请求
在Hermes Agent与外部API之间插入一层自定义网关，实时统计Token用量并动态拒绝超限调用，适用于多实例、多用户共享同一API Key的场景。
1、克隆开源项目api-gateway-token-guard（GitHub仓库地址：https://github.com/hermes-guard/gateway）。
2、执行docker-compose up -d启动网关容器，监听本地端口8081。
3、修改Hermes Agent配置，将所有模型请求URL由https://dashscope.aliyuncs.com/api/v1替换为http://localhost:8081/v1。
4、编辑网关配置文件config.yaml，设置daily_token_limit: 200000及alert_webhook: https://oapi.dingtalk.com/...。
五、启用阿里云计算巢（ComputeNest）托管版的资源配额策略
若通过阿里云计算巢一键部署Hermes Agent社区版，可直接利用平台原生配额能力，无需手动编码或配置中间件。
1、在计算巢控制台进入已部署的Hermes Agent服务实例详情页。
2、点击左侧菜单“资源配置 > 配额管理”，展开“用量控制”面板。
3、开启“API调用次数限制”开关，并设置每分钟最大请求数为30（对应典型轻量任务负载）。
4、同步开启“费用冻结开关”，当单日账单达到设定值时，自动暂停ECS实例并禁用API网关路由。
