夜雨聆风来源：网络大神
这是一篇面向新手的Hermes Agent完整安装使用教程，所有步骤100%来自官方文档。
包含一键安装完整步骤、免费模型配置方法、有完整的常见问题解答，无需懂代码，复制粘贴就能用，30分钟就能拥有一个越用越懂你的AI助手。
3秒判断这篇是不是给你写的
✅ 没用过任何AI Agent，不清楚命令行工具怎么使用
✅ 之前装过OpenClaw/其他Agent，认为OpenClaw的记忆差，不够智能
✅ 不想写复杂代码，想让AI自动帮你干重复活
❌ 技术大佬想研究源码的不用看，直接去官方GitHub就行
懒人导航
→ 此前没安装过Hermes：按顺序看完全文，30分钟搞定
→ 已经装了Hermes不会用：直接跳「第二章 配置免费模型」
→ 安装出错了：直接跳「第五章 问题急救站」
Hermes是什么？ Hermes是Nous Research官方出的开源Agent，现在GitHub已经9万多星了。它的核心卖点只有一个：会自己学习。
你每次让它干完活，它都会自动把流程存成技能，下次再干同类的活直接就会了，越用越懂你。
第一章 极速体验：10分钟跑通第一个任务
1.1 第一步：打开终端
这一步是整个安装的基础，先把终端打开。
- • Mac用户：按 Command + 空格，搜「终端」，回车
- • Windows用户：先装WSL2（后面第一章会讲），打开Ubuntu终端
- • Linux用户：直接开终端
终端长什么样？Mac上是一个黑白窗口，Windows上是一个Ubuntu的紫色窗口。打开之后，你会看到一个光标在闪烁，等待你输入命令。
1.2 第二步：复制安装命令回车
把下面的命令复制到终端里，粘贴进去，然后回车：
# 官方GitHub源，网络好的用这个
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash粘贴方法：Mac用 Command + V，Windows用 Shift + Insert 或者直接鼠标右键粘贴。
回车之后，你会看到一堆文字在往下跑，这是正常的安装过程。有黄色警告不用管，那是正常的依赖安装提示。只有出现红色字才是报错。
如果下载超过2分钟还卡在那里没反应，按 Ctrl + C 停掉，然后用国内加速源：
# 国内加速源，下载慢用这个
curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash安装脚本会自动帮你装所有需要的依赖，包括Python、Node.js、ripgrep、ffmpeg这些，不用你手动一个个装。
官方支持的系统：Linux、macOS、WSL2、安卓Termux都能用。原生Windows不支持，必须装WSL2。
1.3 第三步：跟着向导填配置
安装完之后会自动进入配置向导，屏幕上会显示一些问题，跟着照填就行：
第一步：选模型提供商
这一步选 custom-openai，这是最通用的选项，国内外大部分平台都支持：
这一步直接输入
custom-openai回车就行
第二步：填 API Key
把你从平台官网复制的 API Key 粘贴进去。
API Key 是什么？怎么申请？下一章会详细讲，先跳过这里，继续配置。
第三步：填 Base URL
填对应平台的接口地址。不同平台地址不一样，下一章有完整的对照表。
第四步：填 Model Name
填你想用的模型名字。推荐先用免费模型试水，下一章有具体名字。
第五步：选终端后端
新手直接选本地（local）就行，不用改。
第六步：开启记忆功能
建议选开启，这样Hermes能跨会话记住你的偏好。
第七步：选语言
选中文。
配置向导跑完之后，屏幕会显示一行提示信息，说明配置成功了。
1.4 第四步：验证装没装成功
终端里输入下面的命令，回车：
hermes doctor如果所有检查项前面都显示 ✓，就说明安装成功了。有什么项显示 ✗，就去第五章急救站找对应问题。
验证成功之后，再输入这个命令激活环境：
# Bash用户用这个
source ~/.bashrc
# Zsh用户用这个（Mac默认是Zsh）
source ~/.zshrc或者更简单：直接关掉终端，重新打开一个，输入 hermes 回车。
1.5 第五步：跑第一个任务试试
现在你已经装好了，直接输入 hermes 回车进入对话界面，然后把下面的需求复制粘贴发过去：
帮我查一下Python requests库的最新版本，然后检查我当前项目里的requests版本需不需要更新等它干完活之后，你会看到它弹出一个提示：
「我注意到这个流程可以复用，是否保存为技能 check_package_version？」
你说「是的」，它就把这个流程自动存成技能了。下次你想查其他库版本，直接说「查一下numpy的版本」，它就知道该怎么做——这就是它越用越懂你的方式。
第二章 配置免费模型：不用花一分钱
2.1 配置 Hermes 只填 3 样东西
不管用哪个平台，配置界面都只问你这 3 件事：
- • API Key：去平台复制粘贴（相当于你的账号密码）
- • Base URL：接口地址（各平台不一样）
- • Model Name：模型名字（各平台不一样）
记住这3个就行，下面有具体怎么填。
2.2 免费模型怎么选
不想花钱的话，这几个平台有免费额度，直接注册就能用：
| 平台 | 官网地址 | 免费模型 | Base URL | Model Name |
|---|---|---|---|---|
| 智谱 | https://bigmodel.cn/ | glm-4-flash | https://open.bigmodel.cn/api/paas/v4 | glm-4-flash |
| Kimi | https://platform.moonshot.cn/ | moonshot-v1-8k | https://api.moonshot.cn/v1 | moonshot-v1-8k |
| 百度千帆 | https://qianfan.cloud.baidu.com/ | ernie-speed-128k | https://qianfan.cloud.baidu.com/v2 | ernie-speed-128k |
| Nous | https://portal.nousresearch.com/ | mimo-v2-flash | https://gateway.nousresearch.com | nous_portal |
| OpenRouter | https://openrouter.ai/ | nemotron-free | https://openrouter.ai/api/v1 | nemotron/neural-chat-7b-free |
推荐新手从智谱开始——注册最简单，有免费额度，反应快，对中文支持好。
下面以智谱为例，演示完整申请和配置流程。其他平台步骤一样，只是复制的地址不同。
2.3 智谱免费模型申请步骤（图文对照）
第一步：注册账号
打开 https://bigmodel.cn/，点击「注册」，用手机号或者邮箱注册一个账号。注册完之后登录。
第二步：创建 API Key
登录后在首页找到「API Keys」或者「开发者中心」，点击「创建API Key」，给它起个名字（比如"hermes"），点击确定。
页面上会显示一串字母和数字，这就是你的 API Key。只显示一次，关掉页面就看不见了，一定要立刻复制保存。
第三步：打开Hermes配置向导
在终端输入：
hermes setup第四步：按顺序回答问题
向导会依次问你几个问题，按下面这样回答：
选择模型提供商：输入 custom-openai，回车
输入 Base URL：输入 https://open.bigmodel.cn/api/paas/v4，回车
输入 Model Name：输入 glm-4-flash，回车
输入 API Key：粘贴你从智谱复制的Key，回车
选择后端：输入 local，回车
是否开启记忆：输入 y，回车
语言偏好：输入 zh，回车配置完之后，会提示配置成功。
第五步：验证是否连上
输入 hermes doctor，看模型那项是否显示 ✓。
如果显示 ✗，检查一下 API Key 有没有复制对，Base URL 有没有打错字。
2.4 其他平台配置方法（对照表）
其他平台步骤完全一样，只是把 Base URL 和 Model Name 换成对应平台的：
Kimi 配置方法：
- 1. 去 https://platform.moonshot.cn/ 注册，创建 API Key
- 2. 运行
hermes setup - 3. Base URL：
https://api.moonshot.cn/v1 - 4. Model Name：
moonshot-v1-8k - 5. 粘贴你的 Kimi API Key
百度千帆配置方法：
- 1. 去 https://qianfan.cloud.baidu.com/ 注册，创建 API Key（需要先实名认证）
- 2. 运行
hermes setup - 3. Base URL：
https://qianfan.cloud.baidu.com/v2 - 4. Model Name：
ernie-speed-128k - 5. 粘贴你的千帆 API Key
Nous 配置方法：
- 1. 去 https://portal.nousresearch.com/ 注册，创建 API Key
- 2. 运行
hermes setup - 3. Base URL：
https://gateway.nousresearch.com - 4. Model Name：
nous_portal - 5. 粘贴你的 Nous API Key
OpenRouter 配置方法：
- 1. 去 https://openrouter.ai/ 注册，创建 API Key
- 2. 运行
hermes setup - 3. Base URL：
https://openrouter.ai/api/v1 - 4. Model Name：
nemotron/neural-chat-7b-free - 5. 粘贴你的 OpenRouter API Key
2.5 想换其他模型怎么办
直接再跑一次 hermes setup，换一个新的 Model Name 就行。比如智谱还有 glm-4、glm-4-plus 等模型可用，千帆有更多选择。
用 hermes model 命令可以查看当前配置和切换模型。
第三章 开始用hermes跑第一个任务
3.1 装好了，具体能干什么？
官方自带47个工具，覆盖这些常见场景：
- 1. 写周报：「帮我按照下面的格式写周报：本周完成、下周计划、遇到的问题」
- 2. 做PPT大纲：「帮我做一个关于XX主题的PPT大纲」
- 3. 整理聊天记录：「帮我把下面的微信聊天记录整理成待办清单」
- 4. 写公众号文章：「帮我写一篇关于XX的公众号文章」
- 5. 爬公开数据：「帮我爬取豆瓣电影Top250的片名和评分」
- 6. 写文案：「帮我写一个XX产品的促销文案」
- 7. 改简历：「帮我优化下面的简历内容」
- 8. 做旅游攻略：「帮我做一个3天2夜的杭州攻略」
- 9. 写代码：「帮我写一个Python脚本，批量转换图片格式」
- 10. 解答问题：「帮我解释一下这个报错是什么意思」
3.2 核心玩法：怎么让它越用越懂你？
Hermes 最有价值的功能就是这个——自动学习你的习惯。
每次你让它干完一个复杂的活，它都会自动识别这个流程可以复用，弹出提示问你是否保存。
方式一：自动保存（最常用）
你让它干活 → 它干完了 → 弹出提示问你是否保存 → 你说「是」 → 它把这个流程存成技能，下次直接用。
方式二：手动触发保存
hermes skill create它会用自然语言问你：这个技能要做什么？然后你描述，它帮你生成。
3.3 遇到不会的任务怎么办
正常，直接跟它说你要干什么就行。它会调用各种工具帮你搞定。
比如：「帮我查一下今天有什么科技新闻」，它会调用搜索工具。
「帮我把这个文件夹里的所有图片改成 PNG 格式」，它会调用终端工具。
遇到问题不要慌，完整描述你的需求，它会自己想办法。
第四章 命令速查表
| 命令 | 作用 |
|---|---|
hermes | 启动对话界面 |
hermes setup | 重新运行配置向导 |
hermes doctor | 诊断环境和配置问题 |
hermes model | 查看/切换当前模型 |
hermes gateway start | 启动消息网关 |
hermes update | 更新到最新版本 |
hermes skills list | 列出所有已有技能 |
hermes --continue | 继续上一次对话 |
hermes --yolo | 自动批准所有操作（谨慎用） |
第五章 问题急救站
安装类报错
| 问题 | 解决方案 |
|---|---|
提示 curl: command not found | Mac: brew install curl，Ubuntu: sudo apt install curl |
提示 git: command not found | Mac: brew install git，Ubuntu: sudo apt install git |
| 安装脚本下载慢/卡住 | 换国内加速源（第一章有），或挂代理 |
提示 python: command not found | 装Python 3.9+ |
配置类报错
| 问题 | 解决方案 |
|---|---|
hermes doctor报模型连接错误 | 检查API Key和Base URL是否填对 |
| 模型连接失败（显示✗） | 确认API Key还有效，Base URL和Model Name没打错 |
| 配置改了不生效 | 关终端重开，或运行 hermes config check |
完全卸载重装
如果想清空重来，运行：
# 删除虚拟环境和配置
rm -rf ~/.hermes-venv
rm -rf ~/.hermes
rm -f ~/.local/bin/hermes
# 然后重新跑第一章的安装步骤官方资源
- • 官方GitHub：https://github.com/NousResearch/hermes-agent
- • 官方文档：https://hermes-agent.nousresearch.com/docs
