openclaw-migration

Migrate OpenClaw memories, SOUL.md, command allowlists, skills, and workspace assets into Hermes Agent.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/matthew-johnson/hermes-agent --skill openclaw-migration-matthew-johnson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-migration
Source: https://github.com/matthew-johnson/hermes-agent/tree/main/optional-skills/migration/openclaw-migration
Command: npx skills add https://github.com/matthew-johnson/hermes-agent --skill openclaw-migration-matthew-johnson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Migrate a user's OpenClaw customization footprint into Hermes Agent, importing Hermes-compatible memories, SOUL.md, command allowlists, user skills, and selected workspace assets from ~/.openclaw, then reports exactly what could not be migrated and why.

Core Features & Use Cases

  • Import SOUL.md into Hermes home directory as SOUL.md
  • Transform OpenClaw MEMORY.md and USER.md into Hermes memories
  • Merge OpenClaw command approval patterns into Hermes command_allowlist
  • Migrate Hermes-compatible messaging settings and workspace paths
  • Copy OpenClaw skills into ~/.hermes/skills/openclaw-imports/
  • Generate a structured migration report listing migrated, archived, and skipped items

Quick Start

Run the migration to import your OpenClaw footprint into Hermes and review the migration report.

Frequently Asked Questions about openclaw-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my OpenClaw footprint to Hermes?

Migrate your OpenClaw footprint to Hermes by importing memories, SOUL.md, command allowlists, user skills, and workspace assets. The process reads OpenClaw artifacts, transforms them into Hermes-compatible data structures, and generates a structured migration report.

How does OpenClaw to Hermes migration handle SOUL.md and memory files?

OpenClaw to Hermes migration handles SOUL.md by importing it directly into the Hermes home directory, while transforming OpenClaw MEMORY.md and USER.md files into compatible Hermes memories during the process.

Can I merge OpenClaw command approval patterns into Hermes command_allowlist?

Yes, you can merge OpenClaw command approval patterns into the Hermes command_allowlist. The migration process handles conflicts with configured modes and reports exactly what could not be migrated and why.

Where do imported OpenClaw skills go in Hermes?

Imported OpenClaw skills are copied directly into the ~/.hermes/skills/openclaw-imports/ directory. The migration process also archives unmapped docs and produces a structured report listing all migrated items.

What happens to OpenClaw workspace items that cannot be migrated to Hermes?

OpenClaw workspace items that cannot be migrated to Hermes are archived as unmapped docs. The migration process generates a structured report listing exactly what was migrated, archived, and skipped, and explains why.