SKILL.md - OpenClaw Migration
Purpose
When the workspace is in the middle of renaming the Clawd project to OpenClaw, this skill lives in the repo so everyone—human or helper—can follow the same migration playbook. It outlines what gets moved, renamed, and tested as we align the codebase, docs, and tooling with the new brand.
When to use
- The human asks for a migration status, plan, or checklist (e.g., “How do we move Clawd to OpenClaw?”).
- You are about to rename directories, update config files, or explain where the old artifacts live.
- A new contributor needs consistent steps so renaming doesn’t break builds or automation.
Migration playbook
- Inventory current layout:
clawdbot/is the existing application root, containingsrc/,apps/,docs/,skills/,package.json, tests, and tooling. The repo root also hosts the agent metadata (AGENTS.md), personality files (SOUL.md,MEMORY.md, etc.), and artifacts likeskills.json. - Create the OpenClaw root: either rename
clawdbot/→openclaw/or copy its contents into a newopenclaw/branch. Preserve hidden files (.github,.agent,.oxconfigs, etc.) and ensurepackage.json,pnpm-workspace.yaml, and lockfile stay in sync. - Update references: search for “Clawd” (case-sensitive) inside docs, READMEs, skill definitions, config files, CI workflows, and rename it to “OpenClaw.”
- Pay special attention to README-header.png, docs/*.md, AGENTS.md, and SOUL.md (the persona description may mention Clawd by name). - Update any CLI/npm run scripts that reference clawdbot paths.
- Move common metadata: decide where
AGENTS.md,SOUL.md,MEMORY.md,skills.json,skills/should live relative to the new app root. Keep human-facing files at the repo root if they drive onboarding (the main persona, heartbeat, identity, etc.). - Verify tooling: rerun
pnpm test,pnpm lint, and anydocsbuilding scripts from withinopenclaw/so the new layout works with existing CI. - Update documentation: mention the migration in
README.md(root and inside the app) so contributors know the repo now houses OpenClaw. Document how to run the app from the new directory. - Clean up artifacts: remove or archive the old
clawdbot/directory once the new structure is stable, or keep a reference README explaining the archive for traceability.
Validation
package.jsonscripts (dev,build,bootstrap) still resolve to the right folders.pnpmworkspace references andtsconfigpaths point toopenclaw/(if renamed).skills.jsonstill lists the correct skill directories and versions.- CI/CD workflows (GitHub Actions, Fly, Render) use the new name in their config.
Communication
- Share this SKILL.md with reviewers during the migration review, so they can confirm each step.
- When sending summaries to Ivan, include a list of moved files and new
openclaw/entrypoints.
Triggers
- Any “migration”, “rename”, or “Clawd → OpenClaw” question from Ivan.
- When prepping a release that should ship under the OpenClaw brand.