
## 为什么你需要在 Windows 上运行 Hermes Agent？

Hermes Agent 是当前最前沿的**开源 AI 智能体框架**之一，其最大亮点是具备 **“自我进化”能力**——它不仅能完成你交代的任务，还能在执行过程中**自动生成新技能并写入 MEMORY.md**，实现持续学习。无论你是开发者、数据分析师、内容创作者还是普通用户，Hermes 都能成为你的超级生产力助手。

而 **Windows 作为全球最主流的桌面操作系统**，支持 Hermes Agent 的完整部署，意味着数亿用户无需切换系统即可体验下一代 AI 工作流。

---

## 一、部署方式全景对比：原生 PowerShell vs WSL2

| 维度 | **原生 PowerShell 部署** | **WSL2（Ubuntu）部署** |
|------|--------------------------|------------------------|
| **适用人群** | 新手、快速体验者、非开发者 | 开发者、长期使用者、追求稳定性 |
| **安装速度** | ⚡ 极快（一键脚本） | 中等（需先配置 WSL2） |
| **兼容性** | 良好（90%+ 功能正常） | ✅ 极佳（近乎原生 Linux） |
| **本地模型支持** | 支持 Ollama / LM Studio | 完整支持 Ollama + Docker |
| **浏览器自动化** | 直接调用 Windows Chrome/Edge | 需指定 `/mnt/c/` 路径 |
| **文件系统访问** | 原生 Windows 路径 | 通过 `/mnt/c/` 访问 Windows 文件 |
| **社区推荐度** | ⭐⭐⭐☆ | ⭐⭐⭐⭐⭐ |

> 💡 **决策建议**：  
> - 想 **5 分钟内跑起来**？选 **原生 PowerShell**。  
> - 想 **长期使用、集成 GitHub/MCP、跑复杂任务**？选 **WSL2**。

---

## 二、方法一：原生 Windows 部署（PowerShell 一键安装）

### 步骤 1：准备环境（管理员权限）

1. 按 `Win + X` → 选择 **“终端(管理员)”**。
2. 执行策略设置（允许脚本运行）：
   ```powershell
   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   ```

### 步骤 2：执行官方安装脚本

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

> 📌 脚本会自动：
> - 安装 Python 3.10+、Git、Node.js、ripgrep
> - 克隆仓库到 `%LOCALAPPDATA%\hermes\hermes-agent`
> - 创建 Python 虚拟环境
> - 将 `hermes.exe` 加入 PATH

### 步骤 3：配置模型（以 OpenRouter 为例）

安装完成后自动进入 `hermes setup` 向导：

1. 选择 **Quick setup**
2. 选择 **OpenRouter**
3. **粘贴 API Key**（无回显，正常！）
   - 获取地址：[https://openrouter.ai/settings/keys](https://openrouter.ai/settings/keys)
   - 推荐模型：`anthropic/claude-3.5-sonnet`（强推理）或 `openai/gpt-4o`（全能）

### 步骤 4：验证 & 启动

```bash
hermes --version    # 查看版本
hermes              # 进入交互式 CLI
```

---

## 三、方法二：WSL2 部署（开发者首选）

### 步骤 1：启用 WSL2（仅需一次）

```powershell
# 启用组件
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
# 重启电脑后，设置默认版本
wsl --set-default-version 2
```

### 步骤 2：安装 Ubuntu 22.04

- 打开 **Microsoft Store** → 搜索 **“Ubuntu 22.04 LTS”** → 安装
- 首次启动时设置 **Linux 用户名/密码**

### 步骤 3：在 Ubuntu 中安装 Hermes

```bash
sudo apt update && sudo apt install -y python3-pip git curl
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
```

> 🔧 **浏览器自动化配置（WSL2 专用）**  
> 编辑 `~/.hermes/config.yaml`，添加：
> ```yaml
> tools:
>   browser:
>     executable_path: "/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
> ```

---

## 四、核心配置详解（`config.yaml`）

### 1. 模型配置（支持多平台）

```yaml
model:
  # 方案A：OpenRouter（聚合百种模型）
  provider: custom
  base_url: "https://openrouter.ai/api/v1"
  api_key_env: "OPENROUTER_API_KEY"
  model_name: "anthropic/claude-3.5-sonnet"

  # 方案B：Ollama（本地运行 Llama 3.1 / Mistral 等）
  # provider: ollama
  # model_name: "llama3.1:8b"
  # base_url: "http://localhost:11434"
```

### 2. 工具启用（按需开启）

```yaml
tools:
  code_interpreter: { enabled: true, timeout: 120 }   # Python 执行
  browser: { enabled: true }                          # 自动化浏览
  file_system:                                        # 文件读写
    enabled: true
    allowed_directories: ["~", "./projects"]
```

### 3. 安全与记忆

```yaml
approvals:
  mode: "manual"  # 高危操作需手动确认

memory:
  memory_enabled: true        # 启用 MEMORY.md
  user_profile_enabled: true  # 启用 USER.md（构建你的画像）
```

---

## 五、高级技巧与故障排查

### 🔑 密钥安全管理（必做！）

- **不要**在 `config.yaml` 中写明 API Key！
- **正确做法**：使用环境变量
  - **PowerShell**:
    ```powershell
    [Environment]::SetEnvironmentVariable("OPENROUTER_API_KEY", "sk-or-v1-...", "User")
    ```
  - **WSL2 (Bash)**:
    ```bash
    echo 'export OPENROUTER_API_KEY="sk-or-v1-..."' >> ~/.bashrc && source ~/.bashrc
    ```

### 🐞 常见问题

- **Q：`hermes` 命令未识别？**  
  A：检查 PATH，或重启终端。

- **Q：浏览器打不开？**  
  A：确保 Chrome/Edge 已安装，并关闭所有实例后再试。

- **Q：WSL2 中无法联网？**  
  A：检查 Windows 防火墙设置。

---

## 六、总结：开启你的 AI 智能体时代

通过本指南，你已在 Windows 上成功部署了 **Hermes Agent** —— 一个能**自我进化、自动编程、操控浏览器、理解你习惯**的下一代 AI 助手。

> **下一步行动建议**：
> 1. 给它一个复杂任务（如：“分析我上周的支出 CSV 并生成可视化报告”）
> 2. 观察它如何分解步骤、调用工具、甚至**自动生成新技能**
> 3. 查看 `~/.hermes/MEMORY.md`，见证它的“成长”

现在，你不再只是在使用 AI，而是在**培养一个专属的数字智能体伙伴**。

Hermes Agent 是当前最前沿的开源 AI 智能体框架之一，其最大亮点是具备 “自我进化”能力——它不仅能完成你交代的任务，还能在执行过程中自动生成新技能并写入 MEMORY.md，实现持续学习。无论你是开发者、数据分析师、内容创作者还是普通用户，Hermes 都能成为你的超级生产力助手。

Windows 下部署与配置 Hermes Agent 完全指南：AI 智能体、OpenRouter、LLM、本地大模型、WSL2、自动化、自进化 AI

Hermes Agent 是一个面向 Windows 和 WSL2 平台的 AI 智能体核心项目，具备自进化能力，支持自动化任务、代码解释与浏览器控制。它兼容多种主流大语言模型（如 Claude 3.5 Sonnet、GPT-4o、Llama 3.1），并通过 OpenRouter、Ollama 等实现灵活的模型接入。项目支持本地大模型运行与私有化部署，强调低成本 API 调用，适用于开发者工具场

人工智能

开发工具

操作系统

HermesAgent是强大的开源AI智能体框架，支持Windows原生和WSL2两种部署方式。原生PowerShell安装简单快捷，适合新手；WSL2部署更稳定，适合开发者。支持OpenRouter和本地模型，具备代码执行、浏览器自动化等功能，能自动学习并记录新技能到MEMORY.md，是提升生产力的智能助手。

文件系统

防火墙

智能体

Windows

Python

GitHub

Ubuntu

Linux

2026采购季 | AI焕新·智启新局

llmsgw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Windows 下部署与配置 Hermes Agent 完全指南：AI 智能体、OpenRouter、LLM、本地大模型、WSL2、自动化、自进化 AI-腾讯云开发者社区-腾讯云

Windows 下部署与配置 Hermes Agent 完全指南：AI 智能体、OpenRouter、LLM、本地大模型、WSL2、自动化、自进化 AI

Windows 下部署与配置 Hermes Agent 完全指南：AI 智能体、OpenRouter、LLM、本地大模型、WSL2、自动化、自进化 AI

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐