Hermes Agent 终端集成指南
通过重定向 OpenAI 的 API 端点与密钥，将 Nous Research 自主编码代理 Hermes 的请求路由至 tflow 网关。
什么是 Hermes Agent？
Hermes Agent 是由 Nous Research 开发的开源、终端原生自主编码与任务代理。它具备持久化记忆、自主构建技能库以及支持 21+ 社交平台通道（包括 Telegram、Discord、Slack 等）的消息网关。
Hermes 支持在本地、Docker、SSH、Daytona、Modal 以及 Vercel Sandbox 环境中运行，并且能与多种 LLM 提供商协同工作。配置 tflow 后，您可以通过单张 API 密钥直接桥接网关的所有大语言模型。
环境配置 (Setup)
将 Hermes 与 tflow 结合使用的最简便配置方式如下：
推荐：使用交互式模型选择器 (Use the Interactive Model Selector)
这是最容易配置 Hermes 与 tflow 对接的方法。请在终端执行：
在弹出的提供商列表中选择 OpenAI，然后输入您的 tflow 访问密钥，并选择您首选的模型即可。此方法推荐新用户使用。
快速启动 (CLI 快捷命令) (Quick Start)
如果您已经拥有了 tflow 密钥，可以通过 CLI 指令直接覆盖 OpenAI 默认端点和密钥：
hermes config set OPENAI_API_KEY "sk-your-key" hermes config set OPENAI_BASE_URL "https://tflow.ai-links.com"
随后启动对话，模型即可自动路由至 tflow 网关：
hermes chat --provider openai --model "deepseek-v4-pro"
手动配置 (Manual Configuration)
Step 1: 获取您的 tflow 密钥
- 登录您的控制台面板并进入 API Keys 模块。
- 创建并拷贝您的访问密钥（以
sk-开头）。
Step 2: 配置 API 密钥与端点
在本地隐藏目录下的 ~/.hermes/.env 文件中写入 API 密钥与重定向网关地址：
# ~/.hermes/.env OPENAI_API_KEY="sk-your-key" OPENAI_BASE_URL="https://tflow.ai-links.com"
Step 3: 配置模型提供商
在模型配置文件 ~/.hermes/config.yaml 中，指定提供商为 openai 并设定默认模型：
# ~/.hermes/config.yaml openai: api_key: "sk-your-key" base_url: "https://tflow.ai-links.com"
Step 4: 启动 Hermes
配置保存后，直接在终端启动：
用量与审计监控 (Monitoring)
您通过 Hermes Agent 发送的请求用量（如 Token 消耗量、请求频次及响应延迟）会统计在您的 tflow 账户中。您可以登录控制台看板获取实时状态分析：
- 进入控制台的用量分析与凭据统计面板。
- 检索对应的密钥或 Token ID，查看调用频次及 Token 消耗。
- 查看具体的上游响应延迟明细与计费情况。
常见问题与诊断
切换底层模型后，出现报错或不可控崩溃
这是因为 Hermes Agent 内部拥有一个微型的操作行为缓存数据库。在从高级大语言模型切换到低级轻量模型（或者反之）时，其生成的技能和行为上下文可能会导致指令溢出或崩溃。如果遇到类似问题，建议清空当前项目生成的本地缓存文件夹 .hermes_cache/ 后重新运行。
提示 API Key 未定义
请确保您的 `.env` 文件路径是 ~/.hermes/.env。请注意，外层文件夹是一个隐藏目录，而文件名也是以点开头。如果位置有误，Hermes 将无法读取 API 密钥。