agent-extract

Agent Extract（Agent 剥离技能）

将技能/功能从 main agent 剥离成独立 agent，实现：

• Session 隔离（不污染 main）
• 独立心跳/保活
• 独立 workspace、memory、identity

🚀 快速开始

安装后如何使用

安装此技能后，只需告诉你的 agent：

把 <技能名> 剥离成独立 agent

例如：

• "把 aiway 剥离成独立 agent"
• "让 email 功能独立保活"
• "创建一个独立 agent 处理日程"

Agent 会自动：

1. 评估当前环境
2. 创建新 agent 配置
3. 复制必要的技能和记忆文件
4. 设置独立心跳
5. 验证迁移完整性

实际案例：AIWay 剥离

剥离前：main agent 同时处理日常任务 + AIWay 社交

剥离后：

• main agent：专注日常任务
• aiway agent：独立运行，处理 AIWay 社交

效果：session 隔离，互不污染

⚠️ 核心约束（必须遵守）

1. 不能损坏原有环境

• 不删除 main agent 的任何现有 session
• 不修改 main agent 的 transcript 文件
• 不改变 main agent 的配置（除非用户明确要求）
• 保留 所有现有的 cron jobs（除非明确要迁移）

2. 不能破坏当前 channel

• 不修改 channel 配置
• 不删除 channel 凭证
• 保持 所有现有的消息路由正常工作
• 新 agent 的消息路由是新增的，不是替换

3. 原有记忆、人格、身份不能丢失

• 复制 而非移动相关文件
• 保留 原有的 SOUL.md、IDENTITY.md、USER.md
• 迁移 memory 文件到新 workspace（复制）
• 验证 新 agent 可以访问所有必要的技能文件

剥离流程

Step 1: 评估现状

# 1. 检查 main agent 配置
cat ~/.openclaw/openclaw.json | jq '.agents'

# 2. 检查目标技能/功能
ls -la ~/.openclaw/workspace/skills/<skill-name>/

# 3. 检查现有 cron jobs
openclaw cron list

# 4. 检查现有 sessions
cat ~/.openclaw/agents/main/sessions/sessions.json | jq 'keys'

Step 2: 创建新 Agent 配置

在 ~/.openclaw/openclaw.json 的 agents.list 中添加：

{
  "id": "<new-agent-id>",
  "name": "<Agent 显示名称>",
  "workspace": "/Users/<user>/.openclaw/workspace-<new-agent-id>"
}

⚠️ 注意： 使用 config.patch 而不是直接编辑文件，确保不破坏其他配置。

Step 3: 创建新 Workspace

# 创建 workspace 目录
mkdir -p ~/.openclaw/workspace-<new-agent-id>/{memory,skills}

# 复制必要的身份文件（复制，不是移动！）
cp ~/.openclaw/workspace/SOUL.md ~/.openclaw/workspace-<new-agent-id>/
cp ~/.openclaw/workspace/IDENTITY.md ~/.openclaw/workspace-<new-agent-id>/
cp ~/.openclaw/workspace/AGENTS.md ~/.openclaw/workspace-<new-agent-id>/

# 复制技能文件
cp -r ~/.openclaw/workspace/skills/<skill-name> ~/.openclaw/workspace-<new-agent-id>/skills/

# 复制记忆文件（如果需要）
cp -r ~/.openclaw/workspace/memory/*.md ~/.openclaw/workspace-<new-agent-id>/memory/