*2026年5月9日

Hermes 终于能在 Windows 上原生跑了。

这让大家等了好久，之前想在 Windows 上用 Hermes，要么装 WSL2，要么走 Docker，要么折腾 Cygwin。每一条路都能通，但每一条路都有额外的摩擦——WSL2 要开虚拟化、Docker 要占资源、Cygwin 更是老古董。很多人卡在”装环境”这一步就放弃了。

现在官方终于给 Windows 原生做了兼容，一行命令直接安装，比以前安装真的方便太多了。

注意：Windows 原生目前处于内测阶段，可能会遇到一些问题

#安装方式

非常简单，打开 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。

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

hermes setup

按需进行模型、消息网关的配置，在这里就不详细赘述了。

开启对话命令：

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 体验是一样的，这个 tab 缺了影响不大。

#它是怎么在 Windows 上跑命令的

这个设计挺聪明。Hermes 在 Windows 上通过 Git Bash 执行所有 shell 命令，跟 Claude Code 用的是同一套策略。

这样做的好处是：所有原本针对 Linux/macOS 写的工具脚本、skill、terminal 命令，不需要重写就能在 Windows 上跑。Hermes 通过 Git Bash 把 POSIX 和 Windows 之间的鸿沟直接跨过去了。

安装器会自动配好 Git Bash 的路径。如果你机器上已经有 Git for Windows，它会直接用已有的；没有的话，它会下一个 45MB 左右的 PortableGit，放在 %LOCALAPPDATA%\hermes\git 目录下，不污染你的系统。

#Gateway 开机自启

Windows 上 Hermes 的 gateway 用的是计划任务（Scheduled Task）实现自启，不需要管理员权限：

hermes gateway install

它会在你登录时自动启动 gateway，登出时自动关闭。如果计划任务被组策略拦了，会降级到开始菜单启动文件夹的方式。

用 pythonw.exe 启动 gateway 进程——没有控制台窗口，也不会被你在其他终端里按 Ctrl+C 误杀。这个细节之前坑过不少人。

#数据存储位置

安装器把代码和运行环境放在 %LOCALAPPDATA%\hermes\ ，这个目录随时可以删掉重装，属于”可丢弃的基础设施”。

你的配置、认证、skill、会话记录、日志放在 %USERPROFILE%\.hermes\ ，跟 Linux/macOS 上的目录结构一模一样。重装 Hermes 不会丢数据。

两个目录分离得很清楚：装环境的归装环境，存数据的归存数据。

#UTF-8 的坑它帮你填了

Windows 控制台默认用的是 cp1252 或 cp437 编码，跑 Hermes 的时候很容易遇到 UnicodeEncodeError 。安装器在每个入口点都会自动把控制台切成 UTF-8（CP 65001），还会设好 PYTHONIOENCODING 和 PYTHONUTF8 环境变量。

如果你不需要这个，修改 HERMES_DISABLE_WINDOWS_UTF8=1 可以关掉。

#编辑器默认用记事本

在 Linux/macOS 上按 Ctrl-X Ctrl-E 可以打开编辑器写长 prompt。Windows 上之前这个功能是废的——prompt_toolkit 硬编码了一堆 POSIX 路径，在 Windows 上全部找不到。

现在 Hermes 会自动把 EDITOR 设成 notepad 。当然你也可以换成 VS Code：

$env:EDITOR = "code --wait"

那个 --wait 很关键，不加的话 VS Code 会立刻返回，Hermes 拿到的是空内容。

#原生 vs WSL2，怎么选

我的个人建议是：先试试原生。

功能对比：原生 Windows vs WSL2

功能	原生 Windows	WSL2
CLI / TUI	✅	✅
Gateway 消息网关	✅	✅
定时任务	✅	✅
浏览器自动化	✅	✅
MCP 工具链	✅	✅
Ollama 本地模型	✅	✅
Web 管理面板	✅	✅
面板内嵌终端	❌	✅
开机自启	✅ (schtasks)	✅ (systemd)

除了面板内嵌终端这一个点，其他功能已经和 WSL2 平齐。

原生安装的好处是轻量、无额外依赖、跟 Windows 生态融合得好。绝大多数功能已经跑通了。如果你的使用场景不涉及 Dashboard 嵌入式终端、复杂的 fork 语义或者 Linux 专属的文件监听，原生完全够用。

如果你跑了一圈发现确实需要 POSIX 环境，WSL2 随时装。两个方案可以共存：原生数据在 %LOCALAPPDATA%\hermes ，WSL2 数据在 ~/.hermes ，互不干扰。

不过得提醒一句：官方标注的是 Early Beta 。subprocess 处理、路径细节、非 ASCII 控制台输出这些地方可能还有毛边。遇到问题记得去 GitHub 提 issue，附上复现步骤。

# 写在最后

Hermes 这次做原生 Windows 支持，技术上解决的核心问题就一个：让 Windows 用户”装了就能用”，不需要先学什么是 WSL、什么是 Docker、什么是虚拟化。

一行命令、不要管理员权限、自动配好所有依赖——这个安装体验在 AI Agent 工具里算得上第一梯队了。

对于之前因为环境问题一直没入坑 Hermes 的 Windows 用户，现在是最好的时机。

不过，由于还处于内测阶段，肯定或多或少的遇到些问题，希望大家能够包容一下，给 Hermes 一点时间～

Hermes Desktop：全平台原生AI智能代理桌面客户端

🤖 开源干货｜Hermes Desktop：可视化管控Hermes Agent，一站式AI智能代理桌面解决方案

在AI智能体快速迭代的当下，多数高级AI代理工具依赖命令行操作，部署繁琐、配置门槛高、可视化能力缺失。本期给大家深度解析一款优质开源项目——Hermes Desktop，一款专为Hermes Agent打造的原生桌面客户端，彻底替代CLI命令行，以图形化界面完成AI代理的部署、配置、交互与运维，为开发者与AI从业者提供轻量化、全流程、可本地化的智能代理管控方案。

项目开源地址：https://github.com/fathah/hermes-desktop

---

📑 项目基础概况

1. 项目定位

Hermes Desktop 是一款跨平台原生桌面应用，核心用途为安装、配置、调度Hermes Agent智能助手。Hermes Agent 具备自我迭代优化、多工具调用、跨平台消息收发、闭环自主学习四大核心能力。项目摒弃传统命令行管控模式，整合部署安装、服务商配置、日常交互、运维管理全流程，自动执行官方安装脚本，将程序数据统一存储于 ~/.hermes 固定目录。

2. 开发状态

项目目前处于积极迭代开发阶段，功能持续更新优化，存在部分不稳定特性。开发者开放社区交互通道，支持用户提交漏洞反馈、功能建议，同时欢迎开发者参与代码贡献；项目内置英文、简体中文双语文档，降低全球用户使用门槛。

---

💻 全平台适配：安装部署与兼容解决方案

该客户端全面覆盖主流桌面操作系统，针对不同系统提供专属安装包，同时解决证书未签名引发的系统拦截问题，适配性极强。

1. 安装包格式适配

操作系统	安装格式	补充安装方式
Windows	exe（NSIS安装程序）	支持winget命令安装（审核通过后）
macOS	dmg	无额外命令，需手动放行权限
Linux(通用)	AppImage	/
Linux(Debian)	deb	/
Linux(Fedora)	rpm	需跳过GPG校验

2. 系统拦截问题解决方案

• Windows：安装包无代码签名，首次启动被SmartScreen拦截，点击「更多信息」→「仍要运行」即可放行。
  
• macOS：未进行公证签名，系统默认拦截，可执行命令 xattr -cr "/Applications/Hermes Agent.app" 解除限制，或右键手动打开放行。
  
• Fedora：RPM包无GPG签名，安装需追加指令 --nogpgcheck；该格式不支持自动更新，新版本需手动重装。
  

---

⚙️ 核心功能体系，覆盖全使用场景

1. 部署架构：本地+远程双模式

支持双重后端部署逻辑，灵活性拉满：本地部署默认占用 127.0.0.1:8642 端口，程序自动检测环境、处理Git、Python等依赖；远程部署仅需填写API地址与密钥，快速连接私有服务器，无需本地部署环境。

2. AI交互与管控能力

• 流式对话：基于SSE流式传输协议，搭载Markdown渲染、代码高亮、工具进度可视化面板；
  
• 用量统计：实时统计提示词、生成令牌数量，可视化展示计费成本，内置22条斜杠快捷指令，简化高频操作；
  
• 记忆与人设：内置AI记忆系统，支持编辑记忆条目、配置用户档案，可通过SOUL.md文件自定义智能助手人格；
  
• 环境隔离：多配置档案一键切换，不同环境配置相互独立，避免参数混淆。
  

3. 高级拓展工具生态

• 工具集：内置14类工具，涵盖网页抓取、代码执行、图像生成、终端调试、任务规划等能力；
  
• 消息网关：对接16类主流平台，包含钉钉、企业微信、Telegram、Discord等，实现跨平台消息联动；
  
• 定时任务：可视化Cron定时任务编辑器，支持自定义执行周期，搭配15种推送渠道；
  
• 运维工具：自带数据备份恢复、运行日志查看、系统诊断导出、版本自动更新功能。
  

---

🔍 运行逻辑与页面架构

1. 初始化运行流程

首次启动应用时，程序引导用户选择部署模式→校验运行环境→配置大模型服务商→保存密钥与配置文件→进入主工作区；本地模式依托本地端口传输请求，远程模式通过私有API链路交互，全程流式解析返回数据。

2. 功能页面划分

应用模块化拆分12类功能页面，逻辑规整、分工明确：涵盖聊天交互、会话检索、代理管理、技能插件、模型配置、记忆编辑、人设修改、工具开关、定时任务、网关配置、3D可视化办公、系统设置，全方位覆盖AI代理管控需求。

---

🛠️ 技术架构与开发指南

1. 核心技术栈

采用成熟现代化技术搭建，兼容性与稳定性优异：Electron 39跨平台框架、React 19前端架构、TypeScript 5.9静态类型校验、Tailwind CSS 4样式框架；搭配Vite构建工具、better-sqlite3本地数据库、i18n国际化组件、Vitest自动化测试套件。

2. 开发前置要求

• 基础环境：安装Node.js、Git；
  
• 运行环境：类Unix终端环境，适配Hermes安装脚本；
  
• 网络要求：可正常拉取项目依赖及核心程序包，支持镜像源适配受限网络。
  

3. 常用开发命令

# 安装依赖npm install# 开发模式启动npm run dev# 代码检测校验npm run lint && npm run typecheck# 分平台打包npm run build:win / build:mac / build:linux

---

🌐 生态兼容体系

1. 大模型服务商适配

兼容OpenAI、Anthropic、Google Gemini、xAI Grok、通义千问等十余款主流商用大模型；同时原生适配LM Studio、Ollama、vLLM等本地开源模型端点，兼顾商用API与本地化部署双重需求。

2. 第三方资源集成

深度集成搜索、图像生成、浏览器调试、向量记忆等第三方工具，包含Exa Search、FAL.ai、Honcho等，拓展AI代理综合执行能力。

---

🎯 适用人群

• AI开发者：可视化调试AI代理，简化模型配置、工具调用、日志排查流程；
  
• 本地部署爱好者：一键搭建本地AI运行环境，数据本地化存储，保障隐私安全；
  
• 自动化运维人员：依托定时任务、消息网关，搭建自动化工作流；
  
• 开源贡献者：项目开源透明，注释完善，支持二次开发与功能拓展。
  

---

📝 总结

Hermes Desktop 精准解决了传统AI代理命令行操作繁琐、配置门槛高、可视化缺失、生态割裂的痛点，以轻量化原生客户端实现部署、交互、运维、拓展一体化管控。全平台适配、多模型兼容、完善的开发体系、开放的社区生态，使其成为本地AI代理部署的优质开源工具。