← Back to Skills Marketplace
137
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install agent-migration
Description
Safely rename or migrate an OpenClaw agent by updating config and naming, migrating session content, fixing session metadata, restarting, verifying, and aski...
README (SKILL.md)
Agent Migration
Use this skill when the user wants to rename or migrate an OpenClaw agent safely.
Scope
This skill handles:
- 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:
~/.openclaw/openclaw.json - agent dirs:
~/.openclaw/agents/\x3Cid>/... - workspace:
/home/yln/claw-workspace/\x3Cname> - session metadata such as
sessions.json
Use the included files
references/checklist.mdreferences/cleanup.mdscripts/inspect_agent_migration.shscripts/copy_session_content.shscripts/verify_agent_migration.sh
Recommended commands
bash skills/agent-migration/scripts/inspect_agent_migration.sh \x3Cold-id> \x3Cnew-id>
bash skills/agent-migration/scripts/copy_session_content.sh \x3Cold-id> \x3Cnew-id>
bash skills/agent-migration/scripts/verify_agent_migration.sh \x3Cold-id> \x3Cnew-id>
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.mdonly after the user separately confirms deletion.
Usage Guidance
This package is coherent with its stated purpose but performs high‑impact local file operations. Before using: (1) review the three included scripts to ensure they match your expectations; (2) back up ~/.openclaw and any workspace directories; (3) run inspect/summary modes first (copy script supports a summary mode) to preview changes; (4) ensure you run commands as the correct user (avoid root unless you understand why); (5) confirm the presence of the openclaw CLI if you plan to use verify (openclaw doctor); (6) never delete the old agent until you have manually verified the new agent and have explicit backup/consent. If you want additional assurance, provide a sandboxed test agent and perform a dry run there first.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: scripts and docs operate on ~/.openclaw, agent directories, sessions.json and workspace paths to copy and verify session data and update config. The declared high local-permission requirement in README/metadata is appropriate for the actions performed.
Instruction Scope
SKILL.md confines actions to migration tasks and references the included scripts for inspect/copy/verify. It reads/writes OpenClaw config, agent dirs, workspace and session metadata — which is expected. One minor note: verify script calls an external command (openclaw doctor) that is not declared in required binaries; the runtime will need that binary available. Guardrails (no hard-edit of locks, require confirmation before deletion) are present.
Install Mechanism
No install spec; this is instruction-only with included shell scripts. No downloads or external installers are used, so nothing arbitrary is fetched or executed from remote URLs.
Credentials
The skill requests no environment variables or credentials. It does require elevated local file permissions to modify ~/.openclaw and workspace paths, which is proportional to migration behavior and is documented in README/metadata.
Persistence & Privilege
always is false and the skill does not request persistent or system-wide privileges beyond modifying its own agent-related files. It does not modify other skills' configs or assert permanent presence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-migration - After installation, invoke the skill by name or use
/agent-migration - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Compressed instructions and validated migration flow with a real rename test.
v1.0.0
Initial release: rename/migrate agents, migrate session content, update session display metadata, restart/verify, and require extra confirmation before deleting old agents.
Metadata
Frequently Asked Questions
What is Agent Migration?
Safely rename or migrate an OpenClaw agent by updating config and naming, migrating session content, fixing session metadata, restarting, verifying, and aski... It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.
How do I install Agent Migration?
Run "/install agent-migration" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Migration free?
Yes, Agent Migration is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agent Migration support?
Agent Migration is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Migration?
It is built and maintained by kid0114 (@kid0114); the current version is v1.0.1.
More Skills