Windows 和 Ubuntu 安装 Hermes Agent 全攻略

文章目录【开场白】【先说重点Hermes 和 OpenClaw 装机区别】【Windows 安装5 步搞定】第 1 步装 WSL2第 2 步更新 Ubuntu 系统第 3 步一键装 Hermes第 4 步让环境变量生效第 5 步初始化配置【WSL2 开机自启跟 OpenClaw 同样的操作】【Ubuntu 安装3 步搞定】第 1 步更新系统 装依赖第 2 步一键装 Hermes第 3 步初始化【装完怎么用】启动 Agent安装技能包开启持久记忆强烈建议更新【踩坑急救包】【和 OpenClaw 共存怎么搭配】【总结一图流】【开场白】上期讲了 OpenClaw 怎么装有人说我还想装一个 Hermes Agent能行吗当然能。而且今天我要告诉你Hermes 和 OpenClaw 不是二选一——它们可以共存各有所长。OpenClaw 是 Node.js 系的 AI 执行网关擅长对接各种消息平台Hermes 是 Python 系的自进化智能体框架擅长自主学习和持久记忆。简单说OpenClaw 是你的 AI 员工Hermes 是你的 AI 学徒——越用越强任务做完了自动沉淀成技能下次直接复用。今天Windows 和 Ubuntu 双平台安装一次讲透。【先说重点Hermes 和 OpenClaw 装机区别】对比项OpenClawHermes Agent语言栈Node.jsPython安装方式npm / 一键脚本pip / 一键脚本Windows 原生有但 WSL 更稳❌ 不支持必须走 WSL2核心特色消息平台网关、7×24 守护进程自进化闭环、持久记忆、技能沉淀共存✅ 互不冲突✅ 互不冲突关键结论Windows 用户不管装 OpenClaw 还是 Hermes都推荐走 WSL2。Ubuntu 用户直接装。两个工具装在同一台机器上完全没问题——OpenClaw 数据在~/.openclawHermes 数据在~/.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 ripgrepHermes 需要 Python 3.10 和 Node.js 18这里一步到位。第 3 步一键装 Hermescurl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash等 1 到 3 分钟。脚本自动做这些事检测 Python / Node 版本缺啥补啥安装到~/.hermes把hermes命令加进 PATH拉取默认 Skills registry660 个技能包看到✅ 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 / OpenRouterAPI Key粘贴你的 Key默认模型选一个你喜欢的基础权限按需开启配置完跑一下健康检查hermes doctor这条命令自检 12 项——Python 版本、Node 版本、PATH、Skills registry 连通性、LLM Provider 连接、磁盘空间、文件权限……全绿就能开干了。有问题加--fix让它自动修hermes doctor --fix【WSL2 开机自启跟 OpenClaw 同样的操作】如果你上期已经配过可以跳过。没配的话sudo nano /etc/wsl.conf写入[boot] systemdtrue保存退出回到 PowerShellwsl --shutdown重新打开 Ubuntusystemd 生效。再执行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 步一键装 Hermescurl -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。【装完怎么用】启动 Agenthermes直接进入交互界面用自然语言下达任务。试试这句“给我列一下当前目录下所有 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-certificatesWSL 里装到一半卡住DNS 解析问题pypi.org 抽风配/etc/resolv.conf为8.8.8.8或设 pip 镜像Python command not foundmacOS 不带 python只有 python3装完脚本需要重启终端Skills registry unreachableGitHub raw 被拦设代理export HTTPS_PROXYhttp://127.0.0.1:7890后hermes skills syncAPI 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 多一步 WSLUbuntu 直接开干。装完跑hermes doctor全绿就 OK然后hermes开始你的第一次任务。如果你想卸载——也简单rm -rf ~/.hermes干净利落。上期装了 OpenClaw 的同学不用选边站——两个都装上一个管通信一个管进化才是完整方案。