夜雨聆风Hermes小白教程｜第二章：一键安装——覆盖所有操作系统
点击上方蓝字关注我👆获得AI超能力✨
大家好，我是你们的 AI 工具搭子——兔子大叔。
兔子大叔创建了一个免费交流的 openclaw 和 AI 工具的交流群，感兴趣的可以扫码加入哦
💡 本章是全书的基石。如果装不上，后面所有内容都白搭。请根据自己的操作系统选择对应的安装方式。
2.1 安装前先确认自己的系统
在开始安装之前，先确认一下你的操作系统。
打开终端（macOS/Linux用户）或者PowerShell/命令提示符（Windows用户），输入以下命令：
macOS / Linux 用户
uname -a
你应该看到类似这样的输出：
Darwin MacBook-Pro.local 23.4.0 Darwin Kernel Version 23.4.0 ... arm64
或者
Linux my-server 5.15.0 ... x86_64 GNU/Linux
Windows 用户
打开PowerShell，输入：
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"
你应该看到类似：
OS Name: Microsoft Windows 11 Pro
OS Version: 10.0.22631 N/A Build 22631
2.2 对照自己的情况选择安装方式
⚠️ Windows用户特别注意：如果你已经装了WSL2，用官方脚本最简单。如果没装WSL2也不想装，第二节有兔子大叔实测成功的Git Bash方案。
2.3 macOS / Linux 用户：一行命令搞定
第一步：打开终端
macOS：按 Command + 空格，搜索"终端"，回车Linux：按 Ctrl + Alt + T，或者从菜单里找"终端"
第二步：粘贴安装命令
复制以下命令，粘贴到终端里，回车：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
📌 安装过程中如果提示输入密码，输入你的电脑登录密码（输入时屏幕不显示字符，正常现象）
第三步：等待安装完成
安装脚本会自动：
检测你的操作系统 安装必要的依赖（Python、git等） 下载Hermes最新版本 设置好PATH（让 hermes命令全局可用）
第四步：验证安装
安装完成后，输入：
hermes --version
看到类似这样的输出，说明安装成功：
hermes-agent 0.8.0
Hermes截图
图：Hermes对话示例
常见问题
Permission denied | sudo：`<命令> | |
curl: command not found | ||
2.4 Windows + WSL2 用户：官方推荐方案
什么是WSL2？
WSL2 = Windows Subsystem for Linux 2
通俗讲，它让Windows能原生地运行一个Linux子系统。Hermes的官方脚本主要是为Linux写的，所以在WSL2里跑最顺。
第一步：检查是否已安装WSL2
打开PowerShell（管理员），输入：
wsl --status
如果看到类似这样的输出：
默认分发: Ubuntu
默认版本: 2
说明WSL2已经装好了，直接跳到第三步。
第二步：安装WSL2
如果没装WSL2，在PowerShell（管理员）里输入：
wsl --install
安装过程会要求你重启电脑，重启之前把正在写的内容保存好。
重启后，WSL2会自动打开Ubuntu终端，让你设置用户名和密码。
第三步：在WSL2里安装Hermes
打开Ubuntu终端（或者Windows Terminal里选Ubuntu），然后：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
之后的步骤和macOS/Linux完全一样，参考2.3节。
验证安装
在Ubuntu终端里输入：
hermes --version
2.5 Windows + Git Bash 用户：兔子大叔自创方案 ⭐
🎉 这是兔子大叔自己摸索出来的方案，专门给不想装WSL2的Windows用户准备的。
如果你不想装WSL2，或者觉得WSL2太重，可以用Git Bash方案。这个方案兔子大叔在多台Windows电脑上测试成功，包括Windows 10和Windows 11。
什么是Git Bash？
Git Bash是Git for Windows自带的一个工具，提供了类似Linux的终端体验。它比WSL2轻量很多，安装也简单。
第一步：安装Git for Windows
去 https://git-scm.com/download/win 下载 运行安装程序，一路点"Next"就行 安装完成后，右键桌面或文件夹空白处，应该能看到 "Git Bash Here"
第二步：检查Python环境
打开Git Bash，输入：
python3 --version
如果看到类似这样的输出（Python 3.8以上）：
Python 3.11.8
✅ Python已安装，跳到第三步。
如果没有Python，去 https://www.python.org/downloads/windows/ 下载Python 3.10或更高版本。
⚠️ 安装时记得勾选 "Add Python to PATH"，不然Git Bash找不到Python。
第三步：克隆Hermes代码仓库
在Git Bash里：
cd ~
git clone https://github.com/NousResearch/hermes-agent.git
这会在你的用户目录下创建一个 hermes-agent 文件夹。
第四步：创建Python虚拟环境
cd hermes-agent
python3 -m venv venv
第五步：激活虚拟环境
source venv/Scripts/activate
激活后，命令提示符前面会多一个 (venv)。
第六步：安装依赖 ⚠️ 重要
⚠️ 这里是关键坑点！不要用
pip install -e ".[all]"，会让你等几个小时最后还报错。
正确做法是安装核心功能包：
pip install -e ".[cli,pty,mcp,cron,messaging]"
如果报缺少某个包，再单独安装：
pip install aiohttp cryptography qrcode
第七步：创建Hermes配置目录
mkdir -p ~/.hermes
第八步：同步内置Skills
python3 scripts/sync_builtin_skills.py
第九步：配置config.yaml ⚠️ 必做
Git Bash方案需要手动创建配置文件。在 ~/.hermes/ 目录下创建 config.yaml：
cat > ~/.hermes/config.yaml << 'EOF'
model:
default: "deepseek-chat"
provider: "deepseek"
terminal:
backend: "local"
compression:
enabled: true
threshold: 0.50
target_ratio: 0.20
memory:
memory_enabled: true
user_profile_enabled: true
gateway:
platforms:
- type: "cli"
enabled: true
EOF
📌 这里的
deepseek-chat只是示例，你可以之后改成其他模型。
第十步：配置API Key（.env文件）
在 ~/.hermes/ 目录下创建 .env 文件：
cat > ~/.hermes/.env << 'EOF'
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
EOF
把 sk-xxx 换成你从 DeepSeek 官网申请的真实API Key。
第十一步：设置PATH方便全局调用
每次打开Git Bash都要 cd ~/hermes-agent && source venv/Scripts/activate 很麻烦。
可以创建一个快捷命令。编辑 ~/.bashrc（如果没有就创建）：
cat >> ~/.bashrc << 'EOF'
alias hermes='~/hermes-agent/venv/Scripts/hermes.exe'
EOF
然后让配置生效：
source ~/.bashrc
第十二步：验证安装
hermes --version
如果看到版本号，✅ 安装成功！
第十三步：修复Windows编码问题 ⚠️ 可能需要
⚠️ 如果你看到类似
UnicodeEncodeError: 'gbk' codec can't encode...的报错，用这个方法修复。
在Git Bash里设置环境变量：
export PYTHONIOENCODING=utf-8
为了永久生效，把这行加到 ~/.bashrc 里：
echo 'export PYTHONIOENCODING=utf-8' >> ~/.bashrc
source ~/.bashrc
第十四步：启动试试
hermes
你应该能看到Hermes的启动界面了！
Git Bash截图
图：Terminal中运行Hermes
Windows Git Bash方案：快速检查清单
python3 --version | ||
git clone ... | ||
python3 -m venv venv | ||
source venv/Scripts/activate | ||
pip install -e ".[cli,pty,mcp,cron,messaging]" | ||
cat ~/.hermes/config.yaml | ||
cat ~/.hermes/.env | ||
hermes --version | ||
hermes |
2.6 开发者最爱：uvx方式安装
如果你是个Python开发者，可能已经在用 uv 这个现代包管理器了。
什么是uv？
uv是一个用Rust写的Python包管理器，比pip快10-100倍。它可以"即开即用"——不需要先装Python环境，直接运行命令就能下载并执行程序。
安装uv（如果没有）
curl -LsSf https://astral.sh/uv/install.sh | sh
用uvx直接运行Hermes
uvx hermes-agent
优点：
不用clone仓库 不用配置虚拟环境 自动下载最新版本 用完即走
缺点：
每次启动都要联网下载 第一次比较慢
💡 适合只是想"试试水"的用户。正式长期使用还是推荐前面的安装方式。
2.7 安装后必做：hermes doctor 诊断
不管你用哪种方式安装，安装完成后第一时间运行诊断命令：
hermes doctor
这个命令会检查：
✅ Python版本是否兼容 ✅ 必要的依赖包是否安装 ✅ config.yaml是否存在且格式正确 ✅ .env文件是否存在 ✅ API Key是否配置 ✅ Skills目录是否完整
正常输出的例子
╭──────────────────────────────────────────╮
│ Hermes Doctor │
├──────────────────────────────────────────┤
│ ✅ Python: 3.11.8 (required: >=3.9) │
│ ✅ Dependencies: all installed │
│ ✅ Config: /home/user/.hermes/config.yaml│
│ ✅ .env: found │
│ ⚠️ API_KEY: not configured (optional) │
│ ✅ Skills: 12 built-in skills found │
╰──────────────────────────────────────────┘
hermes doctor截图
图：hermes doctor 诊断结果
常见警告和错误
✅ | ||
⚠️ | ||
❌ |
2.8 动手任务：完成安装，截图发群
完成了以上步骤？太好了！现在做一个简单的验证：
任务清单
⬜ 运行 hermes --version⬜ 运行 hermes doctor⬜ 启动 hermes⬜ ⬜
截图要求
图1：版本确认
hermes --version
图2：第一次对话
hermes
# 然后输入"你好"
——你的 AI 工具搭子，兔子大叔
📝 文/ 数字时代游民@云影876 | 龟兔算法（个人网站 guige.host）
⌨️ 2026年04月15日
📍 港城小天地
🎯 2026主题｜创造，连接，成长
🐢🐇⏩ 慢生活，快效率，分享让日常更顺滑的好工具！ . . ⇢ ˗ˏˋ 吾不追光，只做云影｜云影无定，终有归期࿌ྂ
专辑精选：
Openclaw攻略专辑地址: https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&__biz=MzU4NjQ1NzU0MQ==&scene=1&album_id=4367457031662813198&count=3#wechat_redirect
Hermes攻略专辑地址： https://mp.weixin.qq.com/mp/appmsgalbum?__biz=MzU4NjQ1NzU0MQ==&action=getalbum&album_id=4468930455701913606&scene=126#wechat_redirect
关注不迷路，兔子大叔坚持持续更新哦！！！