【大模型智能体实战】Hermes-Windows 部署完全指南：Docker / WSL2 / 本地源码 三种路线实测

Hermes Agent Windows 部署完全指南Docker / WSL2 / 本地源码 三种路线实测适合 Windows 10/11 用户国内网络环境建议全程开启代理本文提供三种安装路线根据你的需求选择一条即可。官方资源资源地址GitHub 仓库https://github.com/NousResearch/hermes-agent官方文档https://hermes-agent.nousresearch.com/docs中文社区https://hermesagent.org.cnRelease 下载https://github.com/NousResearch/hermes-agent/releases前言Hermes Agent是一个开源的命令行 AI 智能体框架支持接入多种大模型Kimi、OpenAI、本地 Ollama 等具备浏览器自动化、会话管理、工具调用等能力。你可以把它理解为一个能执行任务的 AI 助手非常适合开发者、运维人员和 AI 爱好者。本文提供三种安装路线Docker最稳定、隔离性好适合快速体验推荐新手WSL2原生 Linux 环境性能好适合长期使用本地源码灵活可控适合二次开发30秒选型我该走哪条路线电脑没装过 WSL/Docker只想快速体验→ 路线一 Docker10分钟搞定打算长期使用需要保存对话和文件→ 路线二 WSL2数据永久保存想改源码、二次开发、装插件→ 路线三 本地源码先决条件自检安装前必做任一项不通过先解决对应问题不要直接跳到安装步骤。检查项命令通过标准Dockerdocker --version显示版本号WSL2wsl --status默认版本: 2Pythonpython -V3.10 或 3.11Gitgit -v有输出路线一Docker 部署推荐最稳定步骤 1启动 Docker Desktop确保 Docker Desktop 状态为Running绿色图标。如果未安装请前往 Docker 官网下载安装。步骤 2运行 Ubuntu 容器带数据持久化dockerrun-it--namehermes-ubuntu-vhermes_data:/root/.hermes ubuntu:22.04bash-v hermes_data:/root/.hermes创建 Docker 卷存放配置和会话删除容器后数据不丢失容器默认以 root 身份运行无需创建新用户步骤 3安装基础依赖aptupdateaptinstall-ycurlgitpython3 python3-pip python3-venv nodejsnpm步骤 4安装 Hermes国内镜像curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash等待安装完成看到如下界面即成功步骤 5加载环境变量bashsource~/.bashrc步骤 6首次配置向导hermes选择 Terminal Backend选 Local选择 Messaging Platform选 Skip配置完成界面Model provider配置可用的大模型api本例选kimi填入 API Keyhttps://platform.moonshot.cn 获取步骤 7启动成功看到 Hermes Agent 大字和工具列表即成功步骤 8安装浏览器依赖可选cd~/.hermes/hermes-agentnpminstall--ignore-scripts国内网络下载 Electron 二进制文件经常超时--ignore-scripts会跳过 Electron 的 postinstall 脚本。Hermes 的 CLI 功能不依赖 Electron不影响使用。步骤 9验证安装hermes doctor诊断报告步骤 10后续进入容器并启动 Hermes方式 A命令行启动# 启动已停止的容器dockerstart-ihermes-ubuntu进入容器后bashsource~/.bashrc hermes容器默认 shell 是 sh需先执行bash加载环境变量。方式 BDocker Desktop 图形界面启动打开 Docker Desktop点击Containers→ 找到hermes-ubuntu点击容器名称进入详情页点击Exec标签页输入命令bash→source ~/.bashrc→hermes步骤 11关闭容器正确关闭方式在容器内执行exit或按CtrlD容器会停止但保留状态。下次启动dockerstart-ihermes-ubuntu❌ 不要直接关闭命令行窗口或强制终止 Docker Desktop可能导致数据未写入。路线二WSL2 部署原生 Linux长期推荐步骤 1安装 WSL2 Ubuntu管理员 PowerShell 执行wsl--install-d Ubuntu如遇网络超时改用 Docker 路线。安装完成后重启电脑首次启动 Ubuntu 时设置账号Enter new UNIX username: yourname Enter new UNIX password: ******** Retype new UNIX password: ********密码输入时不会显示输完直接回车。步骤 2更新 WSL2 和 Ubuntu 系统首次安装后建议执行# 管理员 PowerShellwsl--update wsl--shutdown# Ubuntu 内sudoaptupdatesudoaptupgrade-y步骤 3安装依赖sudoaptinstall-ycurlgitpython3 python3-pip python3-venv nodejsnpm步骤 4安装 Hermescurl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash步骤 5解决 PATH 问题安装完成后若提示hermes: command not foundexportPATH$HOME/.local/bin:$PATHsource~/.bashrc步骤 6启动 Hermeshermes步骤 7配置与后续同 Docker 路线步骤 6-9。后续维护提示更新 Hermeshermes update更新 WSL2 内核wsl --update管理员 PowerShell更新 Ubuntu 系统sudo apt update sudo apt upgrade -y备份 WSLwsl --export Ubuntu D:\wsl-backup\ubuntu-hermes.tar路线三Windows 本地源码部署步骤 1前置依赖Python 3.10/3.11python -V确认Gitgit -v确认Node.js npm可选浏览器功能需要Microsoft C Build Tools用于编译部分 Python 包步骤 2下载源码Git 克隆gitclone https://github.com/NousResearch/hermes-agent.git或下载 Release 包https://github.com/NousResearch/hermes-agent/releases步骤 3创建虚拟环境cdhermes-agent python-mvenv venv venv\Scripts\activate步骤 4安装项目pipinstall-e.步骤 5启动 Hermeshermes步骤 6配置与后续同 Docker 路线步骤 6-9。启动模式选择命令模式特点hermes普通交互模式命令行直接对话会话保存在~/.hermes/sessions/hermes --tuiTUI 界面模式图形终端界面多会话管理独立存储⚠️注意两种模式的会话记录不互通TUI 会话只能在 TUI 模式下查看。三种路线对比特性DockerWSL2本地源码安装难度低中高数据持久化需配置卷永久保存永久保存性能轻微损耗接近原生原生备份难度需导出容器导出 tar直接复制文件夹推荐场景快速测试长期使用二次开发五大避坑金句建议截图保存❌ 不要死磕 WSL 安装 → ✅ 超时直接换 Docker❌ 不要直接关命令行窗口 → ✅ 容器内先执行exit❌ 不要忽略bash命令 → ✅ Docker/WSL 里先bash再source❌ 不要把源码放中文路径 → ✅ 用E:\Hermes而非E:\软件\Hermes❌ 不要混用 TUI 和普通模式查历史 → ✅ 各模式各看各的常见问题速查问题解决WSL 安装超时放弃 WSL改用 DockerWSL 启动失败wsl --shutdown后重启Ubuntu 损坏wsl --unregister Ubuntu后重新安装磁盘空间不足wsl --manage Ubuntu --set-sparce启用稀疏文件网络不通检查 Windows 防火墙或重置网络wsl --shutdownsource: not found先执行bashhermes: command not foundexport PATH$HOME/.local/bin:$PATHDocker 容器内 hermes 找不到先执行bash再source ~/.bashrcnpm Electron 超时加--ignore-scriptsbrowser 工具不可用apt install -y chromium-browserTUI 会话和普通会话不互通各自独立存储用对应模式查看核心命令速查命令作用hermes启动普通交互对话hermes --tui启动 TUI 界面hermes model切换模型hermes doctor诊断环境hermes doctor --fix自动修复hermes setup重新配置hermes update更新版本wsl --update更新 WSL2 内核/exit退出番外篇预告欢迎关注后续文章如何接入自定义模型Ollama 本地模型、OpenAI 兼容接口编写第一个自动化任务定时查询天气并发送到企业微信使用浏览器工具进行网页自动化登录、抓取、表单填写如果觉得本篇指南对你有帮助欢迎点赞、收藏、转发让更多人看到。有任何问题请在评论区留言我会尽快回复。本文最后更新2026-06-15