1. Windows 上用 WSL Ubuntu 跑 Hermes为什么值得折腾Hermes 是一个可以接消息网关的 Agent 框架能让你在飞书里直接和模型对话、触发任务。它原生跑在 Linux 环境下Windows 用户想用得舒服最省事的路径就是 WSL2 里的 Ubuntu。这套组合的好处是Windows 负责日常办公Ubuntu 负责跑服务飞书负责当入口三者互不干扰。真正让人头疼的不是安装本身而是 Key 管理。Hermes 要接模型飞书要接凭证如果你还同时用着别的工具每个地方都塞一份 API Key改一次要翻好几个配置文件出错概率直线上升。我这次的做法是模型侧统一走 TaoToken 的 API 通道一个 Key 覆盖多个模型飞书侧只配 App ID 和 SecretHermes 的 config.toml 和 settings.json 各司其职。这样后面换模型、加工具只动一个地方。这篇适合谁手上是 Windows 10/11、想用 WSL 跑 Hermes、并且希望把飞书通知打通的人。跟着做你能拿到一个能启动、能对话、能在飞书里收到回复的 Hermes 实例。全程命令可直接复制配置骨架也给你留好了。2. 前置准备WSL2、Ubuntu 与 TaoToken 统一 Key2.1 确认虚拟化和 WSL2先在任务管理器「性能」标签页看虚拟化是否已启用。没启用就去 BIOS/UEFI 打开 Intel VT-x 或 AMD-V。然后以管理员身份打开 PowerShellwsl --install -d Ubuntu-24.04装完重启Ubuntu 窗口会自动弹出让你创建 UNIX 用户名和密码。密码输入时不显示是正常的。进去之后先更新一下sudo apt update sudo apt upgrade -y sudo apt install -y git curl nano2.2 为什么用 TaoToken 统一 KeyHermes 支持多家模型提供商但每换一家就要改一次 endpoint 和 Key。TaoToken 提供的是 OpenAI 兼容的 API 通道你只需要一个 Key就能在 Hermes 里切换不同模型。对 Hermes 来说它看到的就是一个标准的 OpenAI 接口配置成本最低。你需要准备的东西一个 TaoToken 的 API Key在控制台的 API Keys 页面创建飞书开放平台创建的应用拿到 App ID 和 App SecretWSL Ubuntu 环境上面已经装好TaoToken 的 API 地址是https://taotoken.net/api这个地址在 Hermes 的 config.toml 里会用到。Key 的创建入口在控制台具体路径是 API Keys 页面创建后复制保存后面填进配置文件。3. 安装 Hermes 并接入 TaoToken 通道3.1 一键安装脚本在 Ubuntu 终端里执行官方安装脚本curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash装完重新加载 Shell 配置source ~/.bashrc如果你用的是 zsh就换成source ~/.zshrc。然后验证hermes --version能看到版本号就说明命令已经全局可用。3.2 依赖卡住时的备选方案如果安装脚本在依赖阶段卡住或者你发现目录里是venv而不是.venv手动修一下。Hermes 的安装目录在~/.hermes/hermes-agentcd ~/.hermes/hermes-agent mv venv .venv source .venv/bin/activate uv sync如果提示uv: command not found就用 pip 兜底pip install -e .激活成功后命令行前面会出现(.venv)标志这时候再跑hermes --version确认。3.3 config.toml 骨架把模型指向 TaoTokenHermes 的模型配置写在~/.hermes/config.toml。核心是把 provider 的 base_url 指向 TaoToken 的 API 地址api_key 填你创建的那个 Key。下面是一个可直接改的骨架[model] provider openai model gpt-4o-mini base_url https://taotoken.net/api api_key sk-你的TaoTokenKey [model.params] temperature 0.7 max_tokens 2048这里provider保持openai是因为 TaoToken 走的是 OpenAI 兼容协议Hermes 不需要额外适配。model字段填你想用的模型名换成别的模型只改这一行Key 和地址都不用动。这就是统一 Key 的价值模型切换是配置层的事不是凭证层的事。3.4 settings.json 示例网关与飞书开关除了 config.tomlHermes 还有一个~/.hermes/settings.json用来控制网关行为。飞书相关的开关和连接模式放这里{ gateway: { enabled: true, connection_mode: websocket, feishu: { enabled: true, domain: feishu } }, logging: { level: info } }connection_mode用websocket的好处是不需要公网回调地址WSL 里的服务能主动连出去省掉内网穿透的麻烦。飞书的 App ID 和 Secret 属于敏感信息不放这里放.env。3.5 飞书凭证写入 .env编辑~/.hermes/.envnano ~/.hermes/.env填入FEISHU_APP_IDcli_你的AppID FEISHU_APP_SECRET你的AppSecret FEISHU_DOMAINfeishu FEISHU_CONNECTION_MODEwebsocket保存退出。注意 App Secret 不要有多余空格复制的时候容易带上换行。4. 验证请求从模型连通到飞书回消息4.1 先验证模型通道配置写完后直接启动 Hermes 对话模式hermes发一条hello如果模型正常返回说明 TaoToken 的 Key、base_url、模型名三者匹配。如果报 401先检查 Key 有没有多余空格再确认 base_url 是不是https://taotoken.net/api不要多写或少写路径。4.2 启动网关并连飞书模型通了之后启动网关hermes gateway看到网关启动成功的提示后去飞书里找到你配置的机器人发一条消息。Hermes 会接收消息、调用模型、把回复发回飞书。整个链路是飞书 → Hermes 网关 → TaoToken 通道 → 模型 → 原路返回。如果你想把网关装成系统服务让它在后台常驻可以用sudo .venv/bin/hermes gateway install --system --run-as-user 你的用户名这里直接指定.venv/bin/hermes的路径是因为 sudo 会重置环境变量找不到虚拟环境里的命令。用绝对路径绕过路径查找是这类问题最稳的解法。4.3 成功结果长什么样网关启动后终端会打印连接状态飞书那边你发消息能收到回复就说明三件事都对了TaoToken Key 有效、飞书凭证有效、网关连接模式正确。这时候你可以试着在飞书里发一个稍微复杂点的指令比如让它总结一段文字确认模型调用和消息回传都正常。5. 本篇常见错排查5.1 Command hermes not found环境变量没生效。先source ~/.bashrc再重开终端。如果还不行说明安装脚本没把路径写进去手动激活虚拟环境cd ~/.hermes/hermes-agent source .venv/bin/activate激活后hermes就能用了。想一劳永逸把.venv/bin加到 PATH 里。5.2 HTTP 401: Incorrect API key provided三种可能Key 填错、Key 和地址不匹配、Key 有空格。检查~/.hermes/config.toml里的api_key和base_url确认 base_url 是https://taotoken.net/api。如果你之前用的是别的提供商地址记得换过来。Key 本身在 TaoToken 控制台的 API Keys 页面可以重新生成。5.3 app_id or app_secret is invalid飞书凭证问题。去飞书开放平台重新复制 App ID 和 App Secret注意别复制到多余字符。确认.env里的变量名是FEISHU_APP_ID和FEISHU_APP_SECRET大小写要对。改完.env后需要重启网关才会生效。5.4 sudo: hermes: command not foundsudo 重置了环境变量看不到虚拟环境里的命令。解决办法是直接用绝对路径sudo .venv/bin/hermes gateway install --system --run-as-user 你的用户名原理是绕过 sudo 的路径查找直接调用虚拟环境里的可执行文件同时用 sudo 赋予安装系统服务所需的权限。5.5 网关启动但飞书没反应先看终端有没有报连接错误。如果 connection_mode 是 websocket确认飞书应用开启了长连接模式。再检查 settings.json 里feishu.enabled是不是 true。最后确认.env里的FEISHU_CONNECTION_MODE和 settings.json 里的一致两处不一致会导致网关不知道该用哪种方式连。6. 把 Key 收口到一处后面才省心这套流程跑下来最值得保留的习惯是模型凭证只放 TaoToken 一处Hermes 的 config.toml 只引用地址和 Key飞书凭证只放 .env。这样你以后加新工具、换新模型改的都是配置而不是凭证出错面小很多。如果你后面要长期跑编码类或 Agent 类任务可以考虑用 Coding Plan 把额度固定下来避免临时 Key 到处散落。想先验证模型效果可以直接在模型对话页面试要管理 Key 就去 API Keys 页面接入细节查接入文档。把这几步走完你的 Hermes 在 Windows WSL 下就算真正落地了。