1. 为什么要在微信里养一只 Hermes Agent先说清楚 Hermes Agent 是什么。它是一个开源的 AI 智能体框架能对话、能调工具、能挂插件支持多平台网关。你可以把它理解成一个「可编程的 AI 管家内核」本身不带聊天界面需要接一个消息通道才能用。微信就是最顺手的那个通道——你每天打开次数最多的 App把管家放进去等于随身携带。适合谁三类人一是想给自己弄个私人助理的开发者二是想给团队做内部问答机器人的技术负责人三是正在学 Agent 工程化、需要一个真实可跑项目的同学。这三类人的共同点是不想从零写消息收发只想把精力花在「管家会干什么」上。接入链路其实不复杂拆开看就四段微信侧产生消息 → 网关适配器接收 → Hermes Agent 调用模型推理 → 结果回传微信。真正容易卡住的是中间那段「模型调用」——你得有个稳定的 API 通道把请求转发到大模型还要处理鉴权、超时、重试。这一步我用 TaoToken 来做统一通道一个 Key 打通模型调用省掉自己维护多套凭证的麻烦。下面按「先跑通、再优化」的顺序来。先讲前置准备再给可复制的配置然后验证消息能不能真的触发回复最后把常见报错一个个拆掉。全程命令可直接粘贴路径和字段名保持和实际一致。2. TaoToken 前置准备拿到统一 Key 与 Base URLHermes Agent 的模型调用走 OpenAI 兼容协议所以你需要三样东西Base URL、API Key、Model ID。这三件套缺一不可后面配置文件里会反复出现。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进控制台找到 API Keys 页面https://taotoken.net/console/api-keys 。在这里创建一个新 Key复制出来存好——它只完整显示一次关掉页面就看不到了。第二步确认 Base URL。TaoToken 的 API 入口是 https://taotoken.net/api 注意这个地址不带任何查询参数配置时原样填。很多同学在这里踩坑把带 UTM 的官网地址填进 Base URL结果请求 404。记住区分——官网地址是给人看的API 地址是给程序调的。第三步选 Model ID。在模型对话页面 https://taotoken.net/models 可以看到当前可用的模型列表挑一个你常用的比如对话类或代码类。把模型名记下来比如claude-sonnet-4-5这种格式填配置时要用。如果你打算长期跑编码类 Agent可以顺带看下 Coding Planhttps://taotoken.net/coding-plan 它针对高频编码场景做了额度优化。接入文档在 https://taotoken.net/doc 遇到字段不确定时以文档为准。注意Key 属于敏感凭证不要提交到 Git 仓库也不要在截图里露出完整字符串。建议用环境变量注入配置文件里只写变量名。到这里前置就齐了一个 Key、一个 Base URL、一个 Model ID。接下来把它们塞进 Hermes 的配置里。3. 可复制配置Hermes Agent 接入微信的完整 settingsHermes Agent 的配置集中在~/.hermes/config.yaml。微信接入分两块网关开关和模型通道。先看模型通道这是所有平台共用的底座。# ~/.hermes/config.yaml model: provider: openai-compatible base_url: https://taotoken.net/api api_key: ${TAOTOKEN_API_KEY} model_id: claude-sonnet-4-5 timeout: 60 max_retries: 2这里api_key用${TAOTOKEN_API_KEY}引用环境变量避免明文。在终端里设置export TAOTOKEN_API_KEY你刚才复制的Key想持久化就写进~/.bashrc或~/.zshrc然后source一下。接着是微信网关部分。Hermes v0.6.0 以上原生支持微信适配器配置块长这样gateways: weixin: enabled: true adapter: ilink auto_reply: true group_enabled: false allowed_users: []adapter: ilink走的是官方 iLink Bot 通道不需要公网 IP。group_enabled: false表示默认只在私聊响应避免群消息刷屏。allowed_users留空表示所有人可聊想白名单就填微信 ID。如果你走企业微信配置换成gateways: wecom: enabled: true corp_id: 你的企业ID agent_id: 你的应用AgentID secret: 你的应用Secret token: 你设置的Token aes_key: 你设置的EncodingAESKey企业微信这套三件套CorpID、AgentID、Secret在管理后台「应用管理 → 自建 → 创建应用」里拿。填完保存执行hermes gateway restart生效。依赖别忘装pip install aiohttp cryptography qrcodeqrcode是为了在终端直接渲染登录二维码省得你手动拼链接。装完跑hermes gateway setup交互界面里选Weixin终端会弹出二维码手机微信扫一下确认看到「微信连接成功」就通了。提示如果你用 uv 管理环境把pip换成uv pip即可其余命令不变。配置写完后先别急着聊下一步做一次请求验证确认模型通道真的通。4. 验证请求确认消息能在微信侧触发与回复配置对不对光看文件没用得发一条真实请求。分两层验证先验模型通道再验微信链路。第一层直接打 API确认 Key 和 Base URL 没问题curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回我一个 ok}] }正常返回里会有choices数组message.content就是模型回复。如果这里就报错先别碰微信把 Key 和 Base URL 核对一遍。第二层走 Hermes 自己的诊断命令hermes gateway status hermes model testgateway status会列出当前启用的网关和连接状态微信那行应该是connected。model test会发一条测试消息给模型返回延迟和模型名。两个都绿了说明链路完整。第三层真机验证。打开微信搜索联系人微信Clawbot发一句「今天几号」。几秒内应该收到回复。如果没回看终端日志hermes gateway logs --follow日志里会打印收到的消息体、调用的模型、返回耗时。看到inbound message和outbound reply成对出现就说明消息收发闭环了。实测下来从扫码到第一条回复顺利的话两分钟内搞定。慢通常慢在模型首次冷启动第二次就快了。5. 常见报错排查401、local proxy failed 与 reading choices接入过程里最常撞的几个错我按出现频率排一下每个都给定位方法。401 Unauthorized。九成是 Key 的问题。检查三处环境变量有没有source生效、配置文件里变量名拼写是否一致、Key 有没有多余空格。用echo $TAOTOKEN_API_KEY确认终端里能打印出来。如果 Key 是在别的机器上生成的确认它没被删除或过期。local proxy failed / connection refused。这个错通常出现在你本地挂了某些网络工具时Hermes 的请求被劫持到本地端口。解决办法是让请求直连检查环境变量里有没有HTTP_PROXY、HTTPS_PROXY有就临时清掉unset HTTP_PROXY HTTPS_PROXY ALL_PROXY然后重启网关。TaoToken 的 API 地址本身可直连不需要额外转发。reading choices: unexpected end of JSON。这个错说明返回体不是合法 JSON常见原因是 Base URL 填错请求打到了官网页面而不是 API 端点。核对配置里的base_url必须是https://taotoken.net/api结尾不要多加/v1之外的路径。另一个可能是模型名写错服务端返回了错误页。用第 4 节的 curl 命令单独验一次就能定位。OAuth / token expired。企业微信场景下Secret 填错或应用未发布会出现鉴权失败。回管理后台确认应用状态是「已启用」Secret 重新复制一次。个人微信的 iLink 方案偶尔会掉登录重新跑hermes gateway setup扫码即可。消息收到但不回复。先看group_enabled群聊默认关闭再看allowed_users白名单非空时只有列表内用户能触发。私聊测试最稳。排查顺序建议固定先 curl 验模型 → 再hermes model test→ 再gateway status→ 最后看日志。逐层排除比一上来就翻源码快得多。6. 把管家用起来从跑通到顺手链路通了之后真正决定体验的是模型选择和调用稳定性。日常闲聊用轻量模型就够代码和长文分析换强一点的 Model ID在配置里改model_id一行即可不用动其他部分。想对比不同模型的表现可以直接在模型对话页面 https://taotoken.net/models 里试找到合适的再写回配置。Key 的管理也值得花两分钟给不同用途建不同的 Key比如一个给微信管家、一个给本地脚本出问题能快速定位是哪个环节。控制台里可以随时吊销重建比全局共用一个 Key 安全。长期跑的话把 Hermes 挂在有公网 IP 的服务器上配合systemd或pm2做进程守护掉线自动拉起。个人微信方案对网络环境要求不高家用宽带足够企业微信需要服务器能被外网访问记得在安全组放行对应端口。最后留一个实用技巧把微信联系人备注改成你喜欢的名字比如「管家」仪式感有了找起来也快。配置文件和 Key 建议单独备份一份换机器时直接迁移省得重新扫码。接入文档在 https://taotoken.net/doc API Keys 管理在 https://taotoken.net/console/api-keys 遇到字段问题先查这两处。跑通之后你会发现真正的乐趣不在接入本身而在你给这只管家加了什么技能。