AgentTeams Migration Skill 是一个指导技能,帮助用户将独立的 OpenClaw 实例迁移到 AgentTeams 平台,作为一个受管理的 Worker 运行。迁移过程需要理解 AgentTeams 的 Worker 架构,并生成符合其规范的迁移包(ZIP)。
用途: 本技能用于自动化或半自动化地完成从 OpenClaw 到 AgentTeams Worker 的迁移准备。它通过分析现有 OpenClaw 配置、适配关键文件、打包依赖和自定义内容,最终生成一个可直接导入 AgentTeams 的 ZIP 包。
主要能力:
- 分析工具依赖:运行 analyze.sh 脚本检测当前 OpenClaw 环境依赖的系统包(apt)、Python 包(pip)和 Node.js 包(npm),输出工具分析 JSON,供用户审查调整。
- 适配 AGENTS.md:指导用户保留角色定义、自定义工作流等个性化内容,移除与 AgentTeams 内建规则重复的部分(如会话管理、记忆、通信协议、任务执行等),并添加自定义工具说明。
- 适配 SOUL.md:要求加入 AI 身份说明(强调 AI 无需休息、以分钟/小时为时间单位),并保留安全规则。
- 适配定时任务:将原有 cron 任务中的调度信息和任务内容提取,去除投递配置,由 AgentTeams Manager 统一协调。
- 生成迁移 ZIP:通过 generate-zip.sh 脚本打包适配后的配置文件、Dockerfile(含额外安装包)和 manifest.json。
- 提供导入说明:指导用户在 AgentTeams 主机上下载导入脚本(import.sh 或 import.ps1)并执行导入命令。
使用方式:
- 第一步:运行分析脚本 bash <SKILL_DIR>/scripts/analyze.sh --state-dir ~/.openclaw --output /tmp/agentteams-migration
- 第二步:手动编辑 AGENTS.md,保留自定义内容,移除与内建规则冲突的部分。
- 第三步:编辑 SOUL.md,加入 AI 身份和安全规则。
- 第四步:处理 cron 任务(如有),保留调度和任务内容,去除投递配置。
- 第五步:运行打包脚本 bash <SKILL_DIR>/scripts/generate-zip.sh --name <worker-name> --state-dir ~/.openclaw --output /tmp/agentteams-migration
- 第六步:检查 ZIP 内容,然后告知用户 ZIP 路径;用户在 AgentTeams 主机上运行 curl -sSL https://higress.ai/agentteams/import.sh -o agentteams-import.sh 下载导入脚本,再执行 ./agentteams-import.sh worker --name <worker-name> --zip <path-to-zip> 完成导入(Windows 使用 PowerShell 脚本 import.ps1)。
适用场景:
- 用户希望将现有的 OpenClaw 实例迁移到 AgentTeams 平台,作为受管理的 Worker 运行。
- 需要保留自定义技能、角色定义和工作流,但适配 AgentTeams 的通信(Matrix)、配置存储(MinIO)和任务协调机制。
- 需要生成标准化的迁移包,以便通过导入脚本快速部署。
限制:
- openclaw.json 不会迁移,由导入脚本根据 AgentTeams 模板完全重新生成(通道配置、认证、模型提供者等均丢弃)。
- 认证配置/API 密钥不会迁移,AgentTeams 使用自己的 AI Gateway 和每 Worker 凭据。
- 设备身份、会话历史不会迁移(AgentTeams 中会话每日重置)。
- 扩展/插件不会迁移,仅迁移自定义技能。
- Discord/Slack 通道配置不会迁移,统一使用 Matrix。
- 迁移包中的 Dockerfile 可编辑,但基础镜像已预装常用工具(bash, git, python3, nodejs, npm, pnpm, mc, openclaw, mcporter, skills 等),无需重复安装。
- AGENTS.md 的适配需要人工判断,不能完全自动化。
- 定时任务不会作为 OpenClaw cron 运行,而是由 Manager 协调。