企业官网建设流程全解析

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，切换成 2：

wsl --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/api，Key 在控制台的 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/api，Key 填你生成的密钥，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 会更划算一些。