§04装好它：从安装到第一次开口

Install and First Launch, Step by Step

这一节结束时，你的电脑上会有一个能聊、能干活的Hermes。下面的截图都是我在v0.22.2上一屏一屏跑出来的，哪几个默认值最好改掉，走到那一屏时我会说。

选择安装入口

Hermes现在有三种装法，按你习不习惯终端来选。

桌面版第一次打开会跑一段引导对话，问你的名字、主题色、想连哪些app，用的是Nous送的一次性免费试用模型，不需要任何API key。这个我没在这台机器上装（它和我本机已有的旧版Hermes共用一个数据目录，我不想动那边），所以这一节按命令行这条路走。

命令行这条路，官方给的是一行命令：

# macOS / Linux / WSL2 curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash# Windows 原生（PowerShell）iex (irm https://hermes-agent.nousresearch.com/install.ps1)

装完重开一个终端窗口（或者source ~/.zshrc ），敲hermes就能进。

先交代一下我自己是怎么装的。我没有直接跑这一行，因为它会装进我本机那个常用的~/.hermes 。我是把v0.22.2的源码克隆下来，装进一个单独的虚拟环境，再用HERMES_HOME把数据目录指到一个测试文件夹（§23有这条路的写法）。装法不同，但hermes setup往后的每一屏是同一套，下面的截图你照着走不会对不上。

注意

网上很多老教程写的是pip install hermes-agent或者brew install。这两条路官方已经不支持了，

PyPI上的包停在0.19.0，再往后的版本只从安装脚本、Docker和Nix发。拿pip装上去的就是0.19.0，后面章节讲的Kanban看板、/learn这些你都对不上。

脚本会顺手装一整套依赖：Python 3.14、Node、ripgrep、FFmpeg，这些现在归一个叫hermes pm的包管理器管，出了问题跑hermes pm doctor就能看到缺什么。它默认还会装一个无头浏览器（给agent上网用）和一个电脑操控驱动（让agent操作你的桌面）。后一个如果你暂时用不上，安装时加--skip-computer-use就不装了，浏览器那个对应--skip-browser 。

运行安装向导

第一次运行hermes setup （新装的话直接敲hermes也会自动进来），先看到的是这一屏：

全新环境下的hermes setup第一屏，三选一。

Quick Setup走的是Nous自家的Portal，浏览器里点一下授权就完事，模型和工具一次配好。Portal有免费档，付费档是每月20、100、200美元三级（Plus、Super、Ultra）；联网搜索、生图这一整套工具网关归付费档，免费档只给一部分生图模型。如果你本来就打算长期用、又不想自己去各家平台申请key，这条最省心。

Full setup是自己带key。国内读者大概率会走这条，因为你手上可能已经有DeepSeek、通义千问、Kimi、智谱这些平台的key了。我这次就是这么配的。

Blank Slate只开文件、终端和模型三样，别的全关。适合那种「我要先搞清楚它每个能力是干嘛的再一个个打开」的人，或者给公司内部装的场景。

选择模型

选Full setup之后，第一件事是选模型从哪来。这个列表我数了一下，一共40个选项：

国内的几家基本都在。带▸的选项下面还有一层，比如Qwen下面分了Qwen Cloud、阿里云百炼（中国区）、Coding Plan、Token Plan好几种，选错区域key会报错。我手上是阿里云百炼中国区的key，所以选的是「Alibaba Cloud DashScope (China)」，然后把key粘进去，输入的时候屏幕上只显示星号。

接着选默认模型。它会按你选的provider列出可用的模型：

阿里云百炼下的模型列表，qwen3.8-max、qwen3.7-plus、kimi-k2.5、glm-5.2、deepseek-v4-pro、MiniMax-M2.5等都能直接选，也可以手填模型名。我选的是qwen3.7-plus。

我选了qwen3.7-plus，没选最贵的max。原因很简单：agent每一轮都要把一大段系统提示和工具说明发给模型，token消耗比聊天大得多，日常跑用中档模型就够了（具体能烧多少，§07末尾有我这次的账单）。下一屏问推理强度，我保持默认没动。

选择终端后端

选agent在哪执行命令：本机（默认）、Docker/Podman容器、Modal、SSH远程、Daytona、Vercel Sandbox。

这一屏决定agent敲的命令落在哪台机器上。第一次用就选本机，后面§23会讲另外几种什么时候值得换。如果你特别不放心让它在自己电脑上跑命令，选Docker，它的命令就都关在容器里。

跳过聊天平台

下一屏是一长串聊天平台，Telegram、Discord、Slack之外，微信、企业微信、飞书、钉钉、QQ机器人、元宝都在列表里。第一次装先什么都别勾，直接回车跳过。等你在命令行里用顺了，再去§08讲的浏览器面板里接，那边有扫码一键建Telegram机器人这种更省事的入口。

关掉Computer Use

命令行平台默认开启的工具。打勾的有联网搜索、浏览器自动化、终端、文件读写、代码执行、看图、生图、语音、skill、记忆、会话搜索、子agent委派、定时任务，以及靠后的「Computer Use」（通过cua-driver在后台操控桌面）。

注意Computer Use默认是开着的。它的意思是agent可以在后台操控你的桌面应用。能力很强，但对第一次装的人来说有点早。我在这里用空格把它取消了，回车确认。哪天你真需要它，跑hermes setup tools再勾回来就行。

如果你没关浏览器工具，它会接着问用哪家浏览器方案：

浏览器方案的选择：本地无头Chromium（推荐、免费）、Lightpanda、Nous订阅的云浏览器、Camofox、Browser Use、Browserbase、Firecrawl。

选第一个「Local Browser」就好，免费，不用key。

选择是否上报数据

共享指标的说明：只统计计数类数据（活动、出错类别、token总量、功能使用），不传提示词、文件、路径。三个选项：上报给Nous、只在本机收集、不要。默认停在「No thanks」。

默认就是不收集，回车即可。

向导结束页：配置在 ~/.hermes/config.yaml，key在 ~/.hermes/.env，会话、日志、定时任务也都在 ~/.hermes/ 下面。下面列了单独重配某一块的命令。（我是在隔离目录里测的，图里的路径已缩写成 ~。）

所有东西都在 ~/.hermes/ 这一个文件夹里，搬家、备份就拷它。以后想改哪一块不用重走全程，hermes setup model只改模型，hermes setup tools只改工具。

检查被自动收编的key

这一条我没在文档里找到，是翻日志才看到的。

我第一次跑向导的时候，provider那一屏默认停在OpenRouter，还标着「currently active」。可我什么都还没配。后来在日志里看到这么一行：

WARNING agent.credential_pool: Ingested OPENROUTER_API_KEY from environment into the openrouter credential pool — this enables OpenRouter spend.

原因是我的终端环境变量里本来就有一个OPENROUTER_API_KEY （以前别的工具用的），Hermes启动时会自动把环境里能认出来的key收进它的凭证池。它在日志里说得很清楚，这样做「会让OpenRouter开始花钱」。

注意

如果你的 ~/.zshrc 或 ~/.bashrc 里export过OpenRouter、OpenAI、Anthropic这类key，Hermes会自动收

编。这不一定是坏事，但你得知道钱可能从那里走。不想让它用，就在装之前把那行export注释掉，或者装完用hermes auth把对应的凭证删掉。

第一次启动

向导结束，敲hermes ：

启动界面。左边是当前模型（qwen3.7-plus）、工作目录和会话编号，底部汇总「21 tools · 58 skills」。输入框里的灰字是随机的示例提示。标题栏日期是这个版本的构建日期。（测试目录的路径已打码。）

右边那一栏，工具按类列着（浏览器、文件、终端、记忆、委派……），skill按领域列着，苹果备忘录、提醒事项这种macOS专属的也在，还有能调用Claude Code和Codex的skill，后面§15会专门讲它怎么指挥别的agent。

如果你想确认一下配好了没有，另开一个终端跑hermes status ：

hermes status的简版输出：当前模型、provider、网关是否在跑、接了哪些聊天平台、有几个定时任务。加--full看全部。（这张是我做完§07之后补拍的，所以已经有一个定时任务。）

网关这一项现在是「stopped」，这很正常，你还没接任何聊天平台。不过它后面会影响定时任务能不能自己跑起来，§07会碰到。

核心建议

装完先别急着让它干大活，下一节先用三四句话试试它的记忆。