这篇讲 Hermes 机器人从安装到用起来的完整路径:它是什么、适合哪些场景、怎么在服务器上装好、怎么配置模型与消息网关、日常怎么下任务、怎么升级备份,照着做就能跑起来。
Hermes 是什么
Hermes 是一款面向企业和个人的 AI 机器人应用平台,提供自然语言理解、业务流程自动化、智能决策支持、多渠道交互以及运维监控等功能。定位于降低运营成本、提高响应效率,帮助企业快速构建自动化工作流。作用主要包括智能客服、数据分析、流程调度、个性化推荐,覆盖金融、电商、制造、教育等多行业。同类平台还有OpenClaw机器人应用全攻略。使用领域涉及自动化报表、客户订单处理、资源调度、实时监控等场景,适用于需要大规模重复性操作、跨系统数据打通和即时响应的业务场景。

适用场景
Hermes 可用于以下具体场景:
- 企业报表自动生成与分发:通过聚合多源数据并定时输出 PDF / Excel 日报。适合每天需要汇总销售数据、运营指标的中小企业,省去人工整理数据的时间。
- 客服智能问答:接入消息渠道后,可自动响应常见问题,并将复杂问题转交人工客服,能明显减少重复性客服工作量。
- 金融异常监控:实时监控交易异常、风险预警,自动触发告警并推送至管理平台。适用于需要 7×24 小时监控的金融场景。
- 内容生成与分发:根据关键词自动产出新闻稿、社交媒体贴文,并通过自动化渠道发布。适合需要持续输出内容的市场团队。
- 运维巡检与告警:扫描日志、CPU、磁盘等参数,发现异常后立即发送报警信息。与Komari Monitor互补,形成完整的运维监控体系。
安装教程
以下是在Ubuntu 22.04上安装Hermes的完整步骤。如果你还没有自己的服务器,先参考VPS搭建教程。如果你使用的是其他Linux发行版,命令可能略有不同。
更正说明:本文的 Hermes 指 Nous Research 开源的 Hermes Agent(官方仓库:github.com/NousResearch/hermes-agent)。它通过官方安装脚本安装、在终端或接入的消息平台中使用,没有基于 Django 的 Web 管理后台;旧稿中的 Django、Redis、Celery、manage.py 等安装与配置说法与该项目无关,本次精修已按官方仓库与官方文档(hermes-agent.nousresearch.com/docs)的现行方式更正。Hermes 更新较快,涉及命令与界面时请以官方文档为准。
# 1. 一键安装(支持 Linux / macOS / WSL2 等环境,安装脚本会自动处理所需依赖)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# 2. 让当前终端加载最新环境(或重新打开一个终端)
source ~/.bashrc
# 3. 首次配置:运行向导,选择模型提供商并填入 API 密钥
# 向导选项如有变化以官方文档为准,之后可随时用 hermes setup 重新配置
hermes setup
# 4. 启动 Hermes,开始对话
hermes
# 常用辅助命令
hermes --version # 查看当前版本
hermes --help # 查看全部命令
hermes model # 切换默认模型 / 提供商
hermes tools # 管理工具的启用状态
安装完成后:在终端运行 hermes 即可进入交互界面开始使用(首次使用先按 hermes setup 向导完成模型与密钥配置)。也可以通过 hermes gateway 把 Hermes 接入 Telegram、Discord 等消息平台。Hermes 没有需要单独部署的 Web 管理后台,不要再按旧稿的 manage.py runserver 方式启动 8000 端口服务。
基础配置说明
Hermes 的配置主要通过 hermes setup 向导以及 hermes model、hermes tools、hermes gateway 等子命令完成,配置文件、长期记忆和技能保存在 Hermes 主目录(默认 ~/.hermes)中。下表列出配置时最需要注意的事项;具体配置项如有变化,请以官方文档的 Configuration 部分为准,不要再照搬旧稿中其他项目(如 Django)的配置项。
| 配置项 | 说明 | 设置方式 |
|---|---|---|
| 模型提供商的 API 密钥 | 调用模型服务的凭据,属于敏感信息。只应保存在本机 Hermes 的配置中,不要写进文章、截图或公开的代码仓库;不慎泄露时应立即到提供商后台吊销并重新生成 | 通过 hermes setup 向导填入 |
| 默认模型与提供商 | Hermes 支持多家模型提供商,可按需切换;先选定一家并完成其授权流程,之后随时可以更换 | 运行 hermes model 选择 |
| 工具(Tools)启用状态 | 浏览器、代码执行等工具需要单独启用,部分工具还要配置其专用的 API 密钥,否则在对话中调用会失败 | 运行 hermes tools 管理 |
| 消息网关(Gateway) | 把 Hermes 接入 Telegram、Discord、Slack 等消息平台时使用,各平台的令牌与接入配置以官方文档为准 | 运行 hermes gateway setup 配置 |
| 技能(Skills) | 技能保存在 Hermes 主目录的 skills 文件夹中,可从官方技能中心安装,也可按规范放入自建的 SKILL.md | 在对话中使用 /skills 浏览与安装 |
| Hermes 主目录(配置与数据) | 配置、长期记忆、技能与日志都保存在主目录中,备份与迁移时整体处理该目录(见文末的备份部分) | 默认路径 ~/.hermes |
配置安全提示:API 密钥等敏感信息只应保存在本机,不要提交到 Git 仓库,也不要出现在截图或分享的日志中;密钥不慎泄露时,应第一时间到提供商后台吊销并重新生成。
日常使用方法
Hermes 装好后,日常使用主要是在终端里对话,或在接入的消息平台里直接下达任务。下面以“每日业务报表”为例,说明一次完整的任务安排(界面与命令如有变化,以官方文档为准):
- 开始对话:在终端运行 hermes,或打开已接入的消息平台(如 Telegram、Discord),找到你的 Hermes 开始对话。Hermes 没有 Web 管理后台,不需要访问 8000 端口的 /admin 页面。
- 提出任务:直接用自然语言描述要完成的事情,例如“每天早上汇总昨天的销售数据,生成一份日报发给我”。
- 补充任务信息:
- 任务目标:如“每日销售报表”,说清要产出什么
- 数据来源:数据在哪个文件、表格或系统中
- 处理要求:需要统计、计算或整理时,把口径和规则说清楚
- 输出方式:选择消息推送 / 邮件发送 / 文件保存
- 配置执行计划:告诉 Hermes 执行的时间规律即可,它内置了 cron 调度;想手动核对时,可参考下面的 Cron 表达式示例:
- 每天 08:00 执行:0 8 * * *
- 每小时执行一次:
0 * * * * - 每周一 09:00 执行:0 9 * * 1
- 每 5 分钟执行一次:*/5 * * * *
- 确认并试运行:检查 Hermes 复述的任务计划无误后,让它先试运行一次,确认输出符合预期再正式启用。
- 查看结果:在对话记录或任务的运行记录中查看执行结果;失败时根据报错信息调整任务描述或相关配置。
- 设置提醒:可以要求 Hermes 在任务失败时通过已接入的消息平台通知你,确保异常能及时发现。
提示:Cron 表达式的格式为“分 时 日 月 周”。不熟悉 Cron 语法时,可以使用在线工具(如 crontab.guru)辅助生成。

版本升级方法
Hermes 更新较快,新版本通常包含功能更新和安全修复。升级前先备份,再按下面的流程操作(命令如有变化,以官方文档的升级说明为准):
# 1. 备份 Hermes 主目录(包含配置、记忆与技能)
cp -a ~/.hermes ~/.hermes.backup-$(date +%Y%m%d)
# 2. 执行官方升级命令
hermes update
# 3. 升级后确认版本,并重新启动验证
hermes --version
hermes
升级注意事项:
- 升级前务必备份 Hermes 主目录(默认 ~/.hermes,包含配置、记忆与技能)。如果升级后出现异常,可用备份目录恢复。
- 查看新版本的发布说明(Release notes),了解是否有不兼容变更(Breaking Changes)。
- 如果是跨度较大的版本升级,建议先在测试环境验证常用任务无误,再升级正式环境。
- 升级后检查已启用的工具、消息网关、定时任务和常用技能是否正常运行。
常见问题解答
Q1:启动或运行时报错怎么办?
启动或运行报错时,可按以下顺序排查:
- 检查配置与密钥:运行 hermes setup,确认模型提供商和 API 密钥配置正确,这是最常见的问题来源。
- 确认安装完整:在终端运行 hermes,查看它输出的版本号与帮助信息,确认命令可用、安装完整。
- 查看报错信息:直接看终端里 Hermes 输出的完整报错;通过消息平台使用时,先确认网关在运行(hermes gateway status)。
- 检查网络与额度:确认服务器能访问模型提供商的接口,且账户额度充足、密钥权限正常。
- 对照官方文档:仍无法解决时,查阅官方文档的 Troubleshooting 部分,或到官方 GitHub 仓库的 Issues 中检索相同报错。
Q2:定时任务不触发?
自动化任务不执行,通常有以下几个原因:
- 进程未运行:Hermes 的定时任务由其内置 cron 调度驱动,需要 Hermes 或消息网关保持运行;进程退出后任务不会触发。
- 网关未运行:通过消息平台接收结果时,确认网关已启动并保持在线,可用 hermes gateway status 查看状态。
- 表达式错误:检查任务的时间表达或 Cron 表达式是否正确,不确定时把执行时间用自然语言重新向 Hermes 说清。
- 时区问题:确认服务器的系统时区设置正确(中国用户一般为 Asia/Shanghai),时区不对会导致任务在错误的时间执行。
- 任务被暂停:检查该任务是否被暂停或删除,在对话中让 Hermes 列出当前全部定时任务,确认其状态。
Q3:消息平台上收不到回复?
消息平台收不到回复时,按以下步骤排查:
- 核对平台配置:确认该平台的接入凭据(如机器人令牌、应用密钥)填写正确,可用 hermes gateway setup 重新配置。
- 检查网关状态:运行 hermes gateway status 确认网关在线;网关未运行时,平台消息无法送达 Hermes。
- 检查网络连通:确认服务器能正常访问该消息平台的接口,防火墙或代理设置没有拦截出站连接。
- 检查回调与证书:平台要求回调地址必须是 HTTPS 时,确认域名证书有效且未过期,回调路径与平台后台填写的一致。
- 查看日志:查看 Hermes 的运行输出或日志,确认是否收到了平台的请求;收到但处理失败时,日志里通常有具体报错。
Q4:如何添加新的 AI 技能 / 插件?
Hermes 支持通过技能(Skills)扩展功能。添加新技能的步骤:
- 从技能中心安装:在对话中使用 /skills 浏览官方技能中心并安装现成的技能,这是最简单的方式。
- 自建技能:按官方技能规范编写 SKILL.md,放入 Hermes 主目录的 skills 文件夹;具体格式以官方文档的技能部分为准。
- 为新技能配置所需的 API 密钥和环境变量(通过 hermes setup 或按该技能的说明操作)。
- 在对话中引用新技能,先用一个小任务测试功能是否正常。
- 详细的技能开发规范请参考 Hermes 官方文档中的技能(Skills)部分。
Q5:如何进行数据备份和恢复?
定期备份是运维的基本操作。Hermes 的数据备份方法:
- 整体备份主目录:把 Hermes 主目录(默认 ~/.hermes)整体打包备份,其中包含配置、长期记忆、技能与会话数据。
- 重点备份内容:确认主目录中的配置文件与密钥文件已包含在备份里,并把备份存放在与服务器不同的位置。
- 自动备份:建议创建一个定时任务,定期把主目录打包并上传到对象存储(如阿里云 OSS)等异地位置。
- 恢复数据:把备份的主目录还原到相同位置后启动 Hermes,检查配置、记忆与技能是否完整;恢复前建议先备份当前状态。
关注智搭云。如果你需要搭建服务器,可以参考VPS搭建教程。获取更多自建应用与数字化工具教程!

