Hermes Agent

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

完整文档请见 hermes-agent.nousresearch.com。

快速开始

1. 绑定域名至 port 8642：前往 Networking > Domain，将 *.zeabur.app 绑定至端口 8642
2. 使用 Base URL https://<your-domain>/v1 和说明面板中的 API Key 连接工具
3. （可选）部署时将 Enable Dashboard 设为 true，再绑定另一个域名至端口 9119。用 admin / 说明面板中的密码登录

端口与域名

此服务提供两个独立的 HTTP 端口，请只为实际需要的端口绑定域名：

端口	用途	何时需要绑定域名
8642	OpenAI 兼容 API 服务器	需要外部 API 访问时
9119	网页 Dashboard（需设置 HERMES_DASHBOARD=true）	仅在需要浏览器界面时

消息平台（Telegram、Discord、Slack 等）使用出站连接，不需要公开 URL 或开放任何端口。

持久化存储

所有数据存储在 /opt/data（持久化卷）：

路径	说明
/opt/data/config.yaml	主配置文件
/opt/data/.env	API 密钥与密码
/opt/data/sessions/	对话历史
/opt/data/memories/	持久化记忆
/opt/data/skills/	Agent 创建的技能
/opt/data/logs/	运行日志

消息平台

部署时默认设置 Telegram 作为示例。您可以在部署后设置对应的环境变量，启用 20+ 支持平台中的任一个。

详见官方 Messaging Gateway 指南。

CLI 操作

通过 Zeabur Exec 标签页可直接使用 Hermes CLI：

命令	说明
hermes	交互式聊天（REPL）
hermes --tui	现代终端 UI
hermes status	查看所有组件状态
hermes config	查看或编辑配置
hermes skills	浏览与安装技能

注意事项

• Docker 镜像约 4.5 GB（含 Playwright + Chromium）。首次部署可能需要数分钟。
• 首次启动需要 30-60 秒来初始化配置文件和同步技能。
• 建议：2+ vCPU / 4+ GB RAM 以使用浏览器工具。