Hermes Migration Bridge

Bi-directional migration tool for Hermes Agent ↔ OpenClaw conversions.

Commands

Run via: python3 scripts/hermes-migration-bridge.py [options]

Commands

• analyze — Analyze a Hermes config directory and report what can be migrated
• import — Import Hermes config into OpenClaw format (SOUL.md, AGENTS.md, memory/)
• compare — Feature comparison between Hermes and OpenClaw ecosystems
• map-tools — Map Hermes tools to ClawHub skill equivalents
• export — Export OpenClaw config to Hermes-compatible format
• report — Generate "Why OpenClaw" ecosystem advantage report

Options

• --hermes-dir PATH — Path to Hermes agent config directory
• --workspace PATH — OpenClaw workspace path (default: auto-detect)
• --format text|json|markdown — Output format (default: text)
• --output PATH — Save output to file
• --dry-run — Show what would be migrated without writing files
• --merge — Merge with existing OpenClaw config instead of overwriting

Migration Flow

1. Run analyze to scan the Hermes directory

2. Run map-tools to see which Hermes tools have ClawHub equivalents

3. Run import --dry-run to preview the migration

4. Run import to execute the migration

5. Run compare to show feature advantages

Hermes Config Format

See references/hermes-format.md for details on Hermes configuration structure and mapping rules.