clawsouls/clawsouls-claude-code-plugin/migrate-openclaw
Claude Code and agent skill by clawsouls/clawsouls-claude-code-plugin
- community
Checking that the SKILL.md file is still in the repository.
Migrate an OpenClaw/SoulClaw workspace to Claude Code. Triggers on: migrate openclaw, openclaw to claude code, convert openclaw, import openclaw, switch from openclaw.
Install
npx vskill@latest install clawsouls/clawsouls-claude-code-plugin/migrate-openclawSKILL.md
The same SKILL.md was published earlier as clawsouls/clawsouls-claude-code-plugin/migrate-openclaw.
Migrate OpenClaw to Claude Code
Converts an OpenClaw workspace into a Claude Code project while preserving Soul Spec compatibility. Unlike a destructive migration, this keeps files portable — they work in both OpenClaw and Claude Code.
When to activate
- User says "migrate openclaw", "switch from openclaw", "convert openclaw"
- User provides an OpenClaw workspace path and wants to use Claude Code
- User asks about moving from OpenClaw/SoulClaw to Claude Code
Phase 1: Detect Source
Search for OpenClaw workspace in this order. Stop at first match:
- Current directory — look for
SOUL.md+AGENTS.md,openclaw.json, or.openclaw/ - Default location — check
~/.openclaw/workspace/ - GitHub URL — if user provides a repo URL, clone to temp dir first
- Ask — if nothing found, prompt user for path
Confirmation markers:
SOUL.mdalongsideAGENTS.mdorUSER.mdopenclaw.json.openclaw/directory
Phase 2: Scan & Categorize
Read every file in the source. Categorize into three buckets:
MIGRATE — Becomes part of Claude Code project
| Source File | Destination | Method | |
|---|---|---|---|
SOUL.md | ./SOUL.md | Copy as-is (project root, NOT renamed) | |
IDENTITY.md | ./IDENTITY.md | Copy as-is | |
USER.md | ./USER.md | Copy as-is | |
AGENTS.md | ./AGENTS.md | Copy, then clean (see Cleaning Rules) | |
MEMORY.md | ./MEMORY.md | Copy as-is | |
memory/*.md | ./memory/ | Copy all files | |
STYLE.md | ./STYLE.md | Copy if exists | |
TOOLS.md | ./TOOLS.md | Copy if exists, strip OpenClaw-specific tool configs | |
Custom skills (skills/*/SKILL.md) | .claude/skills/*/SKILL.md | Convert (see Skill Conversion) |
ARCHIVE — Moved to _openclaw_archive/ (nothing lost)
openclaw.json(gateway config)credentials/(channel tokens)agents/*/sessions/(old transcripts)devices/(mobile node pairings)logs/(gateway logs).openclaw/(internal state)cron/(scheduled jobs)BOOTSTRAP.md(first-run ritual)HEARTBEAT.md(periodic task config)- Channel config files (
*-allowFrom.json)
SKIP — Not touched
.git/node_modules/- Files unrelated to OpenClaw
Phase 3: AGENTS.md Cleaning Rules
Strip OpenClaw-specific directives. Keep universal rules.
Remove:
- Heartbeat instructions (check pending work, HEARTBEAT_OK)
- Gateway commands (openclaw gateway start/stop/restart)
- Channel routing rules (Telegram/Discord/Signal-specific routing)
- OpenClaw tool references (sessions_spawn, nodes, canvas)
- SoulClaw config references (openclaw.json settings)
Keep:
- Work style rules (commit frequently, test before reporting)
- Safety rules (no destructive commands, trash > rm)
- Communication preferences (language, tone, brevity)
- Memory management rules (topic files, daily logs, compaction)
- Git conventions (commit messages, branch strategy)
Phase 4: Skill Conversion
OpenClaw skills → Claude Code skills (same markdown, minor cleanup):
- Keep
nameanddescriptionfrom YAML frontmatter - Remove
metadata.openclawblock (requires.bins, requires.env) - If skill had
requires.bins, add note: "Requires: [tool names]" - If skill had
requires.env, add note: "Environment variables: [var names]" - Keep all other content as-is
- Write to
.claude/skills/<skill-name>/SKILL.md
Phase 5: CLAUDE.md Generation
Generate a lean CLAUDE.md that references files (NOT inlines them):
Important: If CLAUDE.md already exists, append a ## Migrated from OpenClaw section instead of overwriting.
Phase 6: Preview & Confirm
Before executing, display a summary:
Wait for explicit confirmation before executing.
Phase 7: Execute & Report
After confirmation:
- Create destination directories
- Copy/convert files per the plan
- Archive infrastructure files
- Generate CLAUDE.md
- Display final report:
Key Differences from Other Migration Tools
- Files stay in project root — SOUL.md stays SOUL.md, not
KNOWLEDGE BASE/soul.md - Soul Spec portable — migrated files work in OpenClaw, Cursor, Windsurf, anywhere
- Memory rules included — CLAUDE.md gets memory management rules so the agent persists knowledge
- Non-destructive — originals archived, nothing deleted
- MCP integration — recommends soul-spec-mcp for ongoing memory search + SoulScan
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/migrate-openclaw/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/clawsouls/clawsouls-claude-code-plugin/migrate-openclaw)