AaronWong1999/hermesclaw

Run Hermes Agent and OpenClaw on the same WeChat account

HermesClaw – 複数のWeChat連携LLMボットを1つのアカウントで実行

機能概要

HermesClawは、1つのWeChatアカウントで3つの異なるAIエージェントと同時に通信できる軽量なPythonプロキシです。

  • Hermes Agent (Nous Research)
  • OpenClaw (「ロブスター」アシスタント)
  • OpenCode (コード特化型LLM、例: MiniMax M2.5 Free)

WeChatではアカウントごとにiLink接続が1つしか許可されていないため、通常はHermes AgentまたはOpenClawのどちらかしか実行できません。HermesClawは唯一のiLinkポーラーとなり、受信した各メッセージを適切なローカルプロキシ(またはOpenCode用のACPブリッジ)に転送します。シンプルなスラッシュコマンドでアクティブなボットを切り替えたり、2つまたは3つのボットが同時に応答するようにできます。

利用価値

  • 強みの組み合わせ – 一般的なチャットはHermesに任せつつ、特定のクエリはOpenClawに応答させたり、コード関連のタスクはOpenCodeに任せたりできます。
  • 音声からコードへ – WeChatの音声メッセージを送信すると、HermesClawが文字起こしをOpenCodeに転送し、コードの生成や編集が可能です。
  • ワンクリック切り替え – /hermes、/openclaw、/opencode、/both、/threeでルーティングを即座に変更できます。
  • 元のエージェントを変更不要 – プロキシは生のiLinkメッセージを転送するだけで、各エージェントは独自のメディア復号化、フォーマット、LLM呼び出しを実行します。

仕組み(概要)

 iLink API  ←→  HermesClaw (唯一のポーラー)
   │               │          │          │
   │               ├─ Proxy A (19999) → OpenClaw gateway
   │               ├─ Proxy B (19998) → Hermes gateway
   │               └─ ACP bridge      → OpenCode subprocess
   │
   └─ 生のiLinkメッセージ(テキスト、音声文字起こし、画像/ビデオURLなど)

HermesClawはメッセージをリッスンし、コマンドプレフィックスを確認し、ペイロードを選択されたプロキシに転送します。複数のエージェントがアクティブな場合、応答は小さなタグ([Hermes Agent]、[OpenClaw]、[OpenCode])付きでWeChatに送り返されます。

はじめに

  1. 必要なエージェントをインストール – 少なくとも1つ:
    • OpenClaw + clawbot (openclaw-weixinパッケージ)
    • WeChatゲートウェイ付きのHermes Agent
  2. ワンライナーインストーラーを実行:
    curl -fsSL https://raw.githubusercontent.com/AaronWong1999/hermesclaw/main/install.sh | bash
    
    • 存在するゲートウェイを検出
    • 設定ファイルからiLinkトークンを抽出
    • 各ゲートウェイをローカルプロキシポートに向けるようパッチ
    • Python依存関係をインストール (requests、python-dotenv)
    • systemdサービス(macOSではlaunchd)を設定してHermesClawを常時実行
  3. ゲートウェイを再起動し、WeChatで/whoamiを送信してルートを確認します。
  4. (オプション) OpenCodeを追加 – npm install -g opencode-ai; インストーラーが自動検出し、/opencodeと/threeを有効にします。

WeChatで使えるコマンド

コマンド 効果
/hermes Hermes Agentのみにルーティング
/openclaw OpenClawのみにルーティング
/opencode OpenCodeのみにルーティング
/both Hermes + OpenClawに送信。応答はボット名がプレフィックスされます
/three 3つのエージェントすべてに同時送信
/whoami アクティブなルートと各プロキシの状態を表示
その他のテキスト 現在アクティブなエージェントに転送

インストールの詳細

  • Pythonプロキシ – hermesclaw.py (約870行) は2つのHTTPプロキシとACPブリッジを実装。
  • インストーラースクリプト – install.shは環境を自動検出し、設定ファイルをパッチし、systemdユニット(macOSではlaunchd plist)を作成し、-yまたはHERMESCLAW_YES=1で非対話的に実行可能。
  • テスト – 117件のpytestケースがルーティング、メディア処理、ACPリカバリ、インストーラーのエッジケースをカバー。
  • アンインストール – スクリプトによる削除で元のゲートウェイ設定を復元し、バックグラウンドサービスを無効化。

開発者

Aaron Wong (@AaronWong1999)、Hermes AgentおよびOpenClawコミュニティからの貢献あり。プロジェクトはMITライセンスです。


HermesClawはAIモデル自体を変更しません。単に複数の既存WeChat連携LLMボットを1つのアカウントで実行できるようにするだけです。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト