Repolode
Submit
AaronWong1999

AaronWong1999/hermesclaw

A thin local proxy that lets Hermes Agent, OpenClaw and OpenCode share one WeChat iLink account, switchable with chat commands.

View on GitHub
Stars
749
Forks
79
Open issues
4
Last commit
2 days ago

What is it?

Hermes Agent and OpenClaw both connect to WeChat through the iLink API, but each gateway takes exclusive control of the connection, so running both on one account causes token conflicts and 403 errors. HermesClaw becomes the single iLink poller and runs two local proxy servers, one for each gateway, so each gateway believes it is talking directly to iLink. It also adds OpenCode through its ACP subprocess protocol.

Users switch routing with chat commands such as /hermes, /openclaw, /opencode, /both and /three. In multi-agent modes, replies are prefixed with the agent name. Text and voice transcriptions are forwarded, while media is passed through as raw iLink messages for each gateway to decrypt and handle itself. The core is a Python script of roughly 870 lines, installed by a script that detects existing gateways and sets up a systemd service on Linux or a launchd agent on macOS.

Key features

  • 01Acts as the sole iLink poller so Hermes and OpenClaw can share one WeChat account.
  • 02Switches between Hermes, OpenClaw and OpenCode with commands like /hermes and /three.
  • 03Forwards voice transcriptions and passes media through as raw iLink messages.
  • 04Connects OpenCode through its ACP subprocess protocol without a proxy port.
  • 05Includes an installer that detects installed gateways and sets up a background service on Linux or macOS.

Use cases

  • Running Hermes Agent and OpenClaw side by side on a single WeChat account.
  • Chatting with a coding agent like OpenCode from WeChat, including by voice.
  • Using one agent to inspect or debug problems in another agent's setup from a phone.

Topics

#ai-agent#wechat#chatbot#self-hosted#python#llm-agent#messaging-bridge#clawbot#dual-agent#hermes-agent

FAQ

What is hermesclaw?
A thin local proxy that lets Hermes Agent, OpenClaw and OpenCode share one WeChat iLink account, switchable with chat commands. Hermes Agent and OpenClaw both connect to WeChat through the iLink API, but each gateway takes exclusive control of the connection, so running both on one account causes token conflicts and 403 errors. HermesClaw becomes the single iLink poller and runs two local proxy servers, one for each gateway, so each gateway believes it is talking directly to iLink. It also adds OpenCode through its ACP subprocess protocol.
Is hermesclaw free to use? What license does it have?
hermesclaw is open source under the MIT license. Check the license terms before using it in commercial products.
Is hermesclaw still maintained?
Actively maintained. The last commit to hermesclaw was on Oct 20, 2026.
What can I use hermesclaw for?
Running Hermes Agent and OpenClaw side by side on a single WeChat account. Chatting with a coding agent like OpenCode from WeChat, including by voice. Using one agent to inspect or debug problems in another agent's setup from a phone.
Where can I get hermesclaw?
The source code and installation instructions are on GitHub: https://github.com/AaronWong1999/hermesclaw

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects