Windows 和 Ubuntu 安装 Hermes Agent 全攻略

关注

原创最新推荐文章于 2026-10-19 09:32:23 发布 1.1k 阅读 AI 写同款· GEO 优化 ›

DSH Desktop从下载到跑通本地Agent的完整配置指南随着大模型应用走向工程化，本地化Agent的部署与管理成为开发者关注的焦点。跨平台桌面客户端作为图形化管理入口，大幅降低了命令行工具的使用门槛。以DeepSeek Harness生态为例，其桌面端DSH Desktop通过可视化表单、插件市场与实时日志，将Agent编排、模型调用和工具链配置整合为一体化工作流。内容涵盖环境准备（JDK17与Maven）、三平台安装要点、Hermes Agent联动、插件管理及常见故障排查，帮助开发者在本地快速跑通Agent服务，实现从模型下载到任务编排的完整闭环。阅读详情

【开场白】

上期讲了 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 的同学，不用选边站——两个都装上，一个管通信一个管进化，才是完整方案。

收录于