HermesClaw：开源微信AI代理路由工具，实现多智能体共存无冲突运行

原创 发布日期：
61

一、HermesClaw 是什么

HermesClaw 是一款开源轻量级 Python 微信代理路由工具，专为解决 Hermes Agent、OpenClaw、OpenCode 三大 AI 客户端在同一微信 iLink 账号下独占连接、互相冲突、启动报错、消息丢失等核心痛点而开发。

原生微信 iLink 协议存在独占机制，同一账号无法同时运行 Hermes、OpenClaw、OpenCode 任意两款及以上客户端，一旦多开就会出现 403 权限错误、消息收发异常、进程闪退等问题。HermesClaw 以统一代理入口+消息轮询转发为核心设计思路，充当唯一 iLink 连接网关，通过本地代理桥接与 ACP 协议中转技术，实现单微信账号同时挂载三款 AI 智能体，无需切换账号、无需多开微信、无需额外虚拟机，做到一键切换模式、消息无缝流转、互不抢占连接资源。

项目基于纯 Python 轻量化开发，代码精简无冗余逻辑，不侵入原有三大 AI 客户端底层代码，不修改微信协议加解密规则，仅做消息路由、请求转发、模式调度、连接复用四大核心工作，部署简单、配置极简、开箱即用，适配 Linux、macOS 主流运行环境，是微信多 AI 智能体共存运行的专用中间件工具。

二、功能特色

  1. 多AI智能体共存运行

  • 支持同一微信 iLink 账号同时运行 Hermes Agent、OpenClaw、OpenCode 三款工具。

  • 打破原生协议独占限制，解决多开报错、连接冲突、消息丢失等问题。

  • 支持单独启用任意一款、两两组合、三款同时在线三种运行模式。

  1. 一键指令模式切换
    内置专属控制指令，在微信聊天框直接输入即可切换运行规则，无需修改配置文件、无需重启服务：

  • /hermes：仅启用 Hermes Agent

  • /openclaw：仅启用 OpenClaw

  • /opencode：仅启用 OpenCode

  • /both：同时启用 Hermes 与 OpenClaw

  • /three：三款智能体同时启用

  • /whoami：查询当前运行模式与挂载状态

  1. 全类型消息无损转发
    完整兼容微信各类消息格式，原样透传不做二次编解码：

  • 文本消息、表情包、图文链接正常收发响应；

  • 语音消息支持自动转写，可直接调用 OpenCode 实现语音生成代码；

  • 图片、短视频、文件、定位等媒体资源无损转发，保留原始格式与内容。

  1. ACP协议无缝桥接
    原生适配 OpenCode ACP 通信协议，自动完成协议中转、端口映射与请求适配，无需手动配置代理端口、无需修改 OpenCode 原生配置，安装后即可直接联动使用。

  2. 轻量化无侵入架构

  • 核心代码仅数百行 Python，体积小巧、资源占用极低；

  • 不篡改微信 iLink 底层协议、不破解加解密逻辑，合规安全；

  • 完全解耦三大 AI 客户端，后续版本迭代无需适配 HermesClaw，兼容性极强。

  1. 一键部署与系统服务常驻
    提供 Shell 一键安装脚本，自动完成依赖安装、Token 提取、代理配置、系统服务注册；支持后台常驻开机自启，进程守护异常自动重启，无需人工维护。

  2. 跨平台兼容适配
    完美适配 Linux 全发行版、macOS 系统，修复低版本 Bash 兼容性问题，支持静默无人值守安装，适合服务器、本地电脑长期部署。

HermesClaw：开源微信AI代理路由工具，实现多智能体共存无冲突运行

三、技术细节

3.1 整体架构设计

HermesClaw 采用网关层-代理层-转发层三层架构设计：

  • 网关层：独占唯一微信 iLink 连接，统一接收微信服务端所有推送消息与客户端请求，避免多客户端抢占连接端口与 Token 资源；

  • 代理层：搭建双本地代理端口，分别对接 Hermes、OpenClaw 通信接口，做请求隔离与流量分流；

  • 转发层：内置消息解析路由引擎，根据当前运行模式，将微信消息精准分发至对应 AI 智能体，同时回传智能体响应内容至微信端。

3.2 核心技术原理

  1. iLink 连接独占规避
    通过抢占式注册 iLink 会话令牌，由 HermesClaw 持有唯一合法长连接，其余三款 AI 客户端不再直接对接微信服务器，全部流量经本地代理中转，从根源规避 403 权限冲突。

  2. 消息透传路由机制
    采用原样透传设计，不解析微信消息加密报文、不修改消息结构，仅做数据包转发与目标路由，大幅降低开发复杂度，同时保证协议兼容性，适配微信版本迭代。

  3. ACP 协议适配中转
    内置 ACP 协议解析与端口映射模块，自动适配 OpenCode 通信规范，实现无配置联动，无需手动设置跨域、代理端口与转发规则。

  4. 系统服务进程托管
    安装脚本自动生成 systemd 系统服务，配置开机自启、进程守护、日志输出，异常崩溃自动重启，满足长期稳定挂机运行需求。

3.3 技术栈与环境依赖

  • 开发语言：Python 为主，Shell 脚本负责部署与环境配置

  • 通信协议：微信 iLink 协议、ACP 协议、HTTP 本地代理协议

  • 运行环境：Linux、macOS，支持 Bash 3.2 及以上版本

  • 依赖组件：Python 基础库、curl、npm（适配 OpenCode 安装）

3.4 项目代码特点

  • 代码结构简洁模块化，路由、指令、协议、代理逻辑分层清晰；

  • 无第三方重型框架依赖，极简依赖列表，减少环境冲突概率；

  • 内置兼容性容错逻辑，自动检测环境、补全依赖、规避低版本系统命令兼容问题。

四、应用场景

  1. AI 开发者多工具协同场景
    同时使用 Hermes Agent 智能对话、OpenClaw 任务自动化、OpenCode 代码生成，无需切换微信账号，一站式实现聊天交互、自动化任务、语音编码全流程。

  2. 微信机器人挂机运营场景
    个人/工作室搭建微信 AI 机器人，需要同时挂载对话、自动化运维、代码助手三类能力，借助 HermesClaw 实现单账号多能力共存，降低多账号运营成本。

  3. 本地/服务器长期部署场景
    在云服务器、本地 Mac、Linux 主机常驻运行，设置开机自启，全程无人值守，稳定接收微信消息并调用对应 AI 能力响应。

  4. 学习与二次开发场景
    开源项目结构清晰、协议代理逻辑直观，适合开发者学习微信中间件开发、消息路由转发、多进程协议共存等技术思路，可基于项目二次定制扩展功能。

五、使用方法

5.1 环境前置要求

  • 已正常安装并配置 Hermes Agent、OpenClaw、OpenCode 基础环境；

  • Linux / macOS 系统，安装 curl、bash 基础工具；

  • 安装 Node.js 环境，用于全局部署 OpenCode：

npm install -g opencode-ai

5.2 一键安装部署

执行官方一键安装命令，自动完成全部配置：

curl -fsSL https://raw.githubusercontent.com/AaronWong1999/hermesclaw/main/install.sh | bash

无人值守静默安装命令：

HERMESCLAW_YES=1 bash install.sh -y

5.3 常用操作指令

  1. 查看当前运行状态：微信发送 whoami

  2. 切换单模式：/hermes、/openclaw、/opencode

  3. 切换多开模式：/both、/three

5.4 服务管理命令

# 启动服务
sudo systemctl start hermesclaw

# 开机自启
sudo systemctl enable hermesclaw

# 停止服务
sudo systemctl stop hermesclaw

# 查看运行日志
journalctl -u hermesclaw -f

5.5 卸载步骤

sudo systemctl stop hermesclaw
sudo systemctl disable hermesclaw
sudo rm -f /etc/systemd/system/hermesclaw.service
sudo systemctl daemon-reload

执行后手动删除项目安装目录，即可完全卸载恢复原始环境。

六、竞品对比

选取同类型微信 AI 多开代理工具 2 款，与 HermesClaw 进行核心维度对比：

对比维度 HermesClaw 普通微信多开容器 自定义反向代理工具
核心定位 专为 Hermes/OpenClaw/OpenCode 定制路由 微信多开隔离容器 通用型协议反向代理
多AI共存支持 原生适配三款智能体，一键切换 仅支持微信多开，不适配AI协议 需手动配置协议与路由规则
部署难度 一键脚本安装，零配置上手 需安装容器环境，配置镜像 需懂网络协议，手动改端口
侵入性 无侵入，不修改底层协议 隔离微信环境，占用资源高 需拦截篡改网络流量
系统资源占用 轻量化，内存占用极低 容器开销大，服务器成本高 中等，配置复杂冗余
专属指令控制 内置微信快捷指令，无需改配置 无专属控制能力 需命令行手动管理
兼容性 适配 Linux/macOS，低版本Bash 仅主流Linux，适配性有限 依赖网络环境，易受防火墙限制

总结优势：HermesClaw 是垂直定制化专用工具，相比通用多开容器和自定义反向代理，更贴合三款 AI 智能体的使用场景，部署更简单、资源更轻量化、使用门槛更低，无需专业网络知识即可上手。

七、常见问题解答

1. HermesClaw 主要解决什么核心问题？

主要解决 Hermes Agent、OpenClaw、OpenCode 三款工具在同一微信 iLink 账号下连接独占、互相冲突、启动报错 403、消息丢失、进程闪退的问题，实现单账号三款 AI 同时稳定运行。

2. 安装 HermesClaw 需要修改微信协议或破解加密吗？

不需要。项目采用消息透传转发机制，不篡改微信 iLink 底层协议、不破解消息加解密逻辑，仅做路由中转，安全合规且适配微信后续版本迭代。

3. 支持 Windows 系统部署使用吗？

项目原生基于 Linux 和 macOS 开发，暂无 Windows 原生适配版本，Windows 用户可通过 WSL 子系统、云服务器部署使用。

4. 安装后无法切换模式，指令无响应怎么办？

首先检查 hermesclaw 服务是否正常运行，使用 sudo systemctl status hermesclaw 查看状态；其次确认三款 AI 客户端基础配置正常，iLink Token 未失效，重启服务即可恢复。

5. 三款智能体同时开启后会出现消息错乱吗？

不会。HermesClaw 内置独立消息路由机制，按运行规则精准分发消息至对应智能体，消息隔离互不干扰，不会出现错乱、重复响应问题。

6. 重装系统或更换服务器后需要重新配置吗？

需要。iLink 账号 Token 与运行环境绑定，更换服务器或重装系统后，重新执行一键安装脚本，自动提取新 Token 即可快速恢复使用。

7. 可以在项目基础上二次开发扩展功能吗？

可以。项目开源且代码结构模块化，协议代理、指令解析、消息路由逻辑清晰，开发者可自由二次开发，新增自定义指令、消息过滤、多智能体优先级调度等功能。

八、相关链接

九、总结

HermesClaw 是面向 Hermes Agent、OpenClaw、OpenCode 三款微信 AI 智能体量身打造的开源轻量化代理路由工具，以解决账号连接独占冲突为核心目标，依托三层架构设计与 iLink 连接复用技术，实现单微信账号多 AI 智能体共存运行，具备一键部署、指令快捷切换、全类型消息无损转发、跨平台兼容、无侵入高安全等多重优势；相比传统微信多开容器和通用反向代理工具，拥有更低的使用门槛、更少的资源占用和更贴合场景的定制化能力，无需专业网络技术即可在 Linux、macOS 或云服务器中长期挂机部署，既是普通用户实现多 AI 协同使用的便捷工具，也是开发者学习微信协议路由、中间件开发的优质开源项目。

AI代理 开源项目
打赏

版权及免责申明：本文由@AI工具集原创发布。该文章观点仅代表作者本人，不代表本站立场。本站不承担任何相关法律责任。

如若转载，请注明出处：https://www.aipuzi.cn/ai-news/hermesclaw.html

THE END
作者头像
AI工具集
工具不孤岛，AI集大成——这里有你要的一切智能解法