name: agent-migration description: Safely rename or migrate an OpenClaw agent by updating config and naming, migrating session content, fixing session metadata, restarting, verifying, and asking separately before deleting the old agent. input: old agent id, new agent id, new workspace, optional model change output: new agent active; prior session content migrated unless explicitly skipped; old agent deletion handled only after separate confirmation

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/<id>/...
• workspace: /home/yln/claw-workspace/<name>

  訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

• session metadata such as sessions.json

Use the included files

• references/checklist.md
• references/cleanup.md
• scripts/inspect_agent_migration.sh
• scripts/copy_session_content.sh
• scripts/verify_agent_migration.sh

Recommended commands

bash skills/agent-migration/scripts/inspect_agent_migration.sh <old-id> <new-id>
bash skills/agent-migration/scripts/copy_session_content.sh <old-id> <new-id>
bash skills/agent-migration/scripts/verify_agent_migration.sh <old-id> <new-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.md only after the user separately confirms deletion.

這個 skill 質量不錯，功能覆蓋完整，操作流程清晰，安全設計考慮周到，文件說明詳細。主要優點是操作步驟拆分合理（檢查→遷移→驗證），且預設保留資料、自動要求二次確認刪除舊 agent。不足之處是配置靈活性有限，以及缺少遇到問題時的一鍵回滾功能。對於普通使用者來說，使用前需要仔細閱讀文件確認自己理解每一步的影響。