一、引言最近在体验一款名为Hermes-Agent​ 的开源 AI 智能体框架由 Nous Research 出品。它最大的亮点是免训练即可赋予大模型操作电脑的能力浏览器自动化、代码执行、文件管理、消息网关等底层支持 300 模型包括 OpenAI、Anthropic、DeepSeek 以及国内主流大模型。本文记录了我从零开始在Windows 11​ 上安装 Hermes-Agent 的全过程并重点解决了网络卡顿和API Key 配置两大痛点最终成功接入了DeepSeek 纯文本模型通过CCSwitch 中转。希望能帮助同样在 Windows 上折腾的小伙伴少走弯路。二、Hermes-Agent 介绍Hermes-Agent 是一个本地运行的 AI 操作员具备以下核心能力多模型支持兼容 OpenAI、Anthropic、DeepSeek、智谱、Kimi、豆包等 300 模型可随时切换。工具链集成浏览器自动化基于 Playwright可自动打开网页、点击、填写表单、截图分析。代码执行沙箱Python / Shell 直接运行适合数据处理、脚本调试。文件操作读写、解压、解析 PDF/Word/Excel。联网搜索实时查询突破模型知识截止。跨会话记忆记住项目上下文无需重复交代背景。消息网关可接入 Telegram / Discord / Slack手机远程指挥。技能自进化复杂任务自动沉淀为可复用“技能”。一句话总结它是一个能真正“动手”的 AI 助手而不只是聊天机器人。三、安装前的环境准备3.1 硬件与系统要求操作系统Windows 10/11建议 64 位处理器x86/x64 或 ARM64Surface Pro X 等需选 ARM 版本内存至少 8GB推荐 16GB磁盘空间至少 5GB含 Python 虚拟环境、Node 模块、Chromium 浏览器内核3.2 前置依赖可选但推荐Hermes-Agent 会自动检测并安装大部分依赖但提前安装以下工具可避免中途卡顿工具用途安装命令管理员 PowerShellGit克隆仓库winget install Git.GitPython 3.11运行核心代码winget install Python.Python.3.11Node.js 22 LTS浏览器工具winget install OpenJS.NodeJS.LTSripgrep快速文件搜索winget install BurntSushi.ripgrep.MSVCffmpegTTS 语音消息winget install Gyan.FFmpeg注意即使不提前安装安装脚本也会尝试自动下载 PortableGit 和 Hermes 托管的 Node.js但网络不稳定时容易失败。四、安装 Hermes-Agent4.1 一键安装推荐打开PowerShell建议以管理员身份运行直接执行以下命令irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex这条命令做了三件事Invoke-RestMethod缩写irm下载远程脚本。Invoke-Expression缩写iex在当前会话中执行脚本。脚本自动完成安装 uvPython 包管理器→ 安装 Python 3.11 → 安装 Git → 安装 Node.js → 克隆仓库 → 创建虚拟环境 → 安装 Python 依赖 → 安装 Node 依赖含 Playwright Chromium→ 配置 PATH → 写入配置文件。安装过程大约需要 5~15 分钟取决于网络速度和是否首次下载 Chromium约 170MB。4.2 常见问题网络卡顿与解决方案终端停留在Installing Node.js dependencies (browser tools)...或Installing Playwright Chromium...超过 5 分钟无变化。原因GitHub raw 域名raw.githubusercontent.com在国内访问不稳定。Playwright 下载 Chromium 时默认从 Google CDN 拉取经常被墙。解决方案二选一方案 A配置代理如果已有梯子在 PowerShell 中设置临时环境变量指定 HTTP/HTTPS 代理$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890然后重新运行安装命令。方案 B手动下载 ZIP 并本地安装如果以上均无效可手动下载仓库 ZIP# 下载 ZIP Invoke-WebRequest -Uri https://github.com/NousResearch/hermes-agent/archive/refs/heads/main.zip -OutFile $env:TEMP\hermes.zip Expand-Archive -Path $env:TEMP\hermes.zip -DestinationPath $env:TEMP\hermes-extract Move-Item $env:TEMP\hermes-extract\hermes-agent-main $env:LOCALAPPDATA\hermes\hermes-agent # 然后进入目录执行本地安装脚本 cd $env:LOCALAPPDATA\hermes\hermes-agent .\scripts\install.ps14.3 验证安装安装完成后关闭当前 PowerShell 窗口并重新打开一个新窗口使 PATH 生效然后输入hermes --version如果看到类似hermes 0.x.y的输出说明安装成功。五、配置 API Key核心难点5.1 交互式配置首次运行hermes时会自动进入设置向导也可手动启动hermes setup向导会引导你选择模型提供商、输入 API Key、配置消息网关等。但对于国内用户直接使用向导往往会卡在 Stripe 绑卡页面免费套餐也需要绑定信用卡。5.3 使用 Ccswit.ch 中转 DeepSeek API由于 DeepSeek 官方 API 对国内用户友好但为了统一管理和方便切换模型我使用了CCSwitch一个兼容 OpenAI 格式的 API 中转平台。步骤如下在 Ccswit.ch 注册账号进入「渠道管理」添加 DeepSeek 模型。获取中转地址Base URL和专属 API Key。六、启动与基本使用6.1 启动交互式对话hermes进入提示符后可以像 ChatGPT 一样提问。例如 你好请用 Python 写一个斐波那契数列生成器。Hermes 会自动调用代码执行工具运行并返回结果。6.2 常用命令速查命令作用hermes启动交互式对话hermes setup重新运行配置向导hermes config查看/修改配置hermes config edit用编辑器打开配置文件hermes model查看/切换当前模型hermes gateway启动消息网关Telegram/Discordhermes update更新到最新版本hermes --version查看版本号6.3 测试 DeepSeek 模型是否正常工作在 Hermes 对话中输入 1 1 等于几请直接回答。如果返回2说明配置成功。七、进阶技巧与避坑指南7.1 切换模型如果需要临时切换到其他模型如 Claude无需重新安装只需修改配置文件中的MODEL和OPENAI_BASE_URL即可。Hermes 支持热加载重启会话后生效。7.2 解决 Windows 下 Git Bash 找不到的问题Hermes 在执行 Shell 命令时需要bash.exe。安装脚本会自动安装 PortableGit 并设置环境变量HERMES_GIT_BASH_PATH。如果后续出现问题可手动指定$env:HERMES_GIT_BASH_PATH C:\Program Files\Git\bin\bash.exe7.3 使用 WSL2 获得最佳体验虽然 Hermes 官方支持 Windows但许多高级特性如原生 Linux 工具链、更好的文件权限管理在WSL2 (Ubuntu)​ 下表现更稳定。安装 WSL2 后在 Ubuntu 终端中直接运行安装命令通常无需配置代理即可完成。# 在 WSL2 Ubuntu 中 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash7.4 卸载与重装如果需要完全卸载删除以下目录Remove-Item -Recurse -Force $env:LOCALAPPDATA\hermes然后重新安装即可。参考资料Hermes-Agent 官方文档https://hermes-agent.nousresearch.comCcswit.ch 中转平台https://ccswitch.xxxDeepSeek 开放平台https://platform.deepseek.com