HermesClaw
A thin Python proxy that enables running both Hermes Agent and OpenClaw simultaneously on the same WeChat account via a dual-proxy gateway architecture.
At a Glance
Completely free and open-source under the MIT License. Free to use, modify, and distribute.
Engagement
Available On
Alternatives
Listed Apr 2026
About HermesClaw
HermesClaw is an open-source Python proxy (~500 lines) that solves the iLink token conflict preventing Hermes Agent and OpenClaw from running on the same WeChat account. It acts as the sole iLink poller and spins up two local proxy servers — one for each gateway — so both agents can operate concurrently. Recognized by the Nous Research Hermes Agent team in their official GitHub README community section, HermesClaw is a lightweight community bridge with no media processing or agent API calls of its own.
- Dual-agent routing — Send
/hermes,/openclaw, or/bothin WeChat to switch which AI agent handles your messages in real time. - Single-command install — Run one
curlcommand; the smart installer auto-detects installed gateways, extracts the iLink token, patches config files, installs Python deps, and sets up a systemd service. - AI-assisted install — Drop a text prompt into any AI agent on the target machine to fully automate detection, patching, and service setup.
- Raw iLink message forwarding — HermesClaw forwards raw protocol messages including text, voice transcriptions, and media CDN payloads; each gateway handles its own decryption and AI interaction natively.
- ThreadingHTTPServer proxies — Proxy servers use
ThreadingHTTPServerto prevent "Response formatting failed" errors under concurrent load. - Media symlink fix — Installer creates an OpenClaw media symlink to resolve path mismatches between gateways.
- Hermes message-splitting patch — Optional
fix_hermes_splitting.shpatches Hermes Agent'sweixin.pyto send long replies as single messages instead of paragraph-split chunks. - 59 pytest tests — Core, proxy, and recovery test suites ship with the project for reliability validation.
- Clean uninstall — Supports both AI-assisted and manual uninstall, restoring all patched config files and removing the systemd service.
- MIT licensed — Free to use, modify, and distribute; not affiliated with NousResearch or OpenClaw.
Community Discussions
Be the first to start a conversation about HermesClaw
Share your experience with HermesClaw, ask questions, or help others learn from your insights.
Pricing
Open Source (MIT)
Completely free and open-source under the MIT License. Free to use, modify, and distribute.
- Dual-proxy gateway architecture
- Single-command installer
- AI-assisted install support
- In-chat routing commands
- systemd service setup
Capabilities
Key Features
- Dual-proxy gateway architecture for simultaneous Hermes Agent and OpenClaw on one WeChat account
- Single-command curl installer with smart 8-case gateway detection
- AI-assisted install via natural language prompt
- In-chat routing commands: /hermes, /openclaw, /both, /whoami
- Raw iLink protocol message forwarding (text, voice, images, video, files)
- ThreadingHTTPServer proxies to prevent concurrent request failures
- OpenClaw media symlink creation for path mismatch fix
- Optional Hermes weixin.py patch to disable newline-based message splitting
- systemd service setup and management
- 59 pytest tests covering core, proxy, and recovery scenarios
- Clean uninstall with config restoration
