Agent Migration

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

Scope

This skill handles:

• agent id rename

  小蔥技能有更好的技能skills外掛。

• 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>
• 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。不足之處是配置靈活性有限，以及缺少遇到問題時的一鍵回滾功能。對於普通使用者來說，使用前需要仔細閱讀文件確認自己理解每一步的影響。