Hermes Agent 是目前开源 AI Agent 里少数真正能落地跑通的框架——长期记忆、自动生成 Skill、定时任务、消息平台接入，这几块都有。但安装文档对新手不太友好，Windows 坑尤其多。这篇教程把三个平台的步骤拆开，踩坑点逐一标出，照着做基本不会翻车。 安装Hermes Agent前的准备
Hermes 不是下一个 Docker 镜像就跑起来的东西。它是本地运行的 Agent 框架，依赖 Python 3.11+、Node.js 22、ripgrep、ffmpeg 这一整套工具链。好消息是官方安装脚本会自动处理，不用你手动一个个去装。
三个平台的体验差别挺大：macOS 和 Linux 最稳，Windows 原生支持还在早期 Beta，官方自己都建议 Windows 用户优先走 WSL2。
macOS / Linux 安装Hermes Agent
这两条路线装法基本一致，一条命令搞定。
第一步：确认 Git 已安装
没装的话：
- macOS：xcode-select --install（会弹出系统安装窗口）
- Ubuntu/Debian：sudo apt install git -y
第二步：运行安装脚本
这条命令会自动装 uv、Python 3.11、Node.js 22、ripgrep、ffmpeg，然后把 Hermes 克隆到 ~/.hermes/hermes-agent/，整个过程 3-5 分钟，中间有大量输出，正常的，别管它。
第三步：刷新 shell 配置
或者直接关掉终端重新打开。
第四步：启动
第一次运行会引导你选 LLM 提供商和模型。
macOS / Linux 常见坑
装完后 hermes: command not found——安装脚本把 hermes 放在了 ~/.local/bin/，但这个路径不一定在 PATH 里。手动加一下：
如果不需要浏览器自动化，加 --skip-browser 能省不少时间和磁盘：
Windows 安装Hermes Agent
Windows 原生支持还在早期阶段，最稳的方案是走 WSL2。
方案一：WSL2（推荐）
打开 PowerShell（以管理员身份运行），先查看是否已安装：
没装的话执行：
重启电脑后，安装 Ubuntu 虚拟机：
安装过程中会让你设置用户名和密码，记下来。完成后执行 wsl --set-default Ubuntu-Hermes 把它设为默认。
进入虚拟机后，先更新软件源：
然后在 Ubuntu 里跑 Linux 安装脚本就行（见上方 macOS / Linux 部分），体验和原生 Linux 基本一致。
方案二：原生 PowerShell（能用，但有限制）
脚本会自动装 uv、Python 3.11、Node.js 22，如果系统没有 Git，会自动下载 PortableGit（约 50MB）。
装完必须彻底重启终端，不只是新开 tab，否则 PATH 不刷新，hermes 命令找不到。
原生 Windows 跑不了仪表盘 /chat 终端面板，那个依赖 POSIX PTY，Windows 没有。其他的——hermes chat、Gateway 消息平台、定时任务、浏览器工具、MCP 服务——原生都能跑。
Windows 常见坑
PowerShell 拦截脚本——先改执行策略：
终端乱码——设这个环境变量：
PortableGit 被杀毒软件误报——不是病毒，去 %LOCALAPPDATA%\hermes\ 下面加白名单。
Hermes Agent如何配置模型
安装完之后执行：
进入模型提供商选择界面。国内用户性价比最高的选择是接 DeepSeek——去 DeepSeek 开放平台充值，创建 API Key，然后： 也可以选择 OpenAI、Anthropic、MiniMax、通义千问等主流提供商。Hermes 支持为不同功能配置不同模型，还能设置备用模型。 如果你用 Nous Portal（Hermes 自家的），登录后选套餐，一步到位，不用手动填 Key。
装完Hermes Agent后的必须要做的事
不管哪个平台，装完先跑这个：
它会告诉你缺了什么、哪里配错了、怎么修。比如 API Key 没设、某个依赖版本太旧、配置文件需要迁移，这些问题 doctor 命令基本都能检测出来。
常用配置命令：
快速故障排查表
| | |
|---|
hermes: command not found | | source ~/.bashrc 或手动加 PATH |
| | hermes model 或 hermes config set |
| | hermes config check → migrate |
| | 设 HERMES_DISABLE_WINDOWS_UTF8=1 |
| | |
Hermes 的几个核心能力
装完跑起来之后，Hermes 和普通 AI 的核心区别主要体现在这几块：
长期记忆：你在一个会话里告诉它你的偏好、背景、工作流，它会写入本地数据库（state.db），下次新开会话也记得。数据在本地，不上云。
自动生成 Skill：跑通一个复杂流程之后，Hermes 会自动把这个流程封装成可复用的 Skill，存进技能仓库。下次不用重新写提示词，直接调用。它预置了 70 多种 Skill，20 多种工具，基本不需要你自己找插件。
消息平台接入：支持飞书、钉钉、企业微信、Telegram、Discord、Slack 等主流平台。配置好之后，可以直接从手机聊天 App 里调度 Hermes 执行任务，不用打开电脑。 定时任务：可以给任何流程设置 cron 定时自动运行，比如每天上午九点自动生成日报、监控信息变动等等。
Hermes 的安装脚本已经帮你处理了绝大多数脏活。真正容易出问题的，是装完之后的配置和平台兼容性。macOS / Linux 用户直接 curl 一把梭，遇到问题先跑 hermes doctor。Windows 用户优先 WSL2，原生 PowerShell 能用但别期望和 Linux 一样顺滑。不需要浏览器自动化的，加 --skip-browser，省时间省磁盘，以后要用再单独装。
AI 速览
