Windows 和 Ubuntu 安装 Hermes Agent 全攻略
本文介绍了如何在Windows和Ubuntu系统上安装Hermes Agent,并与OpenClaw共存使用。主要内容包括: Hermes与OpenClaw的区别:前者是Python系自进化智能体框架,后者是Node.js系AI执行网关,两者可共存且数据隔离。 Windows安装步骤:通过WSL2安装Ubuntu,更新系统后一键安装Hermes,并进行初始化配置。 Ubuntu安装更简单:只需更新
文章目录
【开场白】
上期讲了 OpenClaw 怎么装,有人说:我还想装一个 Hermes Agent,能行吗?
当然能。而且今天我要告诉你,Hermes 和 OpenClaw 不是二选一——它们可以共存,各有所长。
OpenClaw 是 Node.js 系的 AI 执行网关,擅长对接各种消息平台;Hermes 是 Python 系的自进化智能体框架,擅长自主学习和持久记忆。
简单说:OpenClaw 是你的 AI 员工,Hermes 是你的 AI 学徒——越用越强,任务做完了自动沉淀成技能,下次直接复用。
今天,Windows 和 Ubuntu 双平台安装,一次讲透。
【先说重点:Hermes 和 OpenClaw 装机区别】
| 对比项 | OpenClaw | Hermes Agent |
|---|---|---|
| 语言栈 | Node.js | Python |
| 安装方式 | npm / 一键脚本 | pip / 一键脚本 |
| Windows 原生 | 有(但 WSL 更稳) | ❌ 不支持,必须走 WSL2 |
| 核心特色 | 消息平台网关、7×24 守护进程 | 自进化闭环、持久记忆、技能沉淀 |
| 共存 | ✅ 互不冲突 | ✅ 互不冲突 |
关键结论:Windows 用户,不管装 OpenClaw 还是 Hermes,都推荐走 WSL2。Ubuntu 用户直接装。
两个工具装在同一台机器上完全没问题——OpenClaw 数据在 ~/.openclaw,Hermes 数据在 ~/.hermes,井水不犯河水。
【Windows 安装:5 步搞定】
第 1 步:装 WSL2
管理员 PowerShell 里一行命令:
wsl --install
重启电脑,弹出 Ubuntu 窗口,设用户名密码。
指定版本:
wsl --install -d Ubuntu-24.04
第 2 步:更新 Ubuntu 系统
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3.12 python3.12-venv nodejs npm git ripgrep
Hermes 需要 Python 3.10+ 和 Node.js 18+,这里一步到位。
第 3 步:一键装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
等 1 到 3 分钟。脚本自动做这些事:
- 检测 Python / Node 版本,缺啥补啥
- 安装到
~/.hermes - 把
hermes命令加进 PATH - 拉取默认 Skills registry(660+ 个技能包)
看到 ✅ Hermes Agent installed at ~/.hermes 就成功了。
国内网络慢?用镜像:
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash或者先配 pip 镜像:
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
第 4 步:让环境变量生效
source ~/.bashrc
或者关掉终端重开一个。
验证一下:
hermes --version
输出版本号就对了。
第 5 步:初始化配置
hermes setup
交互式向导,会问你:
- 模型提供商:国内推荐智谱 GLM-4 或 Kimi(无需代理,按量计费便宜),海外用 Claude / OpenAI / OpenRouter
- API Key:粘贴你的 Key
- 默认模型:选一个你喜欢的
- 基础权限:按需开启
配置完跑一下健康检查:
hermes doctor
这条命令自检 12 项——Python 版本、Node 版本、PATH、Skills registry 连通性、LLM Provider 连接、磁盘空间、文件权限……全绿就能开干了。
有问题?加
--fix让它自动修:hermes doctor --fix
【WSL2 开机自启:跟 OpenClaw 同样的操作】
如果你上期已经配过,可以跳过。没配的话:
sudo nano /etc/wsl.conf
写入:
[boot]
systemd=true
保存退出,回到 PowerShell:
wsl --shutdown
重新打开 Ubuntu,systemd 生效。
再执行:
sudo loginctl enable-linger "$(whoami)"
搞定。Hermes 守护进程开机自启。
【Ubuntu 安装:3 步搞定】
第 1 步:更新系统 + 装依赖
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3.12 python3.12-venv nodejs npm git ripgrep curl
第 2 步:一键装 Hermes
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
国内用镜像:
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
第 3 步:初始化
source ~/.bashrc
hermes setup
hermes doctor
完事。Ubuntu 比 Windows 少两步,因为不用折腾 WSL。
【装完怎么用?】
启动 Agent
hermes
直接进入交互界面,用自然语言下达任务。试试这句:
“给我列一下当前目录下所有 Python 文件的行数”
看它怎么调用工具完成的——这就确认 LLM 链路通了。
安装技能包
Hermes 自带 660+ 个 Skills,按需安装:
hermes skills add code-review
hermes skills list
开启持久记忆(强烈建议)
默认 Hermes 是无状态的。开启记忆后,跨会话记住你的偏好和项目结构:
hermes config memory enable
hermes memory init
这就是 Hermes 最强的地方——自进化。 每次任务完成,它会自动生成技能文件,形成可复用的经验库。你用得越多,它越懂你。
更新
hermes update
一行命令升级到最新版。想回滚?hermes update --rollback。想试新功能?hermes update --channel beta。
【踩坑急救包】
| 问题 | 原因 | 解法 |
|---|---|---|
hermes 命令找不到 |
PATH 没生效 | source ~/.bashrc 或重开终端 |
| SSL 证书报错 | 系统证书过期或被代理拦截 | sudo apt-get install ca-certificates |
| WSL 里装到一半卡住 | DNS 解析问题,pypi.org 抽风 | 配 /etc/resolv.conf 为 8.8.8.8,或设 pip 镜像 |
| Python command not found | macOS 不带 python,只有 python3 | 装完脚本需要重启终端 |
| Skills registry unreachable | GitHub raw 被拦 | 设代理:export HTTPS_PROXY=http://127.0.0.1:7890 后 hermes skills sync |
| API Key 401 错误 | Key 填错或过期 | 编辑 ~/.hermes/config.toml 更新 Key |
| 权限报错 EACCES | 不小心用 sudo 装了 | sudo rm -rf ~/.hermes,用普通用户重跑脚本 |
【和 OpenClaw 共存:怎么搭配?】
两台工具可以同时装在一台机器上,数据目录完全隔离:
~/.openclaw/ ← OpenClaw 的家
~/.hermes/ ← Hermes 的家
推荐分工:
- OpenClaw → 消息平台网关(飞书/钉钉/企业微信接入),7×24 守护进程
- Hermes → 深度任务执行(代码审查、文件处理、自动化流程),技能自进化
一个对外通信,一个对内进化。双引擎驱动,比单用任何一个都强。
【总结:一图流】
Windows:
wsl --install → 重启 → 进Ubuntu
→ sudo apt update && sudo apt install -y python3.12 python3.12-venv nodejs npm git ripgrep
→ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
→ source ~/.bashrc
→ hermes setup
→ hermes doctor
→ hermes
Ubuntu:
sudo apt update && sudo apt install -y python3.12 python3.12-venv nodejs npm git ripgrep curl
→ curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
→ source ~/.bashrc
→ hermes setup
→ hermes doctor
→ hermes
核心安装命令就一行。Windows 多一步 WSL,Ubuntu 直接开干。
装完跑 hermes doctor 全绿就 OK,然后 hermes 开始你的第一次任务。
如果你想卸载——也简单:rm -rf ~/.hermes,干净利落。
上期装了 OpenClaw 的同学,不用选边站——两个都装上,一个管通信一个管进化,才是完整方案。
更多推荐




所有评论(0)