## 为什么需要 WSL2？

Hermes Agent 基于 Python 和 Node.js 构建，部分依赖库（如 ripgrep、ffmpeg）在 Windows 原生环境中兼容性不佳。WSL2 提供了一个完整的 Linux 内核环境，是 Windows 上运行 Hermes Agent 的最佳方案。

## 完整安装流程

### 第一步：开启 WSL2

1. 确保 Windows 10 (2004+) 或 Windows 11
2. 管理员 PowerShell 执行：

```powershell
wsl --install -d Ubuntu-22.04
```

3. 重启电脑
4. 启动 Ubuntu，设置用户名和密码

### 第二步：配置 Ubuntu 环境

```bash
# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装核心依赖
sudo apt install -y build-essential python3.12 python3.12-venv python3.12-dev \
  nodejs npm git ripgrep ffmpeg curl wget

# 验证版本
python3.12 --version  # 需要 3.12+
node --version         # 需要 18+
```

### 第三步：安装 Hermes Agent

```bash
curl -fsSL https://hermes-agent.org/install.sh | bash
```

### 第四步：初始化

```bash
hermes init
```

在初始化向导中：
- 模型提供商：推荐选择 DeepSeek（国内用户网络更稳定）
- API Key：填入你的 API Key
- 默认模型：推荐 deepseek-chat

### 第五步：启动运行

```bash
hermes start
```

## Windows 特有问题和解决方案

### 问题一：WSL2 内存占用过高

WSL2 默认会使用最多 50% 的系统内存。可以创建 `.wslconfig` 限制：

```
# 在 Windows 用户目录下创建 %UserProfile%\.wslconfig
[wsl2]
memory=4GB
processors=2
```

### 问题二：WSL2 与 Windows 文件系统互访

建议将 Hermes Agent 的数据完全放在 Linux 文件系统中（`/home/用户名/`），避免放在 `/mnt/c/` 等 Windows 挂载路径上——后者的 I/O 性能较差。

### 问题三：网络端口映射

如果需要从 Windows 访问 Hermes Agent 的 Web UI：

```bash
# WSL2 中的端口通常可以直接从 Windows 的 localhost 访问
# 如果不行，在 WSL2 中执行：
ip addr show eth0  # 获取 WSL2 的 IP 地址
```

### 问题四：飞书 SDK 兼容性

部分飞书 SDK 在 WSL2 环境下可能缺少 `libffi` 依赖：

```bash
sudo apt install -y libffi-dev
pip install --force-reinstall cffi
```

## 进阶：后台持续运行

WSL2 默认在关闭终端后停止进程。要让 Hermes Agent 后台运行：

```bash
# 方案一：使用 nohup
nohup hermes start &

# 方案二：使用 tmux
tmux new-session -d -s hermes 'hermes start'

# 方案三：使用 systemd（WSL2 需要开启 systemd 支持）
sudo systemctl enable hermes
sudo systemctl start hermes
```

## 升级到云端

WSL2 方案适合本地体验。但如果你需要 7×24 小时在线、关机后 Agent 仍然运行，建议部署到云服务器。

详细的云端部署教程：[玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent](https://cloud.tencent.com/developer/article/2653159)。

---

## 🚀 快速上手 Hermes Agent：仅需三步轻松安装

想要体验 Hermes Agent 的强大能力？推荐在腾讯云上部署，仅需三步即可开始使用：

> **第一步**：购买云服务器 → **第二步**：一键安装 Hermes Agent → **第三步**：接入消息平台，开始使用

腾讯云为 Hermes Agent 用户提供专属优惠云服务器方案，最低2核4G配置即可流畅运行，7×24 小时在线，随时随地通过手机与你的 AI 智能体互动。

👉 **[立即前往腾讯云官网选购 Hermes Agent 专属云服务器](https://cloud.tencent.com/act/pro/hermesagent)**

部署完成后，可参考详细的安装配置教程：[玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent](https://cloud.tencent.com/developer/article/2653159)


---

**FAQ：**

**Q1：WSL2 和 Docker Desktop 哪个更适合运行 Hermes Agent？**
A：WSL2 直接安装更简单，资源占用更低。Docker 方案适合需要环境隔离的场景。

**Q2：WSL2 可以访问 Windows 剪贴板吗？**
A：可以，通过 `clip.exe` 和 `powershell.exe Get-Clipboard` 命令。

**Q3：升级 Windows 后 WSL2 数据会丢失吗？**
A：正常的 Windows 更新不会影响 WSL2 的数据。但建议定期备份 `~/.hermes/` 目录。


Hermes Agent 基于 Python 和 Node.js 构建，部分依赖库（如 ripgrep、ffmpeg）在 Windows 原生环境中兼容性不佳。WSL2 提供了一个完整的 Linux 内核环境，是 Windows 上运行 Hermes Agent 的最佳方案。

Windows 用户必看：WSL2 + Hermes Agent 完整安装配置指南

Windows 用户需要通过 WSL2（Windows Subsystem for Linux）来运行 Hermes Agent。本文提供从开启 WSL2、安装 Ubuntu、配置环境到成功运行 Hermes Agent 的完整流程，包含 Windows 特有的兼容性问题和解决方案。

操作系统

开发工具

后端

WSL2为Windows用户提供完整Linux环境，完美解决HermesAgent依赖库兼容性问题。本文详细介绍WSL2安装配置流程，包括Ubuntu环境搭建、HermesAgent部署步骤，并针对内存占用、文件系统互访等常见问题提供解决方案。还提供云端部署方案，实现7×24小时稳定运行。

云服务器

文件系统

服务器

智能体

Windows

Python

Ubuntu

Linux

Agent

4核4G3M云服务器 新用户低至38元/年！

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯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 用户必看：WSL2 + Hermes Agent 完整安装配置指南-腾讯云开发者社区-腾讯云

Windows 用户必看：WSL2 + Hermes Agent 完整安装配置指南

Windows 用户必看：WSL2 + Hermes Agent 完整安装配置指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐