Hermes Agent

Hermes Agent 是由 Nous Research 开发的自主 AI 代理，具备持久记忆、40 多种内置工具、定时任务及多平台消息集成。

快速开始

1. 部署此模板 — 填入 OpenRouter API 密钥（必填），以及可选的 Telegram Bot Token。
2. 访问 API 服务器 — 部署完成后，您的实例会在域名上提供 OpenAI 兼容端点。
3. 使用 API — 使用自动生成的 API 密钥（显示在服务说明中）发送请求：

curl https://YOUR_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "default", "messages": [{"role": "user", "content": "Hello!"}]}'

消息平台

部署时默认设置 Telegram 作为示例。您可以在部署后设置对应的环境变量，启用 14+ 支持平台中的任一个（Discord、Slack、WhatsApp、Signal、Matrix、Email、微信、企业微信、飞书、钉钉、QQ Bot、Mattermost、BlueBubbles/iMessage、SMS、Home Assistant、通用 webhook）。

详见官方 Messaging Gateway 指南。

使用 Zeabur AI Hub（OpenRouter 替代方案）

除了 OpenRouter，也可以使用 Zeabur AI Hub — 一个 OpenAI 兼容的 LLM 聚合服务。部署后：

1. 把 AI Hub 密钥填入 OPENROUTER_API_KEY（沿用同一个变量）。
2. 通过 Zeabur「文件」标签页编辑 /opt/data/config.yaml：
   • model.base_url: "https://sfo1.aihub.zeabur.ai/v1"（Tokyo 用 hnd1）
   • model.default: "claude-sonnet-4-5"（或任一 AI Hub 模型）
3. 重启服务。

注意：OPENROUTER_BASE_URL 环境变量无法覆盖 config.yaml，必须直接编辑该文件。

配置

• LLM 供应商、工具及其他设置 — 请参阅官方 Configuration 指南和环境变量参考。
• 通过 Zeabur「文件」标签页编辑 /opt/data/ 中的配置文件：
  • config.yaml — 模型选择、终端后端、平台设置
  • SOUL.md — 代理人设与系统提示词
  • .env — 所有环境变量
• 编辑后需重启服务以应用更改。

CLI 操作

通过 Zeabur Exec 标签页（或 zeabur service exec）可直接使用 Hermes CLI：

命令	说明
hermes	交互式聊天（REPL）
hermes --tui	现代终端 UI
hermes -z "prompt"	单次查询（适合脚本）
hermes status	查看所有组件状态
hermes model	切换模型／供应商
hermes config	查看或编辑配置
hermes sessions list	列出对话记录
hermes -c	继续上次对话
hermes cron	管理定时任务
hermes skills	浏览与安装技能

执行 hermes --help 查看完整命令列表。

注意事项

• Docker 镜像约 4.5 GB（含 Playwright + Chromium 浏览器自动化工具）。首次部署拉取镜像可能需要数分钟。
• 首次启动需要 30-60 秒来初始化配置文件和同步技能。
• 使用浏览器工具可能导致内存占用过高，若遇到 OOM（内存不足）错误，建议升级至更大的实例（推荐 4 vCPU / 8 GB RAM）。

许可证

Hermes Agent 由 Nous Research 以 MIT 许可证 发布。