Hermes Agent 零基础安装教程：从0到AI助手跑起来

2026-06-07 · 小白基础技术分享

你觉得AI助手需要多少钱？OpenAI的ChatGPT Plus每月20美元，Claude Pro每月也是20美元。但今天要说的这个——完全免费，开源，跑在你自己的电脑上，不经过任何人的服务器。

它叫 Hermes Agent，Nous Research出品的开源AI智能体。

想象一个能在你终端里直接干活的AI：写代码、修bug、搜资料、发消息、管理文件——它全都能做，而且它会记住你和你的偏好，越用越懂你。

一句话说清楚它是什么

Hermes Agent = 跑在你电脑里的私人AI助手。你不会把聊天记录发给OpenAI，不会被限流，不用月费。你只需要一个模型API key（很多有免费额度），安装只需要一行命令。

系统要求（所有平台通用）

在开始之前，你只需要准备三样东西：

1. Python 3.11+ — Hermes运行的基础

2. Git — 用于下载代码

3. 一个模型API Key — 推荐 OpenRouter 或 DeepSeek（都有免费额度）

💡 免费API Key获取：去 [openrouter.ai](https://openrouter.ai) 注册，新用户有免费额度；或 [platform.deepseek.com](https://platform.deepseek.com) 注册送500万token。

macOS / Linux 安装（最简单，3分钟）

如果你用的是Mac或Linux（包括Ubuntu、Debian、Fedora等），这是最快的方式。

第1步：打开终端

– Mac: 按 `Cmd+空格`，输入”终端”，回车

– Ubuntu: 按 `Ctrl+Alt+T`

第2步：一行命令安装

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

复制上面这行，粘贴到终端，回车。脚本会自动检测你的系统，安装所需依赖，下载代码。

安装过程大概2-3分钟，你会看到类似这样的输出：

✓ Python 3.11 detected
✓ uv package manager installed
✓ Cloning hermes-agent repository
✓ Creating virtual environment
✓ Installing dependencies
✓ CLI wrapper set up

第3步：初始化配置

hermes setup

运行后会弹出一个交互式配置引导。但是，很多新用户在这一步会卡住——

⚠️ 常见坑：`hermes setup` 的模型选择界面，默认第一个选项是 “Nous Portal”，点它就会弹出浏览器让你OAuth登录。 如果你没有Nous Portal账号，或者不想搞OAuth，这个流程会让你一脸懵。

下面教你三种方法绕过它。

第3.1步：跳过Nous Portal OAuth（重要！）

Hermes支持30+个模型提供商。Nous Portal只是其中之一，排在列表第一位而已，但不是必选项。 你有三种方式绕过它：

方法一：在交互界面里往下翻（最简单）

运行 `hermes setup` 后，当出现提供商选择列表时：

– “Nous Portal” 排在第一位（默认高亮）

– 按键盘 `↓` 方向键，往下翻到 `OpenRouter`、`DeepSeek`、`Anthropic` 等

– 选中后回车，接下来就是传统的API Key输入界面

就像点菜翻菜单一样，第一页不是唯一选择。

方法二：跳过交互，直接用命令行配置（推荐）

完全不用 `hermes setup`，三条命令搞定：

# 1. 设置提供商（以OpenRouter为例）
hermes config set model.provider openrouter

# 2. 把API Key写进 .env 文件
hermes config set OPENROUTER_API_KEY sk-or-v1-你的key

# 3. 设置默认模型
hermes config set model.default deepseek/deepseek-chat

其他常用提供商的配置方式：

# DeepSeek
hermes config set model.provider deepseek
hermes config set DEEPSEEK_API_KEY sk-你的key
hermes config set model.default deepseek/deepseek-chat

# Anthropic（Claude）
hermes config set model.provider anthropic
hermes config set ANTHROPIC_API_KEY sk-ant-你的key
hermes config set model.default anthropic/claude-sonnet-4

# OpenAI
hermes config set model.provider openai-api
hermes config set OPENAI_API_KEY sk-你的key
hermes config set model.default openai/gpt-5

方法三：直接编辑配置文件（高手速通）

打开配置文件：

hermes config edit

在 `config.yaml` 中写入：

model:
  provider: openrouter
  default: deepseek/deepseek-chat

然后创建 `~/.hermes/.env` 文件，填入API Key：

OPENROUTER_API_KEY=sk-or-v1-你的key

💡 免费API Key获取：去 [openrouter.ai](https://openrouter.ai) 注册，新用户有免费额度；或 [platform.deepseek.com](https://platform.deepseek.com) 注册送500万token。

第4步：开始使用

hermes

你会看到一个对话界面，输入问题就能和AI助手对话了：

You: 帮我看看当前目录有什么文件
Hermes: [调用工具 ls] ...

单次提问也可以用：

hermes chat -q "Python怎么写一个HTTP服务器？"

Windows WSL2 安装（推荐Windows用户用这个）

🤔 为什么推荐WSL2而不是原生Windows？

Hermes在WSL2下体验最好，和Linux完全一致。原生Windows也能用（后面会讲），但有些小地方不如WSL2流畅。

第1步：启用WSL2

以管理员身份打开 PowerShell（右键开始菜单 → `终端(管理员)`），输入：

wsl --install

安装完成后重启电脑。

重启后会自动打开一个Ubuntu窗口，设置用户名和密码（记好密码，以后装软件要用）。

第2步：安装Python和Git（WSL里）

在Ubuntu窗口里输入：

# 更新软件源
sudo apt update

# 安装Python和Git
sudo apt install -y python3.11 python3.11-venv git

# 验证安装
python3.11 --version  # 应该显示 Python 3.11.x
git --version          # 应该显示 git version 2.x.x

第3步：安装Hermes

这一步和前面macOS/Linux完全一样：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

然后：

hermes setup    # 配置模型和API Key
hermes          # 开始使用

WSL2常见问题

Q: Hermes在WSL2里退出SSH就停了？

打开Ubuntu，编辑WSL配置：

sudo nano /etc/wsl.conf

加入这两行：

[boot]
systemd=true

保存后（`Ctrl+X` → `Y` → 回车），在PowerShell里重启WSL：

wsl --shutdown
wsl

Windows 原生安装（备选方案）

如果你不想装WSL2，也可以直接在Windows PowerShell里跑。

第1步：安装Python

1. 打开 [python.org/downloads](https://python.org/downloads)

2. 下载 Python 3.11.x 安装包

3. ⚠️ 勾选 “Add Python to PATH”（重要！）

4. 点击 Install Now

验证安装：

python --version

第2步：安装Git

1. 打开 [git-scm.com/download/win](https://git-scm.com/download/win)

2. 下载安装包，一路Next安装

第3步：安装Hermes

打开PowerShell（普通用户，不需要管理员），输入：

curl.exe -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

⚠️ 如果遇到 “bash: command not found”，先装Git Bash（Git安装时附带），然后在Git Bash里运行上面命令。

第4步：配置和运行

hermes setup
hermes

Windows原生常见问题

Q: 按Alt+Enter不能换行？

Windows Terminal会用 `Alt+Enter` 切换全屏。用 `Ctrl+Enter` 代替。

Q: 第一次运行报 “No models provided”？

可能是编辑器保存的 `config.yaml` 带了BOM头。运行 `hermes config edit` 重新保存一下就好了。

安装后快速配置

安装完成后，这几个命令最常用：

# 检查一切是否正常
hermes doctor

# 查看当前配置
hermes config

# 换模型（交互式选择）
hermes model

# 查看有哪些工具可用
hermes tools list

想让它在手机上也能用？

Hermes支持接入Telegram，配置后手机上发消息就能和你的AI助手聊天：

hermes gateway setup   # 选择 telegram
hermes gateway start   # 启动网关

需要提前在Telegram找 `@BotFather` 创建一个Bot，拿到Token。

小结

| 系统 | 安装难度 | 推荐度 | 核心命令 |

|——|:–:|:–:|——|

| Windows WSL2 | ⭐⭐（多一步WSL） | ⭐⭐⭐ | 同上 |

装好之后，你会拥有一个完全属于自己的、免费的、会成长的AI助手。它会随着使用越来越了解你的习惯，而且你的数据永远不会离开你的电脑。

下一步推荐：装好后试试问它 “帮我写一个Python贪吃蛇游戏” 或 “总结一下~/Documents文件夹里的内容”，感受一下它能做什么。

— END —
LC 智趣厅 · 科技与生活的交点
ihygg.cn