Hermes Agent 接入微信完整教程:工具调用 + 消息通道全打通(2026)

Hermes Agent 接入微信完整教程:工具调用 + 消息通道全打通(2026)Hermes Agent 是以 NousResearch Hermes 3 模型为核心 具备结构化工具调用能力的 AI 智能体框架 通过 iLink Bot API 适配层或 CowAgent 兼容后端 可将 Hermes 的 function calling 能力与微信消息通道打通 在微信中直接触发搜索 计算 文件处理等 Agent 任务 目前社区已有 hermes wechat

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



Hermes Agent 是以 NousResearch Hermes 3 模型为核心、具备结构化工具调用能力的 AI 智能体框架。通过 iLink Bot API 适配层或 CowAgent 兼容后端,可将 Hermes 的 function calling 能力与微信消息通道打通,在微信中直接触发搜索、计算、文件处理等 Agent 任务。目前社区已有 hermes-wechat、hermesclaw、CowAgent 等多个开源方案,覆盖个人微信和企业微信两类场景。

HermesAgent接入微信-img1


普通微信聊天机器人只能做问答;Hermes Agent 的差异在于工具调用——模型能主动决定"调用哪个函数、传什么参数、拿到结果再推理"。接入微信后,用户在聊天框发一句话,Agent 可以自动完成多步任务:

  • 查询天气 → 结合日程 → 发送提醒
  • 搜索资料 → 摘要整理 → 存入云盘
  • 解析图片内容 → 结构化提取 → 写入表格

Hermes 3 模型(基于 Meta Llama-3.1 8B 微调)的工具调用格式稳定,按 NousResearch 2024 年 8 月发布的技术报告(arXiv: 2408.11857),其 function calling 准确率在 8B 量级开源模型中表现最优,月下载量超过 86,900 次(Hugging Face 数据)。


HermesAgent接入微信-img2

方案 项目 Stars 接入方式 适合人群 Hermes 支持 hermes-wechat RongleCat/hermes-wechat 22 iLink Bot API + weixin.py 适配层 熟悉 Hermes Gateway 的开发者 原生,直接接 Hermes Gateway CowAgent zhayujie/CowAgent 43.2k QR 码扫码授权,多 LLM 后端 快速上手、不想改底层 通过 OpenAI 兼容 API 接 Hermes 风格模型 hermesclaw AaronWong1999/ hermesclaw 69 OpenClaw + Hermes 同一账号 已在用 OpenClaw 的用户 原生,ReAct 架构

选型建议:

  • 想要完整 Hermes function calling 体验 → hermes-wechat(原生支持)
  • 想快速跑通、模型可随时换 → CowAgent(43k stars 社区支撑强)
  • 已有 OpenClaw 部署 → hermesclaw(复用现有环境)

hermes-wechat 的架构是四组件管道:

微信 App ↔ iLink Bot API ↔ weixin.py 适配层 ↔ Hermes Gateway 
git clone https://github.com/RongleCat/hermes-wechat cd hermes-wechat uv add aiohttp cryptography qrcode pillow 

使用 uv 包管理器(比 pip 快 10–100x)。若未安装:pip install uv

# 将 weixin.py 放入 Hermes platforms 目录 cp weixin.py /path/to/hermes/platforms/ # Patch Hermes 核心文件以注册微信平台 python patch.py --hermes-dir /path/to/hermes 
platforms: wechat: type: weixin ilink_token: 
     
    
       <你的 ilink="" bot="" api="" token="">
         ilink_app_id: 
        
          poll_timeout: 35 # 长轮询超时(秒) chunk_size: 4000 # 长消息自动分段字符数 models: default: provider: openai # OpenAI 兼容格式 api_base: https://api.example.com/v1 api_key: 
         
           model: 
          <模型id待核实:填写推理服务商提供的 hermes="" 3="" 模型="" id,如="" ollama="" 本地为="" nous-hermes3:8b=""> 
           
          
         
       
python main.py --platform wechat # 终端打印二维码,用微信扫码授权 # 登录凭证自动缓存,重启无需再扫 
功能 支持情况 文字消息(含长文自动分段) ✅ 图片/文件收发 ✅ 接收;发送 ✅ 语音消息接收(转文字) ✅ 语音消息发送 ❌ 暂不支持 Markdown 渲染 ❌ 微信不支持 群聊消息路由 ⚠️ 无 @mention 区分逻辑

CowAgent(前身 chatgpt-on-wechat,43.2k stars)通过 open_ai_api_base 参数支持任意 OpenAI 兼容端点,可以接入部署了 Hermes 模型的推理服务。

git clone https://github.com/zhayujie/CowAgent cd CowAgent pip3 install -r requirements.txt pip3 install -e . 
{ "channel_type": "weixin", "model": " 
      
    
        <模型id待核实:填写推理服务商提供的模型 id="">
          ", "open_ai_api_key": " 
         
           ", "open_ai_api_base": "https://api.example.com/v1", "agent": true, "agent_workspace": "./workspace", "conversation_max_tokens": 50000, "max_history_num": 20 } 
          
        

字段说明:

  • channel_type: "weixin" → 个人微信通道(企业微信改为 "wechatcom_app"
  • open_ai_api_base → 填写任何提供 Hermes 模型的 OpenAI 兼容端点
  • agent: true → 开启 Agent 模式,支持工具调用循环
# Linux / macOS bash run.sh # Windows powershell run.ps1 

启动后终端打印二维码,扫码即完成授权。管理界面访问 http://localhost:9899/chat

若不想本地部署 Hermes 模型,可使用支持 OpenAI 兼容协议的云端推理服务,在 open_ai_api_base 中填入对应端点,model 填写服务商提供的 Hermes 或同等能力模型的 ID。例如,七牛云 AI 推理服务兼容 OpenAI 标准接口,接入后无需修改 CowAgent 其他配置。


Hermes 3 使用 ChatML 格式注入工具定义,工具调用输出格式为 JSON wrapped in 标签:

<|im_start|>system You are a helpful assistant with access to the following tools: [ { "name": "search_web", "description": "搜索互联网获取最新信息", "parameters": { "type": "object", "properties": { "query": {"type": "string", "description": "搜索关键词"} }, "required": ["query"] } } ] <|im_end|> 
 
       
    
         
           {"name": "search_web", "arguments": {"query": "今天上海天气"}} 
          

<|im_start|>tool {“result”: “上海今天多云,气温 18-24℃,东南风 3 级”} <|im_end|> <|im_start|>assistant 今天上海多云,气温 18 到 24 度,东南风 3 级,外出可以不带伞。 <|im_end|> 

维度 个人微信 企业微信(WeCom) 接入方式 QR 码扫码(非官方) 官方 API,稳定性高 封号风险 ⚠️ 存在,建议用小号 ✅ 无封号风险 群管理能力 有限 完整(可 @mention 路由) 消息类型 文字/图片/语音/文件 全类型 + 卡片/审批等 适合场景 个人助手、小团队 企业内部 AI 助手

推荐路径:

  • 个人开发者测试 → 个人微信小号 + hermes-wechat 或 CowAgent
  • 企业正式部署 → 企业微信官方 API(channel_type: “wechatcom_app”

Q:Hermes Agent 接微信会封号吗?
个人微信接入走的是非官方协议(iLink API 或扫码模拟),存在一定封号风险。建议使用专用小号,避免在高频发消息或群发场景下使用。企业微信通过官方 API 接入,无封号风险,是生产环境的推荐选择。



Q:不想本地跑 Hermes 模型,有云端方案吗?
CowAgent 和 hermes-wechat 均支持通过 api_base/api_key 对接任意 OpenAI 兼容的云端推理服务。只需在配置文件中替换端点地址,无需本地 GPU。支持 Hermes 格式工具调用的推理服务可直接接入,不支持的服务降级为普通对话模式。



Q:hermes-wechat 和 CowAgent 能同时跑在同一个微信号上吗?
不推荐。两个框架同时监听同一微信账号会导致消息争抢和响应混乱。若需在一个微信号上同时运行 Hermes Agent 和 OpenClaw 风格能力,可使用 hermesclaw 项目,它专为此场景设计。



Q:Hermes 的 格式和 OpenAI function calling 格式有什么区别?
OpenAI 通过 HTTP 响应体的 tool_calls 字段返回工具调用结果(JSON 结构);Hermes 在文本输出中内嵌 XML 标签。两种格式均可被解析,但在使用本地推理引擎(Ollama/llama.cpp)时,Hermes XML 格式更稳定,不依赖推理引擎对 tool_calls 字段的特殊支持。



Q:微信群里如何 @Agent 触发响应?
hermes-wechat 当前版本不区分 @mention 和普通群消息,所有群消息均会触发 Agent。若需要精确路由,需在 weixin.py 适配层中手动添加消息过滤逻辑(判断消息内容是否包含 Bot 昵称)。




Hermes Agent 接入微信的核心路径有两条:原生 Hermes Gateway 方案(hermes-wechat,保留完整工具调用链路)和 CowAgent 兼容方案(43.2k stars,上手成本低,支持随时切换 LLM 后端)。个人用户推荐 CowAgent 快速验证,生产环境推荐企业微信官方 API 搭配 hermes-wechat 保证稳定性。

根据 NousResearch 技术报告(arXiv: 2408.11857,2024 年 8 月),Hermes 3 在 8B 量级模型中具备最可靠的 function calling 能力,结合微信 9 亿月活用户的触达规模,是当前成本最低的 AI Agent 消息通道之一。

本文内容基于 2026 年 4 月 GitHub 项目状态整理,各项目更新活跃,建议以对应仓库 README 为准。


  • hermes-wechat 项目:github.com/RongleCat/hermes-wechat
  • CowAgent 文档:github.com/zhayujie/CowAgent
  • Hermes 3 技术报告:arxiv.org/abs/2408.11857
  • Hermes Function Calling 示例:github.com/NousResearch/Hermes-Function-Calling
  • 七牛云 AI 大模型广场:多模型同屏竞技对比
  • 七牛云 API Key:兼容 OpenAI/Anthropic 双标准,一个 Key 接入 Claude、DeepSeek、Gemini 等 200+ 模型

小讯
上一篇 2026-04-20 23:58
下一篇 2026-04-20 23:56

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/264929.html