引言
Hermes Agent 是 Nous Research 开发的开源 AI Agent 框架。它能在终端里自主执行任务——读代码、写文件、执行命令，甚至通过 QQ、微信、Telegram 等平台远程调度。支持 DeepSeek、OpenAI、Anthropic 等 20+ 模型提供商。
本文从零开始，带你完成安装、配置，直至发出第一条对话。
环境要求
开始之前确认你的系统满足以下条件：
| 项目 | 要求 ||------|------|| 操作系统 | Linux、macOS 12+、Windows 10/11（WSL2） || Python | 3.10 或更高 || Git | 2.30 或更高 || 终端 | 任意（推荐 Windows Terminal） |
如果你使用 Windows，推荐通过 WSL2（Ubuntu）安装。原生 Windows 下部分功能可能受限。
一、安装 Hermes
一条命令完成安装：
# Linux / macOS / WSL2
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装过程说明
脚本会自动完成以下步骤：
- 检测 Python 版本并创建虚拟环境
- 安装 Hermes 及依赖包
- 创建
~/.hermes/配置目录
安装完成后重新打开终端，确保 hermes 命令可用：
# 验证安装
hermes --version
如果提示 command not found，手动添加到 PATH：
# 安装脚本通常会自动处理，如果没有，手动执行
echo 'export PATH="$HOME/.hermes/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
国内用户加速
如果下载速度慢，先设置镜像再安装：
# 设置清华 PyPI 镜像（国内下载 70MB/s+）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 然后再执行安装
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
二、初始化配置
安装完成后运行配置向导：
# 启动交互式配置
hermes setup
选择模型
配置向导会引导你完成三个核心步骤。
第一步：选择模型提供商。 按方向键浏览，回车确认。推荐选择：
| 提供商 | 适合人群 | 需要准备 ||--------|----------|----------|| DeepSeek | 国内用户首选，便宜好用 | DeepSeek API Key || OpenRouter | 想用多种模型的用户 | OpenRouter API Key || OpenAI | 已有 ChatGPT 付费账号 | OpenAI API Key || Anthropic | 代码能力要求高 | Anthropic API Key |
第二步：填入 API Key。 示例——以 DeepSeek 为例：
# 手动设置方式（跳过向导时使用）
hermes config set model.provider deepseek
hermes config set model.default deepseek-chat
然后将 API Key 写入 ~/.hermes/.env：
echo "DEEPSEEK_API_KEY=sk-your-key-here" >> ~/.hermes/.env
第三步：确认终端后端。 选 local 即可，Hermes 会直接在你的系统上执行命令。
验证配置
# 检查配置是否完整
hermes doctor
输出中看到全部 ✓ 就说明配置正确。
三、第一次对话
配置完成后直接运行：
# 进入交互模式
hermes
你会看到一个类似聊天的界面。试试第一条指令：
查看当前目录下有哪些文件，按大小排序
Hermes 会自动执行 ls 命令并返回结果。
单次任务模式
不需要进入交互界面，直接执行一个任务：
# 单次查询
hermes chat -q "解释一下 git rebase 和 git merge 的区别"
# 指定模型执行任务
hermes chat -q "列出 ~/projects 下的所有 Python 文件" -m deepseek-chat
常用会话命令
交互模式下，以下命令最常用：
| 命令 | 作用 ||------|------|| /model | 查看或切换模型 || /new | 开启新会话 || /help | 查看所有命令 || /quit | 退出 |
四、安装桌面应用（可选）
v0.16 版本新增了原生桌面端。如果你偏好图形化操作：
从 <a href="https://github.com/NousResearch/hermes-agent/releases">GitHub Releases</a> 下载对应安装包：
- Windows：下载
.exe安装程序 - macOS：下载
.dmg - Linux：下载
.AppImage
桌面应用与 CLI 共用同一套配置和 API Key，不需要重新设置。
五、进阶：连接聊天平台
安装 Hermes 的真正价值在于随时随地调度它。配置网关后，你可以在手机上通过 QQ、微信、Telegram 等平台直接给 Hermes 发指令。
配置网关
# 启动网关配置向导
hermes gateway setup
# 选择要连接的平台，按提示填入 Token / AppID
启动网关
# 前台运行（测试用）
hermes gateway run
# 安装为系统服务（长期运行）
hermes gateway install
hermes gateway start
启动后，在手机上发一条消息给 Hermes，它就能在服务器上执行命令并回复你。
六、常见问题
安装时 pip 下载超时
国内用户经常遇到。解决方法：
# 使用清华镜像
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple <package>
# 或永久设置
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
Windows WSL2 下网关无法自启
WSL2 需要启用 systemd：
# 编辑 /etc/wsl.conf
sudo nano /etc/wsl.conf
# 添加：
[boot]
systemd=true
# 保存后重启 WSL
DeepSeek API 连接失败
检查 API Key 和环境变量：
# 查看当前配置的模型
hermes config | grep model
# 测试 API 连通性
curl -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
https://api.deepseek.com/v1/models
配置改了不生效
部分配置需要重启才会生效。在网关模式用 /restart，在 CLI 模式退出重新运行 hermes。
结语
从安装到第一条对话，整个过程不到五分钟。真正强大的功能在后面——技能系统让它从经验中学习，网关让你在手机上随时调度，定时任务帮你自动化一切。
装好之后，别只把它当聊天机器人。给它一个真实的任务——整理文件夹、写段脚本、查个日志——你会感受到 AI Agent 和聊天 AI 的本质区别。
评论