Skip to content

Hermes Agent原生Windows支持:一行命令安装完整教程

2026年5月9日

Hermes 终于能在 Windows 上原生跑了。这让大家等了好久,之前想在 Windows 上用 Hermes,要么装 WSL2,要么走 Docker,要么折腾 Cygwin。现在官方终于给 Windows 原生做了兼容,一行命令直接安装。

安装方式

非常简单,打开 PowerShell,粘贴这一行:

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

等它跑完,开一个新的终端,就可以使用 hermes 命令了。

整个过程不需要管理员权限,不需要装 Python、Node.js、Git——安装器全部帮你搞定。

它会依次装好:

  • uv(Python 包管理器)
  • Python 3.11
  • Node.js 22
  • PortableGit

然后把 Hermes 代码拉下来、建好虚拟环境、装好依赖、配好 PATH。

基本配置

装完之后运行下面命令进行基本配置:

powershell
hermes setup

按需进行模型、消息网关的配置。

开启对话命令:

powershell
hermes chat

支持的功能

功能状态
CLI 命令(hermes chat、hermes setup、hermes gateway 等)
交互式 TUI(hermes --tui)
消息网关(Telegram、Discord、Slack、WhatsApp、15+ 平台)
定时任务调度器
浏览器工具(Chromium)
MCP 服务器(stdio 和 HTTP)
本地模型(Ollama / LM Studio / llama-server)
Web Dashboard(会话、任务、指标、配置)
Dashboard 内嵌终端面板❌(需要 POSIX PTY)
开机自启(Windows 计划任务)

基本上你能想到的功能都支持了。

唯一缺的是 Dashboard 里那个嵌入式终端——它需要 POSIX 伪终端,Windows 原生没有这个东西。但用 PowerShell 或者 Windows Terminal 跑 hermes chat 体验是一样的。

技术原理

Gateway 消息网关

powershell
hermes gateway telegram --api-key YOUR_API_KEY
hermes gateway discord --token YOUR_DISCORD_TOKEN

支持 15+ 平台:Telegram、Discord、Slack、WhatsApp、Line、飞书、微信等。

本地模型支持

powershell
# Ollama
hermes setup --model-type ollama --model-name codellama

# LM Studio
hermes setup --model-type lm-studio --endpoint http://localhost:1234

MCP 服务器

powershell
# STDIO 模式
hermes mcp add my-server --stdio --command "npx"

# HTTP 模式
hermes mcp add my-server --http --url http://localhost:3000

数据存储

Windows 原生版的数据存储在用户目录下:

%APPDATA%\hermes-agent\
├── config.yaml      # 配置文件
├── models/         # 模型缓存
├── sessions/       # 对话记录
└── logs/           # 日志文件

已知坑

UTF-8 编码问题

如果遇到中文乱码,在 PowerShell 里设置:

powershell
$env:LANG = "zh_CN.UTF-8"

或者修改注册表:

powershell
Set-ItemProperty -Path "HKCU:\Console" -Name CodePage -Value 65001

PATH 配置

如果 hermes 命令找不到,手动添加到 PATH:

powershell
$env:PATH += ";$env:APPDATA\hermes-agent\bin"

编辑器推荐

如果想在 VS Code 或 Cursor 里用 Hermes:

json
{
  "hermes.serverPath": "%APPDATA%\\hermes-agent\\bin\\hermes",
  "hermes.model": "claude-sonnet-4"
}

一句话

Windows 用户终于可以一键安装 Hermes 了,不用再折腾 WSL2 或 Docker。

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来