Agent Migration

Use this skill when the user wants to rename or migrate an OpenClaw agent safely.

Scope

• - agent id rename
• workspace rename
• config/path updates
• prior session content migration
• session display metadata updates
• restart and verification
• separate deletion confirmation for the old agent

Defaults and boundaries

• - Confirm old id, new id, new workspace, and whether model also changes.
• Migrate prior session content by default unless the user explicitly says not to.
• Do not skip migration just because a session does not look active.
• Do not hard-edit active lock files or force-rewrite a live session shell.
• Restart is required after migration.
• Never delete the old agent without a separate user confirmation.

Files involved

• - config: INLINECODE0
• agent dirs: INLINECODE1
• workspace: INLINECODE2
• session metadata such as INLINECODE3

Use the included files

• - INLINECODE4
• INLINECODE5
• INLINECODE6
• INLINECODE7
• INLINECODE8

Recommended commands

Guardrails

• - Keep config, workspace, and naming changes consistent.
• Update session display-layer metadata as part of the migration.
• Verify the new agent before offering deletion of the old one.
• Use references/cleanup.md only after the user separately confirms deletion.