1. Windows 上跑 Hermes Agent 到底难在哪Hermes Agent 是 Nous Research 推出的自进化 AI 智能体官网那句 The Agent That Grows With You 说得很直白——它内置学习循环能从每次对话里提炼技能、在使用中持续改进还会跨会话记住你的偏好。适合谁适合想在本地电脑上拥有一个长期陪伴、越用越懂你的编码与自动化助手的人尤其是习惯 Windows 桌面环境、又不想折腾双系统的开发者。但真到动手这一步Windows 用户会撞上一连串现实问题。官方文档和社区教程大多默认 macOS 或 Linux命令示例清一色 bash 语法PowerShell 里curl是Invoke-WebRequest的别名参数完全对不上Python 版本要求3.12而系统里往往躺着 3.10 或 3.11Git Bash 路径、Node.js、ripgrep、ffmpeg 这些依赖缺一个安装脚本就会中途报错。我见过太多人卡在 Python 3.11 not found, installing via uv 之后紧接着一句 incompatible with the projects Python requirement然后就没有然后了。这篇就按 Windows 11 PowerShell Python 的真实路径把从零安装 Hermes Agent、接入 OpenClaw 配置、再到启动验证的完整流程拆开讲。每一步都给可复制的命令和配置片段遇到报错怎么排查也一并写清楚。你跟着做目标是在本地把服务跑起来用hermes doctor确认健康再用hermes进 CLI 聊上第一句。核心检索词先摆在这Hermes Agent 是什么、能做什么、适合谁——它是一个本地优先的自改进智能体能接微信等消息平台能调免费或自定义模型适合想在个人电脑上长期养一个 AI 助手的 Windows 用户。下面进入实操。2. 装 Hermes Agent 前先把 TaoToken 的 Key 和模型准备好Hermes Agent 本身是壳真正干活的是背后的大模型。你可以用官网登录后送的免费模型也可以接自己的 API。我实测下来用 TaoToken 做统一入口比较省心——它兼容 OpenAI 风格的接口Base URL 固定Key 一处配置Hermes、Cline、Codex 这些工具都能复用。先拿 Key。打开 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 登录后创建一个新 Key复制出来存好。这个 Key 就是后面配置里的API_KEY别泄露也别提交到 Git。Base URL 用这个注意不带任何多余路径https://taotoken.net/api。Model ID 按你要用的模型填比如想验证对话能力可以先用一个通用模型长期编码或跑 Agent 任务则建议上 Coding Plan 里支持的模型。Coding Plan 入口在这https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 适合需要稳定跑 Agent、频繁调用的场景。如果你只是想先验证模型通不通可以打开模型对话页面直接试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。输入一句话看有没有正常回复确认 Key 和网络都没问题再去配 Hermes能省掉一半排错时间。接入文档在这里遇到字段对不上可以对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。控制台总览https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。这里要强调一个三件套概念不管你是接 Hermes、Cline MCP 还是 Codex 的auth.json配置里永远离不开 Base URL、Key、Model ID 这三样。少一个就连不上填错一个就报 401 或 model not found。后面 §3 会给完整的 JSON/TOML 片段路径和字段名都按真实配置文件来。3. 可复制的 PowerShell 安装与 OpenClaw 接入配置这一节是全文最干的部分命令和配置都能直接抄。先确认你的 PowerShell 是 7.x 还是 5.x建议用 Windows Terminal 打开 PowerShell 7兼容性更好。第一步检查基础环境。逐条跑看输出# 查看 PowerShell 版本 $PSVersionTable.PSVersion # 检查 Python要求 3.12 python --version py -0p # 检查 Git git --version # 检查 Node.js node --version # 检查 ripgrep 和 ffmpeg rg --version ffmpeg -version如果 Python 低于 3.12别急着卸载系统 Python用 uv 装一个独立版本更干净# 安装 uv如果还没有 powershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex # 用 uv 安装 Python 3.12 uv python install 3.12 # 确认安装位置 uv python list第二步跑 Hermes 官方安装脚本。官网给的命令在 PowerShell 里可以直接用# 安装 Hermes Agent powershell -ExecutionPolicy ByPass -c irm https://hermes-agent.nousresearch.com/install.ps1 | iex安装过程会自动检查 uv、Python、Git、Node.js、ripgrep、ffmpeg。缺什么它下什么你耐心等。如果看到Python 3.11 not found, installing via uv后面跟着incompatible with the projects Python requirement: 3.12说明它抓到了旧版本这时手动指定# 强制用 3.12 重新触发安装 $env:HERMES_PYTHON 3.12 powershell -ExecutionPolicy ByPass -c irm https://hermes-agent.nousresearch.com/install.ps1 | iex第三步配置模型。Hermes 的配置文件在C:\Users\你的用户名\AppData\Local\hermes\下。用hermes setup model走向导或者直接改配置文件。下面是接 TaoToken 的 JSON 片段路径按你的实际安装目录来{ provider: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: 你的Model ID, temperature: 0.7, max_tokens: 4096 }如果你用 TOML 格式部分版本支持写法是[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的Model ID temperature 0.7 max_tokens 4096第四步OpenClaw 接入。如果你之前装过 OpenClawHermes 安装向导会问是否导入配置。这里要注意向导会提示 OpenClaw 的配置值在 Hermes 中可能具有不同的语义所以迁移选项建议选 NO手动重配更稳。OpenClaw 的配置目录通常在C:\Users\你的用户名\.openclaw\Hermes 的对应目录在AppData\Local\hermes\两者字段名不完全一样直接导入容易出玄学问题。第五步微信接入。向导里选消息平台时输入对应编号微信通常是 3会弹二维码手机扫码验证。扫完还要配消息授权和群聊策略按需开。第六步验证配置。跑这几个命令hermes config # 查看当前配置 hermes doctor # 检查安装健康度 hermes gateway # 启动网关服务hermes doctor全绿就说明环境没问题。然后hermes直接进 CLI 聊天。4. 验证请求从 hermes doctor 到第一条回复配置写完不代表通了得实际发一次请求才算数。这一节讲怎么验证以及成功长什么样。先跑hermes doctor。正常输出会逐项列出 Python、Git、Node.js、ripgrep、ffmpeg、配置文件、模型连接的状态。如果模型那一项是红的多半是 Key 或 Base URL 的问题。重点看它有没有报401 Unauthorized或model not found。然后跑hermes config确认base_url是https://taotoken.net/apimodel是你填的 Model IDapi_key前缀对得上。如果这里显示的还是默认的 Nous 门户地址说明你的自定义配置没生效检查配置文件路径是不是写对了。接着启动 CLIhermes进去之后直接打字比如 你好帮我写一个 PowerShell 脚本列出当前目录下所有大于 10MB 的文件。如果模型正常几秒内会开始流式输出。第一次回复可能稍慢因为要建立连接和加载上下文。想验证网关和微信通道另开一个 PowerShell 窗口hermes gateway网关起来后用手机微信给绑定的账号发消息看 Hermes 有没有回。如果微信没反应但 CLI 正常问题在消息平台配置不在模型。再验证一下自定义模型切换。跑hermes setup model选 OpenRouter 或 openai-compatible填入 TaoToken 的 Key 和 Model ID回车后它会拉模型列表。选一个免费的或你订阅的模型确认能列出来。列不出来就是 Key 权限或 Base URL 的问题。成功的结果长这样hermes doctor全绿hermes里能连续对话hermes gateway启动无报错微信端能收到回复。到这一步本地 Hermes Agent 就算跑通了。如果你在验证模型对话时想快速确认某个 Model ID 是否可用可以直接在模型对话页面发一条测试消息比在 CLI 里反复试快得多。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来每条都给现象、原因、解法。401 Unauthorized。现象是hermes doctor模型项红或 CLI 里发消息直接报 401。原因通常是 Key 填错、Key 过期、或者 Base URL 多了斜杠。检查base_url是不是严格的https://taotoken.net/api不要写成https://taotoken.net/api/或带/v1。Key 重新复制一次注意别把前后空格带进去。如果还不行去 API Keys 页面确认这个 Key 还在、额度没耗尽。local proxy failed。现象是启动时报连接本地代理失败。这通常是你系统里设了 HTTP_PROXY 或 HTTPS_PROXY 环境变量但代理没开。检查echo $env:HTTP_PROXY echo $env:HTTPS_PROXY如果有值且你不需要清掉Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue然后重启 PowerShell 再跑 hermes。reading choices 报错。现象是模型返回流式数据时解析失败报类似error reading choices或unexpected end of JSON。原因多半是模型返回格式和 Hermes 预期的不一致或者 max_tokens 设太小导致截断。把max_tokens调到 4096 以上换一个兼容性更好的 Model ID 再试。如果用的是免费模型高峰期可能返回空响应换个时段或换模型。OAuth 登录失败。现象是向导里选登录 Nous 门户浏览器弹出来但回调失败。这通常是默认浏览器或防火墙拦截了 localhost 回调。解法先跳过登录用自定义模型配置§3 的 JSON 片段直接接 TaoToken不依赖 Nous 账号。如果一定要登录把默认浏览器临时设为 Edge 或 Chrome关掉可能拦截 localhost 的安全软件再试。Python 版本不兼容。现象是安装时反复提示requires-python 3.12。解法是用 uv 装 3.12 并让 Hermes 用它命令在 §3 第二步。装完uv python list确认 3.12 在列再重跑安装脚本。Git Bash 路径找不到。现象是HERMES_GIT_BASH_PATH设置失败。手动设$env:HERMES_GIT_BASH_PATH C:\Program Files\Git\bin\bash.exe路径按你实际 Git 安装位置改。设完重开终端。微信扫码后无响应。现象是二维码扫了、验证过了但发消息不回。检查hermes gateway是否在跑网关日志有没有报错。微信通道对消息格式有要求群聊里可能需要 才触发。先私聊测试确认通了再开群聊。排查顺序建议先hermes doctor看整体再hermes config看配置然后单独测模型模型对话页面最后测网关和消息平台。一层层排除别一上来就重装。6. 长期跑 Agent 的配置建议与入口本地跑通只是开始真要长期用有几个点值得调。模型选择上日常对话和轻量任务用免费模型够用涉及复杂编码、长上下文、多步 Agent 任务建议上 Coding Plan 里更稳的模型避免高峰期免费模型返回空响应。切换模型用hermes setup model不用重装。配置备份上AppData\Local\hermes\下的配置文件定期复制一份。升级用hermes update升级前备份升级后跑hermes doctor确认没坏。网关和自启动如果你希望开机就跑向导里可以配跟随系统自启动。但注意网关常驻会占资源笔记本上按需开就行。想深入看接入细节和字段说明文档在这https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理在 API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。控制台看用量和额度https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。长期编码和 Agent 任务走 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。快速验证模型用模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。最后说个我踩过的坑Windows 上路径里的反斜杠和空格最容易出问题配置文件里能用正斜杠就用正斜杠路径带空格的加引号。还有别把 Key 写进会提交到 Git 的文件里用环境变量或本地配置文件加进.gitignore。跑通之后先让它干一件小事比如整理桌面文件、写个定时提醒脚本感受一下它的学习循环怎么工作再逐步加任务。