毓惶博客

本文是 Hermes Agent 教学系列 第 02 篇。上一篇讲了它是什么,这一篇动手装。带你走完从「空机器」到「第一次跟 agent 说上话」。

安装前必读:你的环境能不能跑?

Hermes 支持:

✅ Linux(任何主流发行版,官方在 Ubuntu 上测的最多)

✅ macOS(Intel 和 Apple Silicon 都可以)

✅ Windows + WSL2(Ubuntu 发行版,在 WSL 里跑)

✅ Android via Termux(手机上也能跑,但装的是裁剪过的 termux 版)

❌ Windows 原生(不支持,必须走 WSL2)

如果你与我一样在 Windows 上用 WSL2 + Ubuntu,那下面的所有命令都在 WSL 的 Ubuntu 终端里执行,不是 PowerShell 也不是 cmd。

预检查清单

官方安装脚本会自动装 Python 3.11、uv、依赖,不需要 sudo。但你需要保证:

curl 可用(几乎所有发行版默认都有)

git 可用

网络能访问 GitHub 和 PyPI(国内用户请提前准备代理)

快速验证:

两者均输出版本号,就可以继续了。

一行命令安装

这行脚本会做三件事:

检测平台,安装 uv(Python 包管理器)

clone Hermes 仓库到 ~/.hermes-agent

在隔离环境中装好 Python 3.11 + 所有依赖

常见坑 1:脚本拉到一半超时。默认从 GitHub raw 拉,国内不走代理会卡。解决方式:

常见坑 2:Termux 用户请阅读 Termux 专门文档,安装路径是 [termux] 子集,跳过了 Android 不兼容的语音依赖。

首次配置:setup wizard

安装完后第一次运行:

会进入交互式向导,问你几个关键问题。我逐个说明:

Q1: Quick setup 还是 Full setup?

选 Quick setup。除非你是老手,不然 Full 里面一堆细节会让你越设越乱。Quick 之后随时可以重跑 hermes config。

Q2: 选哪个 Provider?

这是上手阶段最关键的选择。我的建议:

完全新手:选 Nous Portal。一块乾净,官方提供,OAuth 点一下就好,有赠送额度可以试。

想选模型自由:选 OpenRouter。一张 API key 能用几十个模型,后续想换 Claude/GPT/Gemini 随时切。

要本地跑、不想花钱:选 Ollama。需要提前在本机装好 Ollama 并拉一个模型(推荐 qwen3.6 或 kimi-k2.5:cloud),显存最低 24GB。

已有 Anthropic / OpenAI key:选 Custom endpoint。

不确定就先选 Nous Portal,不满意随时能换。

Q3: 选哪个模型?

这个跳出来的选项取决于上一步。几个原则:

能力优先:选你能肩得起的最强模型(Claude Opus / GPT 顶配 / Kimi K2.5)

成本敏感:选中等模型(Sonnet / GPT mini / DeepSeek)作为主力,必要时手动升级

全本地:Ollama 里拉 qwen3.6 或同等体量的 reasoning model,不要选 7B 以下的小模型——agent 任务需要工具调用能力,小模型控制不了

Q4: 接不接消息平台?

第一次安装建议选 Skip。先打通 CLI,确认 agent 能正常运行,下一篇专门讲接入消息平台。

验证安装是否成功

配置结束后,运行:

能看到交互式提示符(类似 hermes> 或 ASCII 带动画的欢迎界面),就说明装好了。试着输入:

agent 会调用模型,返回介绍。如果这里报错,几乎总是三个原因:

错误	原因	解决
`Connection refused` / `endpoint unreachable`	provider 地址不通	检查网络/代理,Ollama 需确认本地 11434 端口在跑
`Authentication failed`	API key 错	重跑 `hermes setup` 重输
`Model not found`	模型名拼错或 provider 不提供	在 provider 控制台查准确名称,或贴 model selector 给出的名字

几个一定要知道的路径

Hermes 装完后,几个重要路径你应该记住:

~/.hermes-agent/ —— 代码本体

~/.hermes/ —— 配置、记忆、skills 都在这里(备份就备份这个就够了)

~/.hermes/config.toml —— 主配置文件

~/.hermes/memory.db —— SQLite 记忆库

~/.hermes/skills/ —— 自动生成和你手动添加的 skills

迁移到新机器?把 ~/.hermes/ 打包拷走就行。

从 OpenClaw 迁过来?

如果你之前用过 OpenClaw,Hermes 提供了自动迁移:

setup wizard 会自动检测 ~/.openclaw 并问你要不要迁,跳过了后面随时可以手动跑。

安装脚本讲完了。下一步?

现在你手里有一个能跑但还什么都不会的 agent。下一篇我们进入 CLI 交互:

常用命令(如何重启会话、查看历史、切换模型)

它内置的 40+ 工具预览

跟它跑通一个真正有用的端到端任务(比如「去 GitHub 拉一个仓库,用 README 给我生成中文介绍」)

上下篇导航:

← 01 | 它是什么,凭什么值得装

→ 03 | 基础使用:CLI 交互与第一个任务(即将发布)

本系列文章持续更新,下篇见。

Menu