1. Windows 上跑 Hermes Agent为什么终端选择比模型选择还折腾Hermes Agent 是 NousResearch 开源的一个终端智能体框架能读写文件、执行 shell 命令、跑多步任务适合想把日常编码和运维交给 Agent 的人。它官方主推 Linux/macOSWindows 用户第一次上手往往会卡在“到底用 WSL 还是 PowerShell”这个问题上。我前后在 WSL Ubuntu、Windows Terminal、原生 PowerShell 三种环境里都装过一遍结论是两条路都能走通但配置文件的落点和环境变量注入方式完全不同混着用就会出现“明明 Key 是对的请求却 401”的情况。这篇记录聚焦 Windows 环境下 Hermes Agent 的落地使用覆盖 WSL、PowerShell、Ubuntu 三种终端场景给出 TaoToken 统一 Key/API 通道的 settings.json 与 config.toml 骨架配置并附上逐条验证动作。如果你正在 Windows 上折腾 Hermes Agent或者想用一个统一入口管理多个模型的调用下面的步骤可以直接照着做。TaoToken 在这里扮演的角色是统一 API 通道官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口 https://taotoken.net/api 。它把 OpenAI 格式和 Anthropic 格式的地址分开你选哪种格式模型列表和上下文参数就要跟着对应这一点在 Hermes 的 setup 流程里特别容易踩坑。2. 前置准备TaoToken Key 与两种格式地址的对应关系在动手装 Hermes 之前先把 TaoToken 这边的信息理清楚不然后面 setup 里选错格式会反复重来。登录控制台后到 API Keys 页面创建一个 Key这个 Key 在 WSL 和 PowerShell 里是通用的不需要为每个终端单独申请。关键是地址格式要和模型格式严格对应格式地址适用模型OpenAI 格式https://taotoken.net/api/openaiGPT 系、多数兼容 OpenAI 协议的模型Anthropic 格式https://taotoken.net/api/anthropicClaude 系注意地址和格式必须成对出现。你选了 OpenAI 格式的地址模型列表里就要选 OpenAI 协议那一组选 Anthropic 格式同理。混搭是 401 和 404 的高发原因。创建 Key 的入口在这里https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 。建议先把 Key 复制到记事本因为 Hermes 的 setup 交互里粘贴 Key 时终端可能不回显直接回车确认即可这是正常现象。3. WSL Ubuntu 场景从安装到 settings.json 骨架WSL 是官方推荐路径Ubuntu 环境最省心。在 Windows Terminal 里执行wsl --install -d Ubuntu装完进入 Ubuntu用 root 权限跑官方安装脚本sudo -i curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装脚本会处理 uv、Python 3.11、Node.js、ripgrep、ffmpeg 等依赖。装完后直接输入hermes就能进入交互界面。第一次进去先跑初始化hermes setup在 setup 里模型来源建议先选 quick如果列表里没有你要用的模型就选 custom。接着会依次问你API 地址填 https://taotoken.net/api/openai OpenAI 格式API Key粘贴 TaoToken 的 Key终端无回显直接确认模型格式因为上面选的是 OpenAI 格式地址这里选 2OpenAI 协议模型名称与上下文长度上下文填 1000000填错会导致可用上下文被压缩运行位置本地选 localWSL 下的配置文件落在~/.config/hermes/settings.json骨架长这样{ provider: custom, api_base: https://taotoken.net/api/openai, api_key: sk-你的TaoToken密钥, model: 你的模型名, context_window: 1000000, runtime: local }如果你更习惯 TOML 风格Hermes 也支持config.toml[provider] name custom api_base https://taotoken.net/api/openai api_key sk-你的TaoToken密钥 model 你的模型名 context_window 1000000 runtime local两个文件选一个维护即可同时存在时以 settings.json 优先。改完保存退出重进hermes让配置生效。4. PowerShell 原生安装绕开依赖下载的坑WSL 用久了你会发现Agent 经常提示缺工具或要权限主力机是 Windows 的话原生安装更顺手。官方 PowerShell 一行命令iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)安装器会自动处理 uv、Python 3.11、Node.js、ripgrep、ffmpeg以及一个便携版 Git BashMinGit解压到%LOCALAPPDATA%\hermes\git不需要管理员权限和系统 Git 完全隔离。如果你已经装了 Git它会直接复用。网络不稳的时候依赖下载容易卡住可以先把能单独装的装上irm https://astral.sh/uv/install.ps1 | iex $env:UV_PYTHON_INSTALL_MIRROR https://github.com/astral-sh/python-build-standalone/releases/download uv python install 3.11如果 Python 还是拉不下来检查一下本机网络出口设置是否正常再重试uv python install 3.11。ripgrep 和 ffmpeg 可以用 scoop 装irm get.scoop.sh | iex scoop install ripgrep ffmpeg装完同样跑hermes setup流程和 WSL 一致。PowerShell 下的配置落在%USERPROFILE%\.config\hermes\settings.json内容与上面 WSL 的骨架相同只是路径不同。原生安装的好处是 Agent 执行 shell 命令时直接调 PowerShell不用再跨一层 WSL文件路径也不会出现/mnt/c/这种映射。5. 验证请求链路三条命令确认配置真的通了配置写完不代表通了我习惯用三步验证。第一步确认 Hermes 读到了配置hermes config show输出里应该能看到api_base指向 https://taotoken.net/api/openai context_window是 1000000。第二步发一条最小请求hermes run 用一句话说明当前配置的模型名称如果返回正常文本说明 Key、地址、模型三者匹配。如果报 401多半是 Key 粘贴时带了空格报 404检查地址末尾有没有多余的斜杠。第三步验证上下文长度是否生效hermes run 统计从1到1000的整数和并说明你使用的上下文窗口返回结果里模型能正常处理长输入就说明上下文参数没被截断。这一步在 WSL 和 PowerShell 里都跑一遍确认两个终端行为一致。想单独验证模型对话是否正常可以直接用模型对话入口https://taotoken.net/models 不经过 Hermes 也能确认通道可用。6. 本篇常见错排查报错一hermes: command not foundWSL安装脚本跑完后当前 shell 没刷新 PATH。执行source ~/.bashrc或重开一个终端即可。报错二setup 里粘贴 Key 没反应终端不回显是正常设计直接回车确认。如果确认后仍报 401把 Key 重新复制一遍注意别带上换行。报错三模型列表里找不到目标模型说明你选的格式和模型不匹配。OpenAI 格式地址配 OpenAI 协议模型Anthropic 格式地址配 Claude 系模型回 setup 重选。报错四上下文明显变小setup 里上下文长度那一项填错了。默认建议 1000000填成 100000 或更小会直接压缩可用窗口回配置文件改context_window后重启。报错五PowerShell 下 Agent 执行命令报权限错误原生安装用的是便携版 Git Bash不碰系统 Git。如果报权限问题检查%LOCALAPPDATA%\hermes\git目录是否被安全软件拦截。报错六WSL 和 PowerShell 配置互相覆盖两个环境的配置文件路径不同不会互相覆盖。但如果你在 WSL 里改了~/.config/hermes/settings.jsonPowerShell 那边不会同步需要各自维护。7. 长期编码与 Agent 场景的接入建议如果你打算把 Hermes Agent 当长期编码助手用频繁跑多步任务建议把 Key 和通道固定下来避免每次 setup 重配。TaoToken 的 Coding Plan 适合这种长期编码和 Agent 场景https://taotoken.net/coding-plan 配合接入文档 https://taotoken.net/doc 把 settings.json 一次性写死之后换模型只改model字段就行。WSL 用户还可以做个快捷方式用 Windows Terminal 直接拉起 Hermesecho off start C:\Users\Administrator\AppData\Local\Microsoft\WindowsApps\wt.exe -p HermesWindows Terminal 里也可以给 Hermes 单独加一个 profile启动即进 Ubuntu 并自动执行hermes。手机端连接的话跑hermes gateway setup再用hermes pairing approve feishu xxx绑定配合/sethome设置主目录。这套流程在 WSL 和原生 PowerShell 下都适用区别只是配置文件落点不同。实测下来Windows 上跑 Hermes Agent 最稳的组合是日常用 WSL Ubuntu 跑重任务原生 PowerShell 做快速验证两边共用同一个 TaoToken Key配置各自维护一份。这样既不会因为 WSL 的权限提示打断节奏也不会在原生环境下遇到依赖缺失。