一、关于 Hermes Agent

Hermes Agent 是 Nous Research 开源的 AI Agent 框架，运行在终端中，支持代码编写、逆向分析、系统管理、内容创作等。可对接微信/飞书/Telegram/Discord 等 15+ 平台。

• GitHub：https://github.com/NousResearch/hermes-agent
• 官方文档：https://hermes-agent.nousresearch.com/docs/
• 支持模型：Claude / GPT / Gemini / DeepSeek / Qwen / MiniMax / Kimi 等 20+ 提供商

二、Windows 上两种安装方式

方式一：WSL2 安装（推荐）

步骤 1：安装 WSL2

以管理员身份打开 PowerShell，执行：

# 安装 WSL2（需重启）
wsl --install

步骤 2：在 WSL2 中安装 Hermes

在 Ubuntu 终端中执行一行命令：

复制以下命令，粘贴到 Ubuntu 终端里（粘贴快捷键是 鼠标右键点击 或 Ctrl+Shift+V），按回车：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

或者

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

步骤 3：刷新 Shell

source ~/.bashrc
# 或 source ~/.zshrc

步骤 4：选择模型提供商

hermes model

交互式选择你的 AI 提供商。新手推荐：

填入 API Key 后，配置会自动保存到 ~/.hermes/.env。

步骤 5：开始使用

hermes # 经典 CLI 界面
hermes --tui # 现代 TUI（推荐，支持鼠标）

步骤 6：验证安装

测试几个基本操作：

# 1. 确认模型工作
在终端中随便聊一聊

# 2. 确认 session 恢复
hermes --continue # 恢复上次对话

# 3. 运行健康检查
hermes doctor # 诊断配置、依赖是否正常

方式二：原生 Windows 安装（PowerShell）

步骤 1：打开 PowerShell

不需要管理员权限。普通 PowerShell 或 Windows Terminal 即可。

步骤 2：执行安装

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

安装器做了什么？

按顺序自动完成：

参数选项

# 跳过虚拟环境（高级）
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1))) -NoVenv

# 跳过配置向导
& ([scriptblock]::Create((irm ...))) -SkipSetup

# 自定义数据目录
& ([scriptblock]::Create((irm ...))) -HermesHome "D:\hermes-data"

步骤 3：重启终端

关闭当前 PowerShell，打开新窗口让 PATH 生效。

步骤 4：选择模型

hermes model

步骤 5：开始使用

hermes

三、Windows 原生版的功能矩阵

四、Windows 特定注意事项

1. Git Bash 路径解析

Hermes 在 Windows 上通过 Git Bash 执行 shell 命令。解析顺序：

1. HERMES_GIT_BASH_PATH 环境变量
2. %LOCALAPPDATA%\hermes\git\usr\bin\bash.exe（安装器管理的 PortableGit）
3. %ProgramFiles%\Git\bin\bash.exe（系统 Git-for-Windows）
4. PATH 上的任何 bash.exe

安装器会自动设置 HERMES_GIT_BASH_PATH。

2. UTF-8 控制台

Hermes 启动时会自动切换控制台编码到 UTF-8。如果遇到编码乱码，可手动关闭：

$env:HERMES_DISABLE_WINDOWS_UTF8 = "1"

3. 编辑器

Windows 下默认编辑器为 notepad。Ctrl-X Ctrl-E 或 /edit 会打开记事本。

4. 目录结构

五、安装后常用命令

六、常见问题

七、总结对比