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

普通微信聊天机器人只能做问答;Hermes Agent 的差异在于工具调用——模型能主动决定"调用哪个函数、传什么参数、拿到结果再推理"。接入微信后,用户在聊天框发一句话,Agent 可以自动完成多步任务:
- 查询天气 → 结合日程 → 发送提醒
- 搜索资料 → 摘要整理 → 存入云盘
- 解析图片内容 → 结构化提取 → 写入表格
Hermes 3 模型(基于 Meta Llama-3.1 8B 微调)的工具调用格式稳定,按 NousResearch 2024 年 8 月发布的技术报告(arXiv: 2408.11857),其 function calling 准确率在 8B 量级开源模型中表现最优,月下载量超过 86,900 次(Hugging Face 数据)。

选型建议:
- 想要完整 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="">
模型id待核实:填写推理服务商提供的>
你的>
python main.py --platform wechat # 终端打印二维码,用微信扫码授权 # 登录凭证自动缓存,重启无需再扫
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 }
模型id待核实:填写推理服务商提供的模型>
字段说明:
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|>
推荐路径:
- 个人开发者测试 → 个人微信小号 + 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+ 模型
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/264929.html