为什么选择 Windows 安装 Hermes Agent
环境准备
系统要求
必要工具
权限要求
具体安装步骤
安装 WSL2
WSL2 是 Windows 内置的 Linux 子系统，是运行 Hermes 的基础环境 。
以管理员身份打开 PowerShell，一条命令完成安装：
wsl --install
安装完毕后重启电脑，然后安装 Ubuntu：
wsl --install -d Ubuntu
首次打开 Ubuntu，系统会提示你设置 Linux 用户名和密码，设置完成后进入 Ubuntu 终端
配置 Ubuntu 基础环境
进入 WSL Ubuntu 终端后，依次执行以下命令 ：
# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装基础工具（Hermes 安装脚本只要求 git）
sudo apt install -y git curl wget vim zstd
验证 git 已安装：
git --version
注意：Python、Node.js、ripgrep、ffmpeg 等依赖 无需手动安装，Hermes 安装脚本会全部自动处理 。
配置 LLM 模型后端
Hermes Agent 需要接入一个 LLM。推荐两种方式：
| 方式 | 适合场景 | 配置复杂度 |
|---|---|---|
| Ollama 本地模型（如 Gemma 4） | 无需 API Key，离线可用 | 中等 |
| OpenRouter API（云端模型） | 不依赖本机算力，效果更好 | 简单 |
方式 A：安装 Ollama + 本地模型
# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 拉取模型（显存 8G 以上推荐 e4b，4G 用 e2b）
ollama run gemma4:e4b
模型服务默认运行在 http://127.0.0.1:11434 。
方式 B：使用 OpenRouter（推荐）
前往 openrouter.ai 注册并获取 API Key，安装 Hermes 时在配置向导中填入即可 。
一键安装 Hermes Agent
这是官方推荐的安装命令，在 WSL Ubuntu 终端中执行（如果遇到网络问题，请开启代理软件的tun模式） ：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装脚本会自动完成：
安装
uv（高速 Python 包管理器）安装 Python 3.11（Hermes 要求的精确版本）
安装 Node.js v22、ripgrep、ffmpeg
克隆仓库并配置全局
hermes命令启动 LLM 提供商配置向导
安装完成后，重载 Shell 环境：
source ~/.bashrc
初始配置
安装完成后通过以下命令进行配置 ：
# 方式一：启动完整配置向导（推荐首次使用）
hermes setup
# 方式二：单独配置 LLM 模型
hermes model
# 方式三：查看/修改工具启用状态
hermes tools
配置向导中的关键选项：
关于模型，可以选择列表中的模型，并填上api，如果没有找到，可以选择Custom endpoint ，比如，选择美团的longcat模型，参考的配置为：
API base URL: https://api.longcat.chat/openai/v1
API key: sk-你的LongCat密钥
Model name: LongCat-Flash-Chat
Context length in tokens: 131072
添加hermes 的 Web UI
主要有 三种方案，推荐按需选择：
| 方案 | 类型 | 复杂度 | 功能 | 端口 |
|---|---|---|---|---|
| 官方内置 Dashboard | 官方自带 | 最简单 | 配置/会话/日志/分析/Cron | 9119 |
| Open WebUI | Chat 前端 | 中等 | 完整 Chat UI + 多模型切换 | 3000 |
| hermes-webui | 第三方轻量 | 简单 | 轻量 Web Chat | 8787 |
方案一：官方内置 Web Dashboard（推荐首选）
这是最官方、零配置的方案，只需安装两个扩展包即可 。（ps:这界面有点神奇，我不是很喜欢。想要简单易懂一点的看方案二。）
第一步：安装 web + pty 扩展
在 WSL 终端内运行：
pip install 'hermes-agent[web,pty]'
说明：
web引入 FastAPI/Uvicorn HTTP 服务；pty支持在浏览器里嵌入完整的终端 TUI。如果想一次性装所有扩展，用hermes-agent[all]。
第二步：启动 Dashboard
hermes dashboard
会自动在浏览器打开 http://127.0.0.1:9119，若无法自动打开，手动访问此地址 。
WSL 端口自动转发：WSL2 会自动将 localhost:9119 转发到 Windows 侧，因此直接在 Windows 浏览器访问即可 。
hermes dashboard --port 8080 # 自定义端口
hermes dashboard --no-open # 不自动打开浏览器
Dashboard 功能页面
Status：实时查看 Gateway 状态、活跃 Session、Agent 版本
Chat：浏览器内嵌完整 TUI（通过 xterm.js + WebSocket 驱动）
Config：150+ 配置项的图形化表单编辑器，直接写入 config.yaml
API Keys：管理所有 Provider Key（LLM、工具、消息平台）
Sessions/Logs/Analytics/Cron/Skills：完整的运维管理界面
方案二：hermes-webui（轻量第三方方案）
hermes-webui 是社区开源的轻量 Web Chat，内置自动安装 hermes-agent 及依赖的 init 脚本 。网络问题请打开工具的tun模式。
git clone https://github.com/nesquena/hermes-webui
cd hermes-webui
./start.sh
启动成功后，在浏览器访问 http://127.0.0.1:8787，即可看到界面，可以设置语言、开启token显示等内容。
方案三：Open WebUI（Chat 前端，功能最丰富）
适合想要类 ChatGPT 风格对话界面、且支持多模型切换的用户 。
第一步：启用 Hermes API 服务器
编辑 ~/.hermes/.env，加入：
API_SERVER_ENABLED=true
API_SERVER_KEY=your-secret-key # 替换为自定义密钥
第二步：启动 Hermes Gateway
hermes gateway
第三步：安装并启动 Open WebUI（Docker 方式）
docker run -d \
-p 3000:8080 \
--add-host=host.docker.internal:host-gateway \
-e OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1 \
-e OPENAI_API_KEY=your-secret-key \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main
访问 http://localhost:3000，首次访问需注册管理员账号 。
第四步：验证连接
在 Open WebUI 中：Admin Settings → Connections → OpenAI → Add Connection，填入 URL http://localhost:8642/v1 和上面设置的 API Key，点击校验
实战：博客写作工作流实现
Hermes Agent 内置 40+ 工具，包括文件读写、网页搜索、代码执行等 。针对参考博客的风格——技术教程型、分步骤、带表格+命令代码块——可以这样使用：
启动 Hermes
hermes
直接输入写作指令
请帮我写一篇技术博客，主题：在 Ubuntu 22.04 上通过 Docker 部署 Nginx 反向代理。
风格要求：
– 分为”前言 / 准备工作 / 步骤 / 常用命令”等章节
– 每个关键步骤都带完整的命令代码块
– 准备工作部分用 Markdown 表格列出前置条件
– 语言简洁，面向有一定 Linux 基础的读者
– 最后附上合规免责声明
输出为 Markdown 文件，保存到当前目录的 反向代理.md
Hermes 会自动调用文件工具将文章写入本地，同时通过自进化循环生成一个”博客写作技巧”skill文档，下次再让它写博客时会自动加载该技巧 。
