1. 为什么要在 WSL 里折腾 Hermes 和 TaoToken如果你和我一样主力开发环境是 Windows但日常又离不开 Linux 那套命令行工具链那 WSL 基本就是绕不开的选择。Hermes 这个 Agent 框架最近在开发者圈子里讨论度不低它最大的特点是能把飞书、微信这类即时通讯平台变成你的 Agent 入口——你在飞书里给机器人发条消息背后跑的是你本地的 Hermes 实例能调 Skill、能读写文件、能跑定时任务。听起来很美好但真到落地的时候第一道坎往往不是 Hermes 本身而是网络通道和 Key 管理。我最初的做法是在.env里塞了好几个不同厂商的 API KeyOpenRouter 一个、DeepSeek 一个、Kimi 一个每个平台的计费方式、限流策略、模型命名规则都不一样。调试的时候经常出现「这个 Key 在这个 Skill 里能用换个 Skill 就报 401」的情况。后来我把所有模型调用统一收敛到 TaoToken 的 API 通道上用一套 Key 管理所有模型请求配置复杂度直接降了一个数量级。这篇笔记就围绕这个思路展开在 WSL 环境里把 Hermes 跑起来用 TaoToken 做统一模型通道然后打通飞书和微信两个 Skill 入口。适合谁看如果你满足下面任意一条这篇内容应该能帮你省掉几个小时的排查时间已经在 Windows 上装了 WSL想在里面跑 Hermes需要把 Agent 接入飞书或微信但被回调配置和权限范围搞得头大手头有多个模型厂商的 Key想统一管理或者单纯想看看一个完整的 Agent 落地配置长什么样。整个流程我会按「环境准备 → TaoToken 接入 → Hermes 配置 → 飞书/微信 Skill 打通 → 验证 → 排障」的顺序来写每一步都给可复制的命令和配置文件骨架。你不需要从头到尾照抄但建议至少把 TaoToken 的 Key 配置和 Hermes 的config.yaml结构看一遍这两块是后面所有操作的基础。2. WSL 环境准备与 Hermes 安装2.1 确认 WSL 发行版和网络模式先确认你当前的 WSL 状态。在 Windows 终端里执行wsl --list --all wsl cat /etc/os-release | head -3 uname -a如果你看到的是docker-desktop相关的发行版建议单独装一个 Ubuntu不要和 Docker Desktop 共用。共用环境下端口映射和网络配置容易出玄学问题后面配 Gateway 回调的时候会特别难受。wsl --install -d Ubuntu-22.04 wsl --set-default Ubuntu装完之后为了让 WSL 里的服务能被 Windows 侧访问飞书和微信的回调需要建议开启镜像网络模式。在 Windows 用户目录下创建或编辑.wslconfig[wsl2] networkingModemirrored然后重启 WSLwsl --shutdown wsl镜像模式下WSL 和 Windows 共享网络栈localhost互通省掉很多端口转发的麻烦。这一步不做也能跑但后面配 Gateway 的时候大概率要回来补。2.2 安装 Hermes进入 WSL 后执行官方安装脚本curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash安装完成后hermes命令可能不在当前 shell 的 PATH 里需要重新加载环境变量source ~/.bashrc hermes version如果hermes version能正常输出版本号说明安装成功。首次安装不需要执行hermes update后续可以周期性跑一下更新。2.3 启动 GatewayHermes 的消息网关是飞书和微信 Skill 的入口先把它跑起来hermes gateway前台运行方便看日志。确认没问题后可以切后台守护进程hermes gateway --daemon hermes gateway statusgateway status会列出各平台的接入状态后面配完飞书和微信后这里应该能看到对应的平台标识变成 active。3. TaoToken 统一 Key 与 API 通道接入3.1 为什么用 TaoToken 做统一通道Hermes 本身支持多种模型提供商你可以在.env里分别配OPENROUTER_API_KEY、DEEPSEEK_API_KEY、ANTHROPIC_API_KEY等等。但实际用下来多 Key 管理有几个烦人的点每个厂商的模型命名不一样切换模型要改配置限流和计费分散在多个后台对账麻烦有些 Skill 内部硬编码了 provider 判断逻辑换 Key 就报错。TaoToken 的思路是提供一个统一的 API 通道你用一套 Key 就能访问多个模型。对 Hermes 来说只需要把它当成一个 OpenAI 兼容的 provider 来配就行。官网地址是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 端点是https://taotoken.net/api。3.2 获取 API Key登录 TaoToken 控制台在 API Keys 页面创建一个新的 Key。建议按用途命名比如hermes-wsl-dev方便后面排查问题时定位。创建后立即复制保存页面刷新后就不再完整显示了。3.3 在 Hermes 中配置 TaoTokenHermes 的敏感信息放在~/.hermes/.env非敏感配置放在~/.hermes/config.yaml。先配.env# ~/.hermes/.env TAOTOKEN_API_KEYsk-你的taotoken密钥然后在config.yaml里把 TaoToken 配成模型提供商。Hermes 的配置结构大致如下# ~/.hermes/config.yaml model: provider: taotoken default: claude-sonnet-4-20250514 providers: taotoken: base_url: https://taotoken.net/api api_key_env: TAOTOKEN_API_KEY models: - claude-sonnet-4-20250514 - gpt-4o - deepseek-chat这里的关键是base_url指向 TaoToken 的 API 端点api_key_env告诉 Hermes 从环境变量里读 Key而不是把 Key 明文写在 YAML 里。models列表是你打算通过这个通道调用的模型按需增减。配完之后可以用 Hermes 的配置检查命令验证hermes config check hermes config set model.provider taotokenconfig check会校验 YAML 语法和必填字段如果有拼写错误或缩进问题会直接报出来。4. 飞书 Skill 接入配置4.1 自动配置方式Hermes 提供了交互式配置向导对飞书接入做了适配hermes setup gateway在平台列表里选Feishu/Lark然后按提示操作扫描二维码登录飞书小号 → 选择Use DM pairing approval (recommended)→ 禁用群聊个人电脑建议关掉避免被拉进群后机器人乱响应→ 确认使用 User service → 重启 Gateway。hermes gateway restart然后在飞书里给机器人发一条消息机器人会回复一个配对码在命令行执行hermes pairing approve feishu 配对码配对成功后飞书侧的 Skill 入口就通了。4.2 手动配置方式如果你想更精细地控制权限可以走手动配置。去飞书开放平台创建企业自建应用添加机器人能力然后在权限管理里批量导入以下权限{ scopes: { tenant: [ im:message, im:message:send_as_bot, im:message.p2p_msg:readonly, im:message.group_at_msg:readonly, im:resource, im:chat.members:bot_access, im:chat.access_event.bot_p2p_chat:read, application:application:self_manage, cardkit:card:read, cardkit:card:write ], user: [ im:chat.access_event.bot_p2p_chat:read ] } }然后在「凭证与基础信息」页面拿到 App ID 和 App Secret回到 Hermes 配置向导里选择手动输入hermes setup gateway # 选择 Feishu/Lark → Enter existing App ID and App Secret manually # 填入 App ID 和 App Secret # 连接方式选 websocket # 配对策略选 Use DM pairing approval # 禁用群聊事件订阅部分在飞书开放平台的「事件与回调」里配置长连接订阅im.chat机器人进群/退群和im.message消息已读/撤回/接收事件然后发布版本。4.3 验证飞书 Skill配置完成后在飞书里给机器人发一条测试消息比如「帮我列出当前目录下的文件」。如果 Hermes 的 Gateway 日志里能看到消息接收记录并且机器人正常回复说明飞书 Skill 已经打通。tail -f ~/.hermes/logs/gateway.log5. 微信 Skill 接入配置5.1 扫码接入微信接入相对简单在hermes setup gateway的平台列表里选Weixin会生成一个二维码用微信扫码登录。登录成功后Hermes 会自动保存account_id、token和base_url到配置里。5.2 手动配置 .env如果你想手动控制访问策略可以在~/.hermes/.env里补充# ~/.hermes/.env WEIXIN_ACCOUNT_IDyour-account-id WEIXIN_DM_POLICYopen WEIXIN_ALLOWED_USERSuser_id_1,user_id_2 WEIXIN_HOME_CHANNELchat_id WEIXIN_HOME_CHANNEL_NAMEHomeWEIXIN_DM_POLICY控制私聊策略open表示允许所有用户私聊allowlist表示只允许WEIXIN_ALLOWED_USERS里的用户。个人使用建议设成allowlist避免陌生人触发你的 Agent。5.3 群聊配置微信个人号的群聊默认是关闭的防止被拉进大量群组后机器人乱响应。如果确实需要开启在~/.hermes/config.yaml里加platforms: weixin: enabled: true group_policy: open改完重启 Gatewayhermes gateway restart5.4 验证微信 Skill在微信里给机器人发一条消息比如「现在几点了」观察是否正常回复。微信原生不支持 MarkdownHermes 会自动做格式转换所以回复里如果有代码块或表格会转成纯文本形式。6. 从 WSL 发起请求并验证 Skill 响应6.1 命令行直接验证在 WSL 终端里可以直接用 curl 测试 TaoToken 通道是否通curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 OK 两个字母}], max_tokens: 10 }如果返回的 JSON 里有正常的choices字段说明 TaoToken 通道没问题。如果报 401检查.env里的 Key 是否正确加载如果报 404检查base_url是否写成了https://taotoken.net/api而不是带/v1的路径。6.2 通过 Hermes 验证 Skill在 WSL 里启动 Hermes 交互模式hermes然后输入一条会触发 Skill 的指令比如/plan 帮我在当前目录创建一个 test-skill 文件夹里面放一个 README.mdHermes 会先输出执行计划确认后执行。如果 Skill 正常触发你会看到文件创建成功的反馈。这一步验证的是 Hermes 本体的 Skill 调度能力。6.3 跨平台验证最后做一次端到端验证在飞书里给机器人发「帮我在 WSL 里创建一个 hello.txt 文件」然后在 WSL 终端里检查文件是否真的创建了ls -la ~/hello.txt如果文件存在说明「飞书消息 → Hermes Gateway → Skill 执行 → WSL 文件系统」这条链路完全打通。微信侧同理发一条消息让机器人执行pwd命令看返回的路径是不是你的 WSL 工作目录。7. 本篇常见错误排查7.1 hermes 命令找不到安装脚本执行完后hermes不在 PATH 里。执行source ~/.bashrc重新加载或者直接开一个新终端窗口。如果还是找不到检查~/.bashrc里是否有export PATH$HOME/.local/bin:$PATH这一行。7.2 Gateway 启动后飞书无响应先看日志tail -f ~/.hermes/logs/gateway.log常见原因有三个飞书应用的事件订阅没有发布版本长连接没有验证成功权限范围缺少im:message相关权限。回到飞书开放平台逐项检查权限变更后需要重新发布版本才生效。7.3 TaoToken 请求返回 401检查.env里的TAOTOKEN_API_KEY是否有多余空格或换行。Hermes 读取环境变量时不会自动 trim末尾多一个空格就会导致认证失败。可以用echo $TAOTOKEN_API_KEY | xxd | tail -1看一下末尾字节。7.4 微信扫码后无法收发消息确认WEIXIN_DM_POLICY的设置。如果是allowlist模式你的微信用户 ID 必须在WEIXIN_ALLOWED_USERS列表里。另外检查~/.hermes/sessions/wechat/目录是否有会话文件生成没有的话说明消息根本没到 Gateway。7.5 Skill 执行报模型错误如果 Skill 内部调用模型时报model not found检查config.yaml里models列表是否包含你指定的模型名。TaoToken 的模型命名和官方可能略有差异以控制台里列出的可用模型为准。8. 配置骨架汇总与后续建议把前面散落的配置集中一下方便你对照检查。~/.hermes/.envTAOTOKEN_API_KEYsk-你的taotoken密钥 WEIXIN_ACCOUNT_IDyour-account-id WEIXIN_DM_POLICYallowlist WEIXIN_ALLOWED_USERSyour_user_id~/.hermes/config.yamlmodel: provider: taotoken default: claude-sonnet-4-20250514 providers: taotoken: base_url: https://taotoken.net/api api_key_env: TAOTOKEN_API_KEY models: - claude-sonnet-4-20250514 - gpt-4o - deepseek-chat platforms: feishu: enabled: true group_policy: disabled weixin: enabled: true group_policy: disabled这套配置跑通之后你可以进一步做的事把常用的 Skill 固定下来用hermes curator pin skill-name防止被自动归档用hermes cron配定时任务让 Agent 每天定时推送消息到飞书或微信如果团队里多人用可以用hermes profile做项目隔离每个项目独立的记忆和 Skill 库。最后提醒一点.env和整个~/.hermes/目录不要提交到 Git。如果需要在团队间共享配置用hermes dump --redact导出脱敏版本。TaoToken 的 Key 如果怀疑泄露直接在控制台吊销重新生成然后更新.env并重启 Gateway 即可。
