本文依据2026-11-11核对的官方文档整理,未做本地安装实测;命令与界面以对应版本为准。本文聚焦 Linux、macOS 和 WSL2 中的终端入门:先完成一次对话,再做一个结果可核对的文本任务。

先准备一个小任务

第一次运行不必同时配置聊天机器人、定时任务和多个 Skills。先准备一个可用的模型服务账号,以及一段不含个人信息的测试文本。本文后面提供虚构会议记录,可以直接用来检查输出。

Hermes 的源码终端安装与桌面软件包是不同的安装路线。以下采用官方终端脚本;如果使用桌面版,应按桌面安装器的说明操作,不把两套步骤混用。

第一步:安装终端版本

在目标机器的终端运行官方命令:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

这条命令会下载并执行安装脚本,执行前可以先打开官方链接阅读内容。所参考的文档将其描述为跟踪 main 分支的源码安装方式;实际安装结果可能随着仓库更新变化,遇到问题时应记录安装时间和采用的安装路线。

官方快速入门明确提示,不使用 pip install hermes-agent 代替受管理的安装流程。

第二步:让当前终端读到安装后的环境

安装完成后,按实际使用的 shell 重新加载配置。Bash 用户使用:

source ~/.bashrc

Zsh 用户使用:

source ~/.zshrc

两条命令按自己的 shell 选择一条,不需要依次执行。也可以按安装器说明打开新终端,再继续配置。

第三步:交互式选择模型服务

运行:

hermes model

按照当前界面选择自己的服务商并完成配置。不要照抄其他账号的密钥或模型名称,也不要因为另一个教程的截图不同就随意修改配置文件。

先用一个服务商跑通,不急着添加故障转移和多模型路由。使用自托管服务时,需要核对自己的 endpoint、模型名称和模型能力;不确定的参数应回到对应服务商及 Hermes 当前版本文档确认。

官方快速入门说明,Hermes 将两类配置分开保存:

文件 用途
~/.hermes/.env 密钥与 token 等敏感配置
~/.hermes/config.yaml 非密钥配置

定位配置问题时,先确认所查的是哪类配置。公开求助只提供字段名、服务商和脱敏后的错误,不上传这两个文件的完整内容。

第四步:启动并完成一次最小对话

运行经典终端界面:

hermes

预期结果:进入 Hermes 的交互界面。先发送一个短任务,不使用私人文件,也不要求写入外部系统。

例如输入:

只根据下面的公开测试文本整理行动清单。
输出字段:行动、负责人、截止日期、依据。
原文没有说明的信息写“待确认”,不要推测。

会议记录:小林负责整理公开产品资料,周五前完成。
小周负责检查参考链接,没有确定完成日期。

预期结果示意,不是本次实际运行记录:

行动 负责人 截止日期 依据
整理公开产品资料 小林 周五前 小林负责整理公开产品资料,周五前完成
检查参考链接 小周 待确认 小周负责检查参考链接,没有确定完成日期

不要把“周五”自行补成一个具体年月日。验收重点是每行都有原文依据、缺失信息没有被编造,而不是回复看起来是否流畅。

检查缺失字段是否被编造

将第一句改成“需要整理公开产品资料”,删掉负责人和时间,再运行同样的整理任务。

预期结果:负责人和截止日期均写“待确认”。如果它补出了具体人名或日期,先收紧任务说明并重新检查结果,暂时不要把这个流程接到自动发送或定时执行。

常见问题与完成标准

如果终端提示找不到 hermes,先确认安装流程已经结束,并按自己使用的 shell 刷新环境或打开新终端;保留安装器的错误信息,不直接重复安装多套版本。

如果能进入界面但没有得到模型回复,回到 hermes model 核对服务商配置,记录所选服务、实际错误与发生时间。只调整已经确认的问题,再做一次短对话检查。

这一轮的完成标准是:终端可以启动、模型能够回复、正常样例可回查依据、缺失字段样例没有被补造。完成这些后,再阅读 Hermes Skills 导读 或 阅读笔记任务,逐步扩展能力。

继续阅读

参考资料与核对日期

资料核对:2026-11-11。以下为对应的官方文档入口;本文为文档整理,未作本地安装实测。