一、本机移植

要完整、准确地移植另一套 OpenClaw 的“二级子智能体群组”，我们需要像进行“器官移植”一样，确保 “骨架（配置）、肌肉（技能）、大脑（记忆）” 三个维度的完整迁移。

核心移植方案

先确认“源 OpenClaw”的位置。如果它在同一台机器上，可以编写脚本自动搬运；如果在另一台机器，请按以下步骤打包传输。

1. 移植清单 (The Anatomy of an Agent)

一个完整的智能体群组通常包含以下部分，缺一不可：

• 实体 (Body): agents/[群组名]/ 或 agents/[智能体ID]/ 目录。这是它们的工作区。
• 技能 (Skills): skills/ 下该群组专用的自定义工具（如 skills/coding-bot-v2/）。
• 记忆 (Memory):
  • 长期记忆: agents/[ID]/memory/ 或 memory/subagents/（取决于您的旧架构）。
  • 配置: 源 AGENTS.md 中关于该群组的定义（角色设定、Prompt）。
• 神经 (EvoMap): 如果源系统也有类似 EvoMap 的记录，需要合并 capsules.json。

2. 手动移植步骤 (Standard Protocol)

假设源路径为 OldClaw，目标为 CurrentClaw：

第一步：迁移实体与工作区
将源系统 agents/ 目录下对应的子智能体文件夹复制过来。

# 示例：复制名为 "dev-team" 的群组
Copy-Item -Path "F:\OldClaw\agents\dev-team" -Destination "F:\CurrentClaw\agents\" -Recurse

第二步：迁移专用技能
检查源系统的 skills/，找出该群组依赖的特有技能，复制到新系统。
注意：不要覆盖系统自带的基础技能（如 browser, read），只迁移自定义技能。

第三步：注册身份 (关键)
打开新系统的 AGENTS.md，将旧系统中关于这些子智能体的描述（Role, Mission, Constraints）完整复制过来。

• OpenClaw 需要在 AGENTS.md 或 manifest.json 中看到定义，才会承认它们的存在。

第四步：环境配置
检查旧系统的 .env 或 TOOLS.md，确认这些智能体是否依赖特定的 API Key（如 Github Token, Database URL），并将其补充到新系统。

3. EvoMap 增强：记忆提取与基因固化

既然您已经安装了 EvoMap (Local Evolver)，可以做一个更高级的操作：“提取旧智能体的经验，转化为新系统的本能”。

在迁移完成后，建议运行一次“记忆清洗”：

1. 读取旧智能体的 memory/ 日志。
2. 提取其中的“报错 -> 修复”记录。
3. 批量写入 skills/local-evolver/data/capsules.json。

这样，新系统不仅拥有了这些智能体，还直接继承了它们过去踩坑得来的智慧。

---

二、异源移植

由于目标 OpenClaw 位于另一台电脑，无法直接拷贝。最佳方案是生成一个“胶囊化”的迁移包 (Migration Capsule)。这个包不仅包含文件，还包含恢复脚本，确保在新环境中一键复活。

方案：创建“智能体导出工具” (Agent Exporter)

编写一个 PowerShell 脚本，运行在源电脑上。它会自动打包指定智能体的所有核心资产（配置、记忆、技能、EvoMap基因），并生成一个 .zip 文件。

只需将该 .zip 文件传输到新电脑，解压并运行恢复脚本即可。

步骤 1：在【源电脑】上运行导出脚本

请将以下脚本保存为 export_agent.ps1，然后在 PowerShell 中运行：
.\export_agent.ps1 -AgentName "你的智能体群组名"

(注：如果不确定名字，脚本会列出所有智能体供你选择)

# export_agent.ps1 - 智能体打包工具
param (
    [string]$AgentName
)

$ErrorActionPreference = "Stop"
$BackupRoot = ".\agent_export"
if (Test-Path $BackupRoot) { Remove-Item $BackupRoot -Recurse -Force }
New-Item -ItemType Directory -Path $BackupRoot | Out-Null

# 1. 确认智能体存在
$AgentPath = ".\agents\$AgentName"
if (-not (Test-Path $AgentPath)) {
    Write-Host "❌ 错误: 找不到智能体目录 '$AgentPath'" -ForegroundColor Red
    Write-Host "可用智能体:"
    Get-ChildItem ".\agents" -Directory | ForEach-Object { Write-Host " - $($_.Name)" }
    exit 1
}

Write-Host "📦 正在打包智能体: $AgentName ..." -ForegroundColor Cyan

# 2. 复制主体 (Body)
Write-Host "  - 复制工作区数据..."
Copy-Item -Path $AgentPath -Destination "$BackupRoot\agents\$AgentName" -Recurse -Force

# 3. 提取配置 (Brain)
Write-Host "  - 提取 AGENTS.md 配置..."
# 简单提取：假设配置就在 AGENTS.md 中。如果分散在各处，需人工确认。
if (Test-Path ".\AGENTS.md") {
    Copy-Item ".\AGENTS.md" -Destination "$BackupRoot\AGENTS_reference.md"
}

# 4. 提取技能 (Skills) - 需要智能识别依赖
Write-Host "  - 扫描并复制关联技能..."
# 这里做一个简单的全量备份建议，或者手动指定。
# 自动方案：检查该智能体是否引用了 specific skills
New-Item -ItemType Directory -Path "$BackupRoot\skills" | Out-Null
# (此处简化：提示用户手动放入，或者自动复制所有非默认技能)
# Get-ChildItem ".\skills" | Where-Object { $_.Name -notin @("browser", "read", "write", "exec") } | Copy-Item -Destination "$BackupRoot\skills" -Recurse

# 5. 提取 EvoMap 基因 (Experience)
if (Test-Path ".\skills\local-evolver\data\capsules.json") {
    Write-Host "  - 提取 EvoMap 进化基因..."
    New-Item -ItemType Directory -Path "$BackupRoot\evomap_data" | Out-Null
    Copy-Item ".\skills\local-evolver\data\capsules.json" -Destination "$BackupRoot\evomap_data\capsules.json"
}

# 6. 生成恢复脚本 (Installer)
$InstallScript = @"
Write-Host '🚀 开始恢复智能体: $AgentName ...' -ForegroundColor Cyan
Copy-Item -Path ".\agents\$AgentName" -Destination "..\agents\$AgentName" -Recurse -Force
if (Test-Path ".\evomap_data\capsules.json") {
    Write-Host '  - 合并 EvoMap 基因...'
    # 简单的合并逻辑，避免覆盖现有数据
    # (此处省略复杂合并代码，直接提示手动合并或覆盖)
    Write-Host '⚠️ 请手动合并 evomap_data/capsules.json 到您的 skills/local-evolver/data/' -ForegroundColor Yellow
}
Write-Host '✅ 恢复完成！请检查 AGENTS.md 并手动注册该智能体。' -ForegroundColor Green
"@
Set-Content -Path "$BackupRoot\install.ps1" -Value $InstallScript

# 7. 压缩
$ZipFile = ".\${AgentName}_export.zip"
Compress-Archive -Path "$BackupRoot\*" -DestinationPath $ZipFile -Force

Write-Host "🎉 打包完成: $ZipFile" -ForegroundColor Green
Write-Host "请将此文件发送到新电脑，解压后运行 install.ps1"

步骤 2：传输与恢复

1. 传输： 通过网络（网盘、局域网共享）或 U 盘将 .zip 文件传到新电脑。
2. 解压： 在新电脑的 OpenClaw 根目录下解压。
3. 恢复： 运行 install.ps1。
4. 注册： 打开新电脑的 AGENTS.md，将旧电脑 AGENTS.md 中关于该智能体的描述段落复制进去。

关键注意点：EvoMap 基因合并

如果新旧两台电脑都有 EvoMap 数据（capsules.json），直接覆盖会导致一方经验丢失。
建议： 在新电脑上，打开 capsules.json，手动将旧电脑的 JSON 数组内容追加到新电脑的数组中（去重）。这是目前最安全的“基因融合”方式。