← 返回 Skills 市场
137
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install agent-migration
功能描述
Safely rename or migrate an OpenClaw agent by updating config and naming, migrating session content, fixing session metadata, restarting, verifying, and aski...
使用说明 (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.
安全使用建议
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install agent-migration - 安装完成后，直接呼叫该 Skill 的名称或使用
/agent-migration触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
Agent Migration 是什么？
Safely rename or migrate an OpenClaw agent by updating config and naming, migrating session content, fixing session metadata, restarting, verifying, and aski... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 137 次。
如何安装 Agent Migration？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install agent-migration」即可一键安装，无需额外配置。
Agent Migration 是免费的吗？
是的，Agent Migration 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Agent Migration 支持哪些平台？
Agent Migration 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Agent Migration？
由 kid0114（@kid0114）开发并维护，当前版本 v1.0.1。
推荐 Skills