Hermes Agent 入门教学
Hermes Agent 中文教程：从入门对话到消息机器人与定时任务
从一个能核对答案的小任务开始，逐步学会选择模型、在终端对话、连接消息机器人，再让任务按时执行。每一步都有明确的完成标志，方便你判断下一步该做什么。
核对日期：2026 年 9 月 28 日。本文依据 Hermes Agent 上游仓库与官方文档整理；命令示例用于自行安装的环境，具体参数以所装版本的帮助为准。托管实例的功能以仪表盘实际提供的入口为准，练习示例不代表效果或费用承诺。
先认识 Hermes Agent：模型、工具与网关各做什么？
Hermes Agent 是 Nous Research 开发的开源智能体，可以接收任务、调用模型与工具，并通过技能和记忆复用工作方法。模型负责理解与生成，工具让它读取资料或执行操作，消息网关则负责连接聊天平台。它与同名的 Hermes 模型系列是不同项目，入门也不要求只使用 Hermes 系列模型。
这份教程围绕一个学习目标展开：先让助手整理一段文字，再把同样的任务搬到手机聊天中，最后验证一次定时发送。想先了解产品定位，可以读Hermes Agent 是什么；具体能力以官方仓库为参考。
第一步：准备运行环境，完成安装
开始前准备一个运行 Hermes 的环境、一种可用的模型接入方式，以及一段用于练习的普通文本。先学习终端对话时，不必同时配置消息平台和所有工具。
- 按中文安装教程选择与你的操作系统匹配的安装方式，完成依赖与命令路径配置。
- 重新打开终端，运行下方版本和帮助命令，确认能找到 Hermes。
- 运行设置向导，按提示配置模型凭据与基础环境。密钥只填入对应配置入口。
hermes --version
hermes --help
hermes setup完成标志是命令能正常启动，且模型认证已经配置。若提示找不到命令，先回到安装教程检查终端路径；尚未安装成功时，不要继续排查消息机器人。已经使用托管实例的读者，可从实例提供的聊天和模型设置入口开始。
第二步：选好模型，完成第一次中文对话
先选一种自己能访问、预算可控的模型。用同一段材料检查中文表达、是否遗漏事实，以及是否遵守输出格式；需要搜索或执行任务时，再验证工具调用。模型名称相近，也不代表不同供应商的权限、计费和功能完全相同。
# 在系统终端中选择供应商和默认模型
hermes model
# 进入交互式聊天
hermes进入聊天后，输入下面这段练习，不需要联网或读取文件：
请把这段通知整理成三条中文要点，保留时间和负责人，不要补充原文没有的信息：周五下午三点举行项目例会，小林负责演示，小陈负责记录，请各成员提前提交本周进展。
核对回答是否保留“周五下午三点”和两位负责人的分工，再要求它改成一段简短通知。能连续完成这两轮，说明基本对话链路已经打通。若认证或额度报错，先解决供应商连接问题，再继续后续练习。
第三步：掌握少量常用命令
系统终端命令与聊天框里的指令使用位置不同。先记住下面几项即可，更多参数可查中文命令行指南和官方命令参考。
| 输入位置 | 命令 | 用途 |
|---|---|---|
| 系统终端 | hermes | 开始交互式对话 |
| 系统终端 | hermes model | 配置供应商与默认模型 |
| 聊天输入框 | /model | 查看或切换当前会话的模型 |
| 系统终端 | hermes status | 检查认证与平台状态 |
| 系统终端 | hermes doctor | 诊断配置和依赖问题 |
遇到不认识的参数，先查看对应命令的 --help。本机命令管理的是当前运行环境，不会自动控制远端托管实例。需要配置细节时，从中文文档导读进入对应章节。
第四步：连接第一个消息机器人
以 Telegram 私聊为例，先完成一个人的收发测试。按照官方 Telegram 接入说明，在官方账号 @BotFather 中使用 /newbot 创建机器人，获取机器人令牌。
- 在运行 Hermes 的环境中打开消息平台设置向导，选择 Telegram，填写机器人令牌。
- 配置允许访问的用户，或按当前版本完成私聊配对，只授权自己的测试账号。
- 启动网关，在 Telegram 打开机器人私聊并开始对话，然后发送上一节的文字整理练习。
# 配置消息平台
hermes setup gateway
# 前台运行网关，观察启动输出
hermes gateway run这组命令适合尚未运行网关的自建环境；已有服务管理同一实例时，沿用原有服务，不要重复启动。前台进程需要保持运行，长期使用时再按网关管理指南配置后台服务。
完成标志是你的授权账号发出消息后收到正确回复。没有回复时，依次核对令牌、用户授权、网关状态和模型认证。托管用户通过仪表盘提供的渠道连接入口操作，并先确认实例支持该平台。
第五步：创建并验证第一个定时任务
Hermes 的定时任务可以通过自然语言创建。第一次建议在刚刚连通的机器人私聊里安排一个一次性提醒，先验证调度与消息送达，再增加搜索、资料读取等依赖。
请创建一个只执行一次的定时任务：五分钟后，在当前聊天发送“请检查今天的学习笔记”。创建后告诉我任务编号、执行时间和接收位置。
等候期间，在同一 Hermes 环境中查看任务与调度器状态：
hermes cron list
hermes cron status核对任务确实存在、调度器在线，并确认消息在预期时间送达。仅看到聊天中的“已安排”还不足以证明执行成功。没有送达时，先检查网关和执行记录，再核对接收位置，避免反复创建重复任务。
通过一次性测试后，可以练习重复任务：
每天北京时间早上九点，在当前聊天提醒我填写工作计划，并附上这三个问题：今天要完成什么、有什么阻塞、需要谁协助。请确认时区、下次执行时间和接收位置。
定时任务在独立会话中运行，任务说明应包含需要的材料位置与输出要求。电脑休眠、网关停止或模型不可用都会影响结果；在终端创建的任务也不会自动知道要发送到哪个聊天。创建、暂停与删除的详细方式见官方定时任务文档。练习完成后，让助手删除不再需要的任务，并再次核对列表。
什么时候适合使用托管？
如果主要处理本机文件，或者希望学习运行环境的配置，自行安装很适合作为起点。如果消息机器人需要在你关机后继续接收任务，且你不想维护服务器，可以了解Hermes 托管方案，在OpenClaw Launch 仪表盘查看实际支持的模型、渠道与管理功能。
选择前先确认任务需要访问哪些文件和服务、每天执行多少次，以及模型调用与托管各自如何收费。远端实例不会自动获得本机文件或私人网络访问权，上游支持的工具也未必已在托管环境启用。费用拆分可参考Hermes 免费与收费说明。
完成入门后，按任务继续学习
当你已经完成一次中文对话、一次机器人收发和一次定时送达，就可以从实用场景指南选择一个自己的任务。先写清输入材料、期望结果和核对方式，跑通后再考虑保存为可复用的技能。
安装与升级问题看安装专题，参数与服务管理看命令行专题，更完整的功能查文档导读。如果你要学习的是 OpenClaw，可阅读养龙虾教程；本页的命令与步骤专门用于 Hermes Agent。
常见问题
零基础可以照着这份 Hermes Agent 中文教程学习吗？
可以先从一段中文对话开始，不需要先写程序。自行安装时仍需会打开终端、运行命令和配置模型凭据。建议依次验证对话、消息机器人和一次性定时任务，每一步成功后再继续。
Hermes Agent 支持中文吗？需要专门的中文模型吗？
可以用中文提出任务，回复质量取决于所选模型的中文能力和任务要求。先用自己的短文本测试摘要、格式和事实准确性；需要调用工具时，还应验证模型与供应商的工具调用支持。
这份入门教程与安装教程、文档导读有什么区别？
本页按学习顺序串起从首次对话到定时自动化的完整流程。安装教程解决环境与安装问题，命令行指南解释具体命令，文档导读帮助查找官方章节；遇到某一步的细节时，再进入对应专题。
创建定时任务后，可以关闭电脑吗？
如果 Hermes 网关和调度器只在这台电脑上运行，关机或休眠会影响执行。任务需要在运行时间有可用的执行环境；使用在线服务器或托管实例时，本地电脑可以关闭，但仍需确认远端实例和任务状态正常。
学习 Hermes Agent 一定要购买托管服务吗？
不需要。可以自行安装学习；开源软件、模型调用和运行环境是不同的费用项目。希望长期运行消息机器人，又不想自己维护服务器时，再考虑托管，并核对模型费用、渠道支持和套餐限制。