上篇介绍了 Hermes Agent 是什么。 这篇手把手教你装起来。 重点讲 API Token 的配置，用硅基流动做实战演示。
一、先确认环境
安装前，先检查你电脑上有没有这几样东西。
打开终端（Windows 用 PowerShell，Mac 用 Terminal），依次运行：
1. 检查 Python
python --version
看到 Python 3.10.x 或更高版本，就 OK。
如果显示"未找到命令"，需要先装 Python。去 python.org 下载安装包，或用包管理器：
- Windows：
winget install Python.Python.3.13 - Mac：
brew install python
2. 检查 Node.js
node --version
看到 v18.x.x 或更高，OK。
没有的话，去 nodejs.org 下载 LTS 版本。
3. 检查 Git
git --version
有版本号就行。没有的话，去 git-scm.com 下载。
二、一行命令安装
环境确认后，直接运行这条命令：
curl -s https://get.hermes-agent.nousresearch.com | bash
这条命令会自动：
- 下载 Hermes Agent 核心代码
- 安装 Python 和 Node.js 依赖
- 配置基础环境
整个过程大概 2-5 分钟，取决于网速。
Windows 用户注意：
如果你用的是 Windows，建议在 WSL2（Linux 子系统）里运行。原生 Windows 支持还在完善中。
WSL2 安装方法：打开 PowerShell，运行：
wsl --install
重启电脑后，打开"Ubuntu"终端，再运行上面的安装命令。
三、初始化配置：填 API Token
安装完成后，运行初始化向导：
hermes setup
你会看到一系列提示，逐项填写就行。
关键步骤：API Token 配置
当提示 Enter your LLM API key: 时，需要填入你的 Token。
这是最关键的一步。填错了，后面就跑不起来。
四、实战：硅基流动 API Token 配置
下面用硅基流动（SiliconFlow）做演示。其他平台流程类似。
1. 注册账号
打开 siliconflow.cn，注册一个账号。
可以用手机号注册，也可以用微信扫码登录。
2. 获取 API Token
登录后，进入"个人中心" → "API 密钥"。
点击"创建新密钥"，复制生成的 Token。
Token 格式类似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
注意：Token 只显示一次，复制后要保存好。
3. 填入 Hermes
回到终端，在 hermes setup 的提示下，粘贴你的 Token。
接下来会提示你选择模型。硅基流动的常用选项：
Qwen/Qwen2.5-7B-Instruct— 推荐，便宜够用Qwen/Qwen2.5-72B-Instruct— 更强，适合复杂任务meta-llama/Llama-3.1-8B-Instruct— 国际开源模型
选一个你喜欢的。初次体验，选 7B 版本就行。
4. 配置 API 地址
硅基流动的接口地址是：
https://api.siliconflow.cn/v1
当提示 Enter API base URL: 时，填入这个地址。
其他平台的地址：
| 平台 | API 地址 |
|---|---|
| 火山引擎 | ark.cn-beijing.volces.com/api/v3 |
| Groq | api.groq.com/openai/v1 |
| OpenAI | api.openai.com/v1 |
五、启动对话
配置完成后，启动 Hermes：
hermes chat
你会看到一个对话界面。输入你的问题，开始聊天。
试几个简单问题：
你好，介绍一下你自己。
帮我写一个 Python 函数，计算两个数的平均值。
如果回复正常，说明配置成功。
六、常见问题排错
问题1：提示 "API key invalid"
原因：Token 填错了，或者过期了。
解决：
- 回到硅基流动，检查 Token 是否正确
- 如果 Token 被删除了，重新创建一个
问题2：提示 "Connection refused"
原因：网络问题，连不上 API 地址。
解决：
- 检查网络连接
- 如果在国内用 Groq 或 OpenAI，可能需要代理
问题3：模型列表加载不出来
原因：模型名称写错了。
解决：
- 填完整的模型名称，如
Qwen/Qwen2.5-7B-Instruct - 不要只写
Qwen2.5-7B
问题4：Windows 原生安装失败
原因：Windows 支持还在完善。
解决：
- 用 WSL2 安装
- 或等官方完善 Windows 支持
七、后续配置建议
装好后，可以进一步配置：
1. 记忆系统调优
Hermes 会自动记忆对话内容。你可以调整记忆策略：
- 记多少天的对话
- 哪些信息重点记住
- 哪些信息忽略
配置文件在 ~/.hermes/memory_config.yaml。
2. 接入钉钉或飞书
官方文档有详细说明。大致步骤：
- 创建钉钉/飞书机器人
- 配置 Webhook 地址
- 在 Hermes 里填入机器人凭证
3. 安装 MCP 扩展
MCP 是 Hermes 的插件系统。可以接数据库、文件系统、第三方 API。
常用扩展：
hermes-mcp-sqlite— 接 SQLite 数据库hermes-mcp-websearch— 增强网页搜索hermes-mcp-filesystem— 本地文件操作
八、成本估算
用硅基流动的成本很低。
以 Qwen2.5-7B 为例：
- 输入：¥0.001 / 千 tokens
- 输出：¥0.001 / 千 tokens
一天聊 100 条消息，大概消耗 50000 tokens。成本约 ¥0.05。
一个月下来，可能也就几块钱。
比 ChatGPT Plus 的 ¥145/月，便宜很多。
九、我的安装感受
整体安装过程不算复杂。
核心难点在 API Token 配置。只要这一步填对了，后面基本没问题。
WSL2 用户可能要额外装一个 Linux 子系统。但装好后，体验和 Mac/Linux 差不多。
第一次跑起来，建议多聊几句，让 Hermes 开始积累记忆。用几天后，你会发现它越来越懂你。
资源链接
- 硅基流动：siliconflow.cn
- 火山引擎：volcengine.com
- Groq：groq.com
- Hermes 官方文档：hermes-agent.nousresearch.com/docs
下一篇预告：
- 第三篇：《Hermes Agent 核心功能实测：记忆系统 / 联网搜索 / 多模态》
点点赞和关注不迷路，后续还会分享更多 AI 效率工具。
👨💻 H先生出品 | 专注 AI 工具与效率提升
