1. Windows 下跑 Hermes Agent 微信机器人为什么我最后选了 WSL2 TaoToken 这条路Hermes Agent 是继「龙虾」之后又一个热度很高的自主智能体工具它最大的特点是内置了学习循环能记住你交代过的任务上下文而不是每次对话都从零开始。配合微信机器人使用你可以直接在微信里给它发消息、派任务比如让它整理资料、定时提醒、跑一些自动化脚本。适合谁适合想在 Windows 上折腾本地 Agent、又不想天天开着一台 Linux 服务器的人。但这里有个坑Hermes Agent 官方明确说明原生 Windows 不支持Windows 用户必须先装 WSL2然后在 WSL2 的 Ubuntu 终端里跑安装脚本。我一开始不信邪直接在 PowerShell 里试结果脚本跑到一半各种路径报错最后还是老老实实回到 WSL2。另一个坑是模型接入。Hermes 默认走官方通道但很多人手里已经有自己的 API Key想统一到一个通道里管理省得每个工具都配一遍。这篇就聚焦两件事一是在 Windows 11 上用 WSL2 把 Hermes Agent 装起来并接入微信机器人二是把配置文件里的 endpoint 和鉴权项改到 TaoToken 统一通道让模型调用走一个入口。整条链路跑通后你在微信里发一句话消息会经过 Hermes 的 gateway调用模型再把结果回给你。下面按步骤来命令都可以直接复制。2. 前置准备WSL2 环境检查与 Ubuntu 初始化含 wsl --status 报错处理先确认你的 Windows 有没有装 WSL。以管理员身份打开 PowerShell执行wsl --status如果输出里有默认发行版和 WSL 版本信息说明已经装了。如果提示「未安装用于 Linux 的 Windows 子系统」就继续往下走。一键安装命令是wsl --install这条命令默认会装 WSL 和一个 Ubuntu 发行版装完按提示重启电脑。重启后确认版本必须是 WSL2因为 WSL1 在网络和文件系统上会出各种奇怪问题wsl -l -v输出里 VERSION 那一列如果是 1切换成 2wsl --set-version Ubuntu 2 wsl --set-default-version 2第一次进 Ubuntu 会让你创建 Linux 用户名和密码这个密码是 sudo 用的记牢。进入系统后先更新包列表并装基础工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git ca-certificates build-essential装完验证一下curl --version git --version两个都能打印版本号就说明基础环境 OK。这里有个常见坑如果你在公司网络下apt update可能卡在某个源上可以换成国内镜像源再试。另外 WSL2 的磁盘占用会随着使用增长建议定期用wsl --shutdown关掉再压缩虚拟磁盘不然 C 盘会悄悄变红。环境准备好之后模型通道这块我建议提前规划。因为 Hermes 装完会立刻让你配模型如果那时候才去找 Key、找 endpoint容易手忙脚乱。我习惯先把统一通道的地址和 Key 准备好装完直接填。3. 安装 Hermes Agent 并把 settings 改到 TaoToken 统一通道在 Ubuntu 终端里执行官方安装脚本curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash这一步会卡比较久因为要拉依赖。装完会自动跳到配置流程。先配模型hermes model在选项里选Custom endpoint (enter URL manually)也就是第三方通道。然后填入 Base URL 和 API Key。这里就是我们要改到 TaoToken 的地方。TaoToken 的 API 地址是https://taotoken.net/apiKey 在控制台的 API Keys 页面生成。Hermes 的配置文件通常在用户目录下的配置目录里你可以用hermes dashboard启动 Web 端来可视化查看和修改也可以直接编辑配置文件。下面是一份可复制的 settings 片段路径和字段名按你实际安装后的为准重点是base_url和api_key两项{ model: { provider: custom, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model_id: claude-sonnet-4-5, max_tokens: 4096, temperature: 0.7 }, gateway: { enabled: true, channel: wechat } }如果你更习惯 TOML 风格等价写法是这样[model] provider custom base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model_id claude-sonnet-4-5 max_tokens 4096 temperature 0.7 [gateway] enabled true channel wechat三件套要记全Base URL 填https://taotoken.net/apiKey 填你生成的密钥Model ID 填你要用的模型标识。这三个缺一个都会在请求时报错。改完保存回到终端重新跑一次hermes model确认配置被读取或者直接hermes进对话窗口测试。配好模型后配微信机器人hermes gateway setup一路选默认然后用自己微信扫码绑定。绑定成功后在微信里给这个 Bot 发一条消息能收到回复就说明链路通了。之后可以用hermes dashboard在浏览器里查看和改配置比命令行直观。4. 验证请求从 hermes 对话到微信收发全链路跑通配置改完不能只看「保存成功」要实际发一次请求确认。第一步先在终端里验证模型通道hermes进入对话窗口后随便问一句比如「你好帮我列三个今天要做的事」。如果模型正常返回说明 Base URL、Key、Model ID 三件套没问题。如果这里就报错先别急着配微信把模型通道修好再说。第二步验证 gateway 是否在跑hermes gateway status正常会显示 running 和绑定的渠道。如果没跑起来用hermes gateway start启动。第三步才是微信实测。打开微信找到你扫码绑定的那个 Bot发一条「现在几点」或者「帮我记一下明天下午三点开会」。消息发出去后Hermes 会经过 gateway 调用模型再把结果回给你。实测下来第一次回复可能会慢几秒因为要建立会话上下文之后就快了。如果你想看请求到底走了哪个通道可以在 dashboard 里看日志或者临时把日志级别调高。确认请求的 endpoint 是https://taotoken.net/api而不是官方地址就说明改通道成功了。这一步还有个细节微信机器人的消息有长度限制如果模型返回很长Hermes 会自动分段。你可以在配置里调整分段策略避免一条消息被切得七零八落。5. 常见报错排查401、local proxy failed、reading choices、OAuth 逐个击破配通道和 gateway 的过程中最容易撞上这几类报错我按实际遇到的顺序列一下。401 Unauthorized九成是 Key 填错或者没生效。检查api_key字段有没有多余空格Key 是不是在 TaoToken 控制台重新生成过导致旧的失效。改完配置记得重启 Hermes 进程不然读的还是旧配置。local proxy failed / connection refused这个通常是 gateway 没起来或者端口被占用。先hermes gateway status看状态再检查配置里的端口有没有和别的服务冲突。WSL2 的网络是 NAT 模式Windows 侧访问 WSL 里的服务需要端口转发如果你在 Windows 浏览器里打不开 dashboard多半是这个原因用wsl hostname -I拿到 WSL 的 IP 再访问。reading choices 相关报错这类一般是模型返回格式和 Hermes 预期不一致常见于 Model ID 填错比如填了一个通道不支持的模型名。回到配置里确认model_id是通道实际提供的模型标识别凭记忆填。OAuth 报错如果你在 gateway setup 时选了需要 OAuth 的渠道扫码或回调失败会报这个。检查系统时间是否准确OAuth 对时间戳敏感WSL2 休眠后时间可能漂移用sudo hwclock -s同步一下再试。排查顺序建议先终端hermes验证模型再hermes gateway status验证网关最后才测微信。这样能把问题范围缩小到具体环节不用一上来就怀疑微信。6. 把通道固定下来后续维护与统一入口的实用建议链路跑通之后建议把配置备份一份尤其是 settings 文件。WSL2 重装或者迁移的时候直接恢复配置能省很多事。另外 TaoToken 的 Key 建议单独建一个给 Hermes 用方便在控制台看调用量和排查问题别和别的工具共用一个 Key。模型 ID 这块如果你后面想换模型只改model_id一项就行Base URL 和 Key 不用动这就是统一通道的好处。想试新模型的时候在 dashboard 里改一下保存重启 gateway 即可。微信机器人长期挂着的话注意 WSL2 不会随 Windows 开机自启需要手动进一次或者配任务计划。我一般是在 Windows 任务计划里加一条开机执行wsl -d Ubuntu -u 你的用户名 hermes gateway start这样重启后机器人也能自己起来。最后如果你还没生成 Key可以去 TaoToken 的 API Keys 页面建一个接入细节和字段说明看接入文档想先验证模型通不通直接用模型对话页面测一句最快。长期跑编码和 Agent 任务的话Coding Plan 会更划算一些。