Openclaw To Hermes

openclaw-to-hermes

Migrate from [OpenClaw](https://github.com/openclaw/openclaw) to [Hermes Agent](https://github.com/NousResearch/hermes-agent) — a complete, battle-tested migration tool.

Built from a real production migration. Fixes every issue we found in the existing `hermes-migrate` tool.

**Note:** As of Hermes Agent v0.3.0+, the native `hermes claw migrate` command now covers the full migration path — including the bugs this tool was originally built to fix. **For new migrations, use the native command first:**

hermes claw migrate              # Interactive migration
hermes claw migrate --preset full --overwrite  # Full migration

This tool remains useful as a reference implementation and for users on older Hermes versions (pre-v0.3.0) where the native migration had known issues.

What It Does

• Discovers all OpenClaw agents, workspaces, channels, and credentials
• Migrates SOUL.md, MEMORY.md, workspace files, skills, and memory archives
• Maps OpenClaw config → Hermes config.yaml (models, channels, tools, advanced settings)
• Handles dict-type model configs (primary/fallbacks) correctly
• Migrates credentials from both ~/.openclaw/ and /etc/openclaw-tenants/
• Writes auth.json in the correct Hermes nested format
• Sets up systemd gateway service with lingering
• Creates backup archive before any destructive operations
• Supports dry-run mode for safe preview

Quick Start

# Install
pip install openclaw-to-hermes
# or
pipx install openclaw-to-hermes

# Preview what will happen
oc2hermes --dry-run

# Run full migration
oc2hermes

# Migrate a specific agent
oc2hermes --agent quant

# Skip auto-start of hermes gateway
oc2hermes --no-start

What Gets Migrated

OpenClaw	Hermes	Notes
~/.openclaw/openclaw.json	~/.hermes/config.yaml	Model, channel, tool config
~/clawd/SOUL.md (workspace)	~/.hermes/SOUL.md	Agent persona
~/clawd/MEMORY.md