🪟 Windows 原生 · 零依赖上手

🪽Hermes Agent 安装教程

专为 Windows 用户编写的详细安装指南——从 PowerShell 一键安装到首次对话，附带截图级终端演示和全套排错方案。

🪟 主平台：Windows 10 / 11 📦 安装方式：PowerShell + Git ⏱️ 预计耗时：3~5 分钟 📅 更新于 2026.06

📑 目录

认识 Hermes Agent
准备网络环境（科学上网）
安装前的准备（Windows）
第一步：安装 Git for Windows
第二步：用 PowerShell 一键安装 Hermes
第三步：验证安装
第四步：配置 LLM 提供商
第五步：第一次对话
Windows 专属注意事项
常用命令速查
常见问题排查
附录：其他平台快速安装
下一步做什么

认识 Hermes Agent

Hermes Agent 是由 Nous Research 开发的开源 AI 智能体框架。它在你的电脑上本地运行，能执行终端命令、读写文件、浏览网页、管理项目——就像一个驻扎在你系统里的 AI 助手。

核心价值（用 Windows 用户的话说）

你需要的	Hermes 能做到的
🔌 不想绑定一家 AI 公司	支持 20+ 提供商：OpenRouter、DeepSeek、火山方舟、通义千问……随时切换
🪟 想在 Windows 上原生运行	原生 PowerShell 安装，不需要 WSL、不需要 Docker
🧠 希望它记住你的偏好	跨会话持久记忆，下次启动自动加载你的设定
📚 希望它越用越聪明	Skills 自学机制——成功解决一次问题后，自动保存为可复用技能
🛠️ 想让它帮你干活	终端命令、文件操作、代码编写、网页搜索、图片生成、定时任务……

💡 它跟 ChatGPT/Copilot 有什么区别？ Hermes 不是一个聊天窗口——它是一个在你的电脑上自主执行任务的智能体。你让它"把桌面整理一下"，它真的会去移动文件。你让它"分析这个 Excel"，它真的会写 Python 脚本去读取和分析。

🔑准备网络环境（科学上网）

⚠️ 重要前提：稳定的国际网络访问 Hermes Agent 的安装脚本、GitHub 代码仓库、以及后续使用的绝大多数 LLM 提供商（OpenRouter、Anthropic、OpenAI 等）的 API 端点都在境外服务器上。如果你在国内直接访问，会遇到 连接超时、下载失败、SSL 错误 等问题。因此， 在开始安装之前，请务必先配置好科学上网环境。

推荐方案：ikuuu 机场

如果你还没有稳定的梯子，这里提供一个经过验证可用、性价比高的方案：

项目	详情
服务名称	ikuuu（机场服务）
注册地址	https://ikuuu.win/auth/register?code=Xpr8
年费	约 ¥108 / 年
支持平台	Windows、macOS、iOS、Android（下载官方客户端即可）
配置方式	下载客户端 → 登录账号 → 开代理，零配置

配置步骤（三步搞定，零配置）

注册账号：打开 ikuuu 注册页面，填写邮箱和密码完成注册。
购买套餐：登录后进入「商店」页面，选择 ¥108/年套餐，支持支付宝/微信支付。
下载客户端并登录：在 ikuuu 网站下载 Windows 客户端，安装后直接登录你的账号，客户端会自动同步节点配置，选择一个节点开启即可——不需要导入订阅、不需要手动设置任何东西。

🎉 新版 ikuuu 体验 现在的 ikuuu 客户端已经做到「登录即用」——下载 → 登录 → 开代理，三步完事。不再需要折腾 Clash 订阅链接、配置文件，对新手极其友好。

💻 PowerShell — 验证代理是否生效

PS C:\> curl.exe -sS https://github.com -o NUL -w "%{http_code}"
200
# ✅ 返回 200 说明代理已生效，可以正常访问 GitHub

# 如果返回 000 或超时，说明代理未开启或节点不可用
PS C:\> curl.exe -sS https://www.google.com -o NUL -w "%{http_code}"
200
# ✅ Google 也能访问，网络环境已就绪

💡 代理配置提示 安装过程中，Hermes 的安装脚本通过 Git 克隆 GitHub 仓库，这个操作会自动走系统代理（如果你用了 Clash 的「系统代理」模式）。后续如果使用 TUN 模式（虚拟网卡），则所有流量都会经过代理，更加无感。

0安装前的准备（Windows）

✅ 好消息：你只需要安装 Git 这一个东西 其他所有依赖（Python 3.11、Node.js、ripgrep、ffmpeg、Chromium）都由 Hermes 安装脚本自动处理，无需手动安装。

系统要求

项目	最低要求	说明
操作系统	Windows 10 1809+ 或 Windows 11	64 位
PowerShell	5.1+（Win10/11 自带）	无需额外安装
Git	2.30+	需要手动安装（下一章讲）
磁盘空间	约 2 GB	含 Python、Node.js、Chromium
网络	需访问 GitHub	国内可能需要代理

关于国内网络环境

⚠️ 如果你在国内且 GitHub 访问慢： 安装脚本需要从 GitHub 克隆仓库（github.com/NousResearch/hermes-agent）。如果直连很慢或失败，请准备一个 HTTP 代理，然后在安装前设置：

💻 PowerShell — 设置代理

PS> $env:http_proxy = "http://127.0.0.1:7890"
PS> $env:https_proxy = "http://127.0.0.1:7890"
# 将 7890 替换为你的代理端口

模型上下文要求

⚠️ 注意：你需要一个上下文 ≥ 64K tokens 的模型 大多数云端模型（Claude、GPT-4、Gemini、Qwen、DeepSeek）都满足。如果使用本地模型（Ollama/llama.cpp），需设置 --ctx-size 65536。

1安装 Git for Windows

这是整个流程中唯一需要你手动安装的软件。

步骤 1：下载

打开浏览器访问 git-scm.com/download/win，点击 "64-bit Git for Windows Setup" 下载安装包。

步骤 2：安装

运行下载的 Git-*-64-bit.exe，大部分选项用默认即可。下面几项建议注意：

安装步骤	建议选择	原因
Select Components	勾选 "Git Bash Here"	会有用
Default editor	选你习惯的编辑器（VSCode / Notepad++）	或保持默认 Vim
Adjusting your PATH	选 "Git from the command line and also from 3rd-party software"	确保 PowerShell 能直接调用 git
HTTPS transport backend	Use the OpenSSL library	兼容性最好
Line ending conversions	"Checkout as-is, commit as-is"	避免 LF/CRLF 乱码
Terminal emulator	Use Windows' default console	在 PowerShell 中更稳定

步骤 3：验证

安装完成后，重新打开一个 PowerShell 窗口，输入：

💻 PowerShell — 验证 Git

PS C:\Users\你的用户名> git --version
git version 2.47.0.windows.1
# ✅ 看到版本号就对了！

2用 PowerShell 一键安装 Hermes

完整安装流程概览

① 管理员运行 PowerShell → ② 设置执行策略 → ③ 运行安装命令 → ④ 等待 3~5 分钟 → ⑤ 完成！

步骤 ①：以管理员身份打开 PowerShell

按 Win + X，选择 "终端（管理员）"
或者在开始菜单搜索 "PowerShell"，右键 → "以管理员身份运行"

步骤 ②：放行脚本执行策略

Windows 默认禁止运行网络下载的 PowerShell 脚本，需要先放行：

💻 PowerShell（管理员）— 设置执行策略

PS C:\WINDOWS\system32> Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

-Force 参数跳过确认，直接执行。不放心的可以去掉它，看到提示输入 Y。

步骤 ③：运行安装命令

复制下面这一行，粘贴到 PowerShell 中，按回车：

💻 PowerShell — 一键安装

PS> iex (irm https://hermes-agent.nousresearch.com/install.ps1)

步骤 ④：看着它自动完成

安装脚本会自动执行以下工作，你不需要干预：

💻 安装过程示意输出

╔══════════════════════════════════════════════╗
║     🕊️  Hermes Agent Installer              ║
║     Nous Research · Windows                 ║
╚══════════════════════════════════════════════╝

✓ PowerShell 5.1+ detected
→ Downloading uv (Python package manager)...
✓ uv installed
→ Installing Python 3.11...
✓ Python 3.11.9 ready
→ Cloning NousResearch/hermes-agent (main branch)...
✓ Repository cloned
→ Creating virtual environment...
✓ venv created
→ Installing Python dependencies...
✓ Dependencies installed (~200 packages)
→ Installing Node.js v22...
✓ Node.js ready
→ Installing Playwright + Chromium...
✓ Browser automation ready

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  🎉 Hermes Agent installed!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

→ Run hermes setup to configure your provider
→ Run hermes to start chatting!

安装选项（按需使用）

选项	什么时候用	完整命令
`-SkipBrowser`	不需要浏览器自动化	`iex (irm .../install.ps1) -SkipBrowser`
`-SkipSetup`	想手动配置，跳过向导	`iex (irm .../install.ps1) -SkipSetup`
`-Branch dev`	安装开发分支	`iex (irm .../install.ps1) -Branch dev`
`-HermesHome "D:\hermes"`	自定义数据目录	`iex (irm .../install.ps1) -HermesHome "D:\hermes"`

安装后的目录结构

安装完成后，你的系统上多了以下路径（都在 %LOCALAPPDATA%\hermes\ 下）：

路径（默认）	内容
`%LOCALAPPDATA%\hermes\hermes-agent\`	源代码 + Python 虚拟环境
`%LOCALAPPDATA%\hermes\config.yaml`	主配置文件
`%LOCALAPPDATA%\hermes\.env`	API 密钥（敏感信息）
`%LOCALAPPDATA%\hermes\skills\`	AI 技能文档
`%LOCALAPPDATA%\hermes\sessions\`	对话记录
`%LOCALAPPDATA%\hermes\logs\`	运行日志
`%LOCALAPPDATA%\hermes\state.db`	SQLite 会话数据库

注意：%LOCALAPPDATA% 通常等于 C:\Users\你的用户名\AppData\Local

💡 想要 Linux 风格路径？ 设置环境变量 HERMES_HOME=C:\Users\你的用户名\.hermes，之后所有配置、技能、会话都会放在 ~/.hermes/ 下（和 Linux 版一致）。

3验证安装

重新打开一个 PowerShell 窗口（不需要管理员），运行以下命令：

💻 PowerShell — 版本检查

PS> hermes --version
Hermes Agent v0.16.0 (2026.6.5) · upstream 86e5efb0

💻 PowerShell — 健康检查

PS> hermes doctor
🔍 Hermes Doctor

System:
  Platform: win32-amd64
  Python:   3.11.9
  Shell:    C:\Program Files\PowerShell\7\pwsh.exe

Config:
  Config:   C:\Users\zhww5\AppData\Local\hermes\config.yaml ✓
  Env:      C:\Users\zhww5\AppData\Local\hermes\.env ✓

Dependencies:
  python3.11 ✓
  git        ✓
  node v22   ✓
  ripgrep    ✓
  ffmpeg     ✓

Install method: git (PowerShell installer)
✓ All checks passed!

🚨 如果提示 hermes: command not found 关闭当前 PowerShell 窗口，重新打开一个即可。安装脚本已自动将 hermes 加入 PATH。

4配置 LLM 提供商

安装完成后，Hermes 还不知道用哪个 AI 模型。你需要配置一个提供商。

方式一：交互式选择（推荐新手）

💻 PowerShell — 选择模型

PS> hermes model

┌──────────────────────────────────────────┐
│       Choose Your AI Provider           │
├──────────────────────────────────────────┤
│  🌐  Nous Portal       (subscription)   │
│  🔷  Anthropic          (Claude)        │
│  🟢  OpenAI Codex       (ChatGPT)       │
│  🔗  OpenRouter         (multi-model)   │
│  🤖  Google AI Studio   (Gemini)        │
│  🐳  DeepSeek           (direct API)    │
│  🏭  火山方舟/阿里云     (国内)          │
│  ⚙️  Custom Endpoint    (自己的)        │
│  ... (20+ providers)                   │
└──────────────────────────────────────────┘

用方向键 ↑↓ 选择，按 Enter 确认，然后按提示输入 API Key 或完成 OAuth 登录。

方式二：国内用户推荐配置

以下提供商在国内网络环境下表现较好：

提供商	命令/环境变量	大致费用
DeepSeek	`$env:DEEPSEEK_API_KEY = "sk-..."`	¥1/M 入，¥2/M 出
火山方舟（字节）	Custom Endpoint：`https://ark.cn-beijing.volces.com/api/v3/`	有 ¥100 试用
阿里云 DashScope	`$env:DASHSCOPE_API_KEY = "sk-..."`	有免费额度
智谱 GLM	`$env:GLM_API_KEY = "..."`	有免费额度
Moonshot/Kimi	`$env:KIMI_API_KEY = "sk-..."`	按量

以 DeepSeek 为例：

💻 PowerShell — 配置 DeepSeek

# 1. 先去 platform.deepseek.com 注册并获取 API Key
# 2. 设置环境变量
PS> $env:DEEPSEEK_API_KEY = "sk-your-api-key-here"

# 3. 告诉 Hermes 用 DeepSeek
PS> hermes config set model.provider deepseek
PS> hermes config set model.default deepseek/deepseek-chat

# 4. 把 API Key 持久化写入 .env（下次启动不用再设）
PS> hermes config set model.api_key sk-your-api-key-here

# 5. 验证
PS> hermes config | findstr provider
  provider: deepseek

以火山方舟（自定义端点）为例：

💻 PowerShell — 配置火山方舟

PS> hermes config set model.provider custom
PS> hermes config set model.default doubao-pro-32k
PS> hermes config set model.base_url https://ark.cn-beijing.volces.com/api/v3/
PS> hermes config set model.api_key your-ark-api-key-here
# 就这四行，完事！

💡 怎么拿到 API Key？ 去对应提供商的官网注册 → 控制台 → API Keys → 创建一个 Key 复制过来。大多数国内提供商（DeepSeek、火山方舟、阿里云）支持支付宝/微信充值。

5第一次对话

配置好提供商后，在 PowerShell 中输入 hermes 进入交互模式：

💻 PowerShell — 第一次对话

PS> hermes

╔══════════════════════════════════════════╗
║        🕊️  Hermes Agent                ║
║        Nous Research                   ║
╚══════════════════════════════════════════╝

Model:    deepseek/deepseek-chat
Provider: deepseek
Context:  65536 tokens
Memory:   active

Type /help for commands, /quit to exit.
──────────────────────────────────────────

> 你好！帮我用 Python 写一个 Hello World

你好！让我来写一个 Python Hello World 程序。

我来创建文件...
✓ Created hello.py

运行结果：
✓ python hello.py → Hello, World!

✅ 搞定！文件在当前目录。

对话中的常用快捷键

操作	快捷键/命令
多行输入	`Ctrl + Enter`（Windows 专用）
退出程序	`/quit` 或 `/exit` 或 `Ctrl+C`
新对话	`/new`
查看帮助	`/help`
切换模型	`/model`
管理工具	`/tools`
跳过确认	`/yolo`（慎用！）

单次查询模式（不进入交互）

💻 PowerShell — 单次查询

PS> hermes chat -q "法国的首都是哪里？"
法国的首都是巴黎（Paris）。

# 用其他模型
PS> hermes chat -q "What's 2+2?" -m anthropic/claude-sonnet-4

⚠Windows 专属注意事项

以下问题只在 Windows 上出现，知道了就不会踩坑。

问题	解释	怎么处理
Alt+Enter 不能换行	Windows Terminal 把 Alt+Enter 截获为全屏切换	用 `Ctrl+Enter` 替代
配置文件的 UTF-8 BOM	用记事本编辑 config.yaml 会引入 BOM，导致启动报错 400	只用 `hermes config edit` 编辑配置
终端工具用 bash 语法	Hermes 在 Windows 上的 terminal 工具通过 bash (git-bash/MSYS) 执行，不是 PowerShell	Agent 发起的命令用 POSIX 语法（`ls` 不是 `dir`）
路径分隔符	反斜杠在代码中需要转义	在 Hermes 中优先用正斜杠：`C:/Users/...`
git-bash 兼容	可以在 git-bash 中运行 hermes	直接在 git-bash 终端输入 `hermes` 即可
防病毒误报	某些杀软可能拦截脚本执行	在 Windows 安全中心添加 `%LOCALAPPDATA%\hermes` 到排除项

⚠️ 如果你是华为 MateBook 用户（Intel Arc 核显）： Arc 核显使用共享内存（约 18GB+2GB），跑 7B Q4 本地模型约 16 t/s。如需本地运行 LLM，推荐用 llama.cpp SYCL 后端（需先装 Intel oneAPI）。

常用命令速查

想做什么	PowerShell 命令
启动对话	`hermes`
单次提问	`hermes chat -q "问题"`
切换模型	`hermes model`
配置向导	`hermes setup`
查看配置	`hermes config`
编辑配置	`hermes config edit`
设置配置	`hermes config set 键值`
健康诊断	`hermes doctor`（加 `--fix` 修复）
管理密钥	`hermes auth`
开关工具	`hermes tools`
浏览技能	`hermes skills browse`
设置网关	`hermes gateway setup`
升级版本	`hermes update`
卸载	`hermes uninstall`

配置文件结构一览

用 hermes config edit 打开的就是下面这个文件（%LOCALAPPDATA%\hermes\config.yaml）：

💻 config.yaml 关键段落

# 模型
model:
  default: deepseek/deepseek-chat
  provider: deepseek
  context_length: 65536

# Agent 行为
agent:
  max_turns: 90

# 终端（local / docker / ssh）
terminal:
  backend: local
  timeout: 180

# 安全（自动隐藏工具输出中的密钥）
security:
  redact_secrets: true

常见问题排查

现象	原因	解决办法
`hermes : 无法将"hermes"项识别为...`	PATH 未刷新	关闭 PowerShell 重开
`API key not set`	没配提供商	运行 `hermes model`
工具不可用	工具集没开	`hermes tools` → 启用 → 重启对话
安装到一半报错	GitHub 连不上	开代理后再试：`$env:https_proxy="http://127.0.0.1:7890"`
`No models provided` (HTTP 400)	config.yaml 含 UTF-8 BOM	用 `hermes config edit` 重新保存
chromium 装不上	网络/权限	加 `-SkipBrowser` 重装，或手动 `npx playwright install chromium`
配置文件改了不生效	需新建会话	退出重进，或用 `/new`

🩺 万能诊断命令 hermes doctor --fix —— 自动检测并修复大部分配置和环境问题。

附录：其他平台快速安装

如果你的朋友用 Linux 或 Mac，把下面这行发给 TA 就行：

Linux / macOS / WSL2

💻 bash

$ curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

前提：系统已安装 Git（sudo apt install git 或 brew install git）。

完成后 source ~/.bashrc 重载 shell。

macOS 备选：Desktop 安装器

访问 hermes-agent.nousresearch.com/desktop 下载 .dmg 安装包，双击即装。

Android (Termux)

见官方 Termux 安装指南。

下一步做什么

熟悉基础操作：和 Hermes 多聊几次，让它帮你执行终端命令、创建文件、搜索项目。

安装社区技能（可选）：

💻 PowerShell

PS> hermes skills browse
# 浏览技能市场，找到需要的就安装
PS> hermes skills install github-pr-workflow

连接消息平台（可选）：hermes gateway setup → 绑定 Telegram / Discord / 微信。
创建定时任务（可选）：hermes cron create "every day 9am"，让 Hermes 定时执行任务。
多 Profile 隔离：hermes profile create work 创建工作专属环境。

🪽Hermes Agent 安装教程

📑 目录

认识 Hermes Agent

核心价值（用 Windows 用户的话说）

🔑准备网络环境（科学上网）

推荐方案：ikuuu 机场

配置步骤（三步搞定，零配置）

0安装前的准备（Windows）

系统要求

关于国内网络环境

模型上下文要求

1安装 Git for Windows

步骤 1：下载

步骤 2：安装

步骤 3：验证

2用 PowerShell 一键安装 Hermes

完整安装流程概览

步骤 ①：以管理员身份打开 PowerShell

步骤 ②：放行脚本执行策略

步骤 ③：运行安装命令

步骤 ④：看着它自动完成

安装选项（按需使用）

安装后的目录结构

3验证安装

4配置 LLM 提供商

方式一：交互式选择（推荐新手）

方式二：国内用户推荐配置

以 DeepSeek 为例：

以火山方舟（自定义端点）为例：

5第一次对话

对话中的常用快捷键

单次查询模式（不进入交互）

⚠Windows 专属注意事项

常用命令速查

配置文件结构一览

常见问题排查

附录：其他平台快速安装

Linux / macOS / WSL2

macOS 备选：Desktop 安装器

Android (Termux)

下一步做什么

更多资源

评论