Migrate from OpenClaw
hermes claw migrate imports your OpenClaw (or legacy Clawdbot/Moldbot) setup into Hermes. This guide covers exactly what gets migrated, the config key mappings, and what to verify after migration.
If your OpenClaw setup was multi-provider, hermes setup --portal collapses it to one OAuth — 300+ models plus the Tool Gateway in a single login. See Nous Portal.
Quick start
# Preview then migrate (always shows a preview first, then asks to confirm)
hermes claw migrate
# Preview only, no changes
hermes claw migrate --dry-run
# Full migration including API keys, skip confirmation
hermes claw migrate --preset full --migrate-secrets --yes
The migration always shows a full preview of what will be imported before making any changes. Review the list, then confirm to proceed.
इससे जुड़ी जानकारी
Reads from ~/.openclaw/ by default. Legacy ~/.clawdbot/ or ~/.moltbot/ directories are detected automatically. Same for legacy config filenames (clawdbot.json, moltbot.json).
Options
| Option | Description |
|---|---|
--dry-run | Preview only — stop after showing what would be migrated. |
--preset <name> | full (all compatible settings) or user-data (excludes infrastructure config). Neither preset imports secrets by default — pass --migrate-secrets explicitly. |
--overwrite | Overwrite existing Hermes files on conflicts (default: refuse to apply when the plan has conflicts). |
--migrate-secrets | Include API keys. Required even under --preset full — no preset imports secrets silently. |
--no-backup | Skip the pre-migration zip snapshot of ~/.hermes/ (by default a single restore-point archive is written before apply, under ~/.hermes/backups/pre-migration-*.zip; restorable with hermes import). |
--source <path> | Custom OpenClaw directory. |
--workspace-target <path> | Where to place AGENTS.md. |
--skill-conflict <mode> | skip (default), overwrite, or rename. |
--yes | Skip the confirmation prompt after preview. |
What gets migrated
Persona, memory, and instructions
| What | OpenClaw source | Hermes destination | Notes |
|---|---|---|---|
| Persona | workspace/SOUL.md | ~/.hermes/SOUL.md | Direct copy |
| Workspace instructions | workspace/AGENTS.md | AGENTS.md in --workspace-target | Requires --workspace-target flag |
| Long-term memory | workspace/MEMORY.md | ~/.hermes/memories/MEMORY.md | Parsed into entries, merged with existing, deduped. Uses § delimiter. |
| User profile | workspace/USER.md | ~/.hermes/memories/USER.md | Same entry-merge logic as memory. |
| Daily memory files | workspace/memory/*.md | ~/.hermes/memories/MEMORY.md | All daily files merged into main memory. |
Workspace files are also checked at workspace.default/ and workspace-main/ as fallback paths (OpenClaw renamed workspace/ to workspace-main/ in recent versions, and uses workspace-{agentId} for multi-agent setups).
Skills (4 sources)
| Source | OpenClaw location | Hermes destination |
|---|---|---|
| Workspace skills | workspace/skills/ | ~/.hermes/skills/openclaw-imports/ |
| Managed/shared skills | ~/.openclaw/skills/ | ~/.hermes/skills/openclaw-imports/ |
| Personal cross-project | ~/.agents/skills/ | ~/.hermes/skills/openclaw-imports/ |
| Project-level shared | workspace/.agents/skills/ | ~/.hermes/skills/openclaw-imports/ |
Skill conflicts are handled by --skill-conflict: skip leaves the existing Hermes skill, overwrite replaces it, rename creates a -imported copy.
Model and provider configuration
| What | OpenClaw config path | Hermes destination | Notes |
|---|---|---|---|
| Default model | agents.defaults.model | config.yaml → model | Can be a string or {primary, fallbacks} object |
| Custom providers | models.providers.* | config.yaml → custom_providers | Maps baseUrl, apiType/api — handles both short ("openai", "anthropic") and hyphenated ("openai-completions", "anthropic-messages", "google-generative-ai") values |
| Provider API keys | models.providers.*.apiKey | ~/.hermes/.env | Requires --migrate-secrets. See API key resolution below. |
Agent behavior
| What | OpenClaw config path | Hermes config path | Mapping |
|---|---|---|---|
| Max turns | <co… Related Posts |
Leave a Reply