Hermes Bridge

> Built by GetAgentIQ — [getagentiq.ai](https://getagentiq.ai)

Run Hermes Agent as an OpenClaw sub-agent. Best of both worlds: OpenClaw orchestration + Hermes self-repair.

Architecture

OpenClaw (orchestrator)
  ├── Native agents (Sonnet, Haiku, etc.)
  ├── Hermes Agent (via bridge)
  │     ├── Self-repair capability
  │     ├── Local model support (Gemma 4, etc.)
  │     └── Coding specialization
  └── Results → OpenClaw memory/flow

Commands

Start Hermes Bridge

Start the Hermes bridge

Runs scripts/hermes_bridge.py --start to verify Hermes is installed and start the bridge process.

Send Task to Hermes

Send this coding task to Hermes: build a REST API for user management

Runs scripts/hermes_bridge.py --task "build a REST API for user management" to delegate to Hermes.

Check Hermes Status

Check if Hermes is running

Runs scripts/hermes_bridge.py --status to check Hermes availability.

Configure Bridge

Configure Hermes bridge with model gemma4-27b and workspace /tmp/hermes-work

Runs scripts/hermes_bridge.py --config --model gemma4-27b --workspace /tmp/hermes-work

When to Use Hermes vs Native

Route to Hermes:

• Iterative coding tasks that may need self-repair (broken tests → fix → retry)
• Tasks where you want zero API cost (Hermes + local model)
• Long-running code generation (Hermes manages its own context)
• Python/JS/Rust projects where Hermes has strong patterns

Keep in OpenClaw:

• Multi-agent orchestration
• Channel integration (Discord, Telegram, Slack)
• Memory management and persistence
• Tasks requiring web search, browser, or external tools
• Anything needing OpenClaw's hook system

Configuration

Bridge config stored at ~/.openclaw/workspace/hermes-bridge-config.json:

{
  "hermes_path": "hermes",
  "model": "gemma4-27b",
  "workspace": "/tmp/hermes-bridge",
  "timeout_seconds": 300,
  "self_repair_enabled": true,
  "max_repair_attempts": 3,
  "capture_output": true
}

Reference Files

• references/hermes-capabilities.md — What Hermes can do and its API surface
• references/routing-logic.md — Decision tree for routing tasks between OpenClaw and Hermes