openclaw-assets-to-workbuddy

The saved excerpt is a snapshot from when this skill was listed. The external source remains the complete and most current version.

---
name: openclaw-assets-to-workbuddy
description: 将 OpenClaw 用户的个人资产迁移到 WorkBuddy 对应位置，重点覆盖 SOUL.md、IDENTITY.md、USER.md、memory、skills、MCP 配置、bot/channel 连接配置，以及 OpenClaw 的 cron job 定义。适用于把 ~/.openclaw 或 OpenClaw workspace 迁入 ~/.workbuddy、WorkBuddy IDE 配置和目标 WorkBuddy 工作区的场景。
version: 1.0.0
---

# OpenClaw 资产迁移到 WorkBuddy

当用户希望把个人 OpenClaw 资产迁移到 WorkBuddy 时，使用这个 skill。

默认假设：
- OpenClaw home：`~/.openclaw`
- OpenClaw workspace：`~/.openclaw/workspace`
- WorkBuddy home：`~/.workbuddy`
- WorkBuddy 项目工作区：用户指定的目标 repo 或 workspace

如果用户明确给了路径，优先使用用户提供的路径。

## 目标

只迁移那些在 WorkBuddy 中有明确落点的“用户资产”。

优先迁移：
- 身份文件
- memory
- skills
- MCP 配置
- bot/channel 连接配置
- cron job 定义

不要盲目复制运行态缓存、凭据目录、插件二进制目录等不透明状态。

默认迁移策略：
- 以“融合”为默认策略，不以“覆盖”为默认策略
- 尤其是 `SOUL.md`、`IDENTITY.md`、`USER.md`，必须优先保留 WorkBuddy 现有人设、语气、边界、偏好，再吸收 OpenClaw 中缺失但有价值的信息
- 只有在用户明确要求“以 OpenClaw 为准”时，才允许接近覆盖式迁移
- OpenClaw `credentials/*` 如果要迁移到 WorkBuddy，默认走“结构化转换”，不是整目录复制

## 已确认的 WorkBuddy 目标位置

使用以下落点：

- 用户级身份文件：
  - `~/.workbuddy/SOUL.md`
  - `~/.workbuddy/IDENTITY.md`
  - `~/.workbuddy/USER.md`
- 用户级 MCP 配置：
  - `~/.workbuddy/mcp.json`
- 用户级 skills：
  - `~/.workbuddy/skills/<skill>/SKILL.md`
- 项目级 skills：
  - `{workspace}/.workbuddy/skills/<skill>/SKILL.md`
- 项目级 memory：
  - `{workspace}/.workbuddy/memory/MEMORY.md`
  - `{workspace}/.workbuddy/memory/YYYY-MM-DD.md`
- automations：
  - `~/.workbuddy/automations/<automation_id>/automation.toml`
- IDE 用户配置文件：
  - `<userDataPath>/User/settings.json`
  - macOS 默认通常是 `~/Library/Application Support/CodeBuddy/User/settings.json`
- IDE bot/channel 配置主键：
  - `claw.channels`
- IDE bot/channel 旧版兼容键：
  - `wecom.channels`
- IDE 特殊 channel 开关：
  - `wecom.wechatMpEnabled`
  - `wecom.wechatmp.artifactUploadEnabled`
- IDE 产品登录配置定义：
  - `genie/apps/extension/vscode/product.json`
- IDE 产品登录 session：
  - VS Code `SecretStorage`
  - 当前默认 key 源自 `product.json` 里的 `authentication.attributes.storageKey`
  - 这套是 WorkBuddy 产品账号登录态，不是 bot/channel 绑定配置
- channel 运行时缓存（不是长期配置落点）：
  - QQ 会话缓存：系统临时目录里的 `qq-bot-session-<account>.json`
  - 微信 ClawBot 同步缓存：系统临时目录里的 `weixin-sync-<account>.json`
  - 微信 ClawBot context 缓存：系统临时目录里的 `weixin-context-<account>.json`

相关但非主要目标：
- WorkBuddy 的 home 根目录实质上是 `~/.workbuddy`
- 用户模型配置可能在 `~/.workbuddy/models.json`
- WorkBuddy 可能会自己维护 `~/.workbuddy/workspace-state.json`，除非用户明确要求，否则不要覆盖

## 源到目标的映射

### 1. 身份文件

迁移：
- `~/.openclaw/workspace/SOUL.md` -> `~/.workbuddy/SOUL.md`
- `~/.openclaw/workspace/IDENTITY.md` -> `~/.workbuddy/IDENTITY.md`
- `~/.openclaw/workspace/USER.md` -> `~/.workbuddy/USER.md`

规则：
- 如果目标文件已存在，优先做 merge，不要粗暴覆盖
- 如果 WorkBuddy 侧内容更丰富，保留现有内容，只补充 OpenClaw 中缺失的信息
- `SOUL.md` 的融合优先级最高：先保留 WorkBuddy 已建立的人设、语气、价值观、边界，再补充 OpenClaw 中不冲突的设定
- 如果 OpenClaw 与 WorkBuddy 的人设设定冲突，不要自动覆盖，保留 WorkBuddy 版本，并把冲突点列入迁移报告
- `IDENTITY.md` 和 `USER.md` 也应采用“补充缺失信息、合并稳定事实、避免重复”的方式处理
- 不要复制 `BOOTSTRAP.md`
- 不要复制 OpenClaw workspace state 文件

### 2. Memory

迁移：
- `~/.openclaw/workspace/MEMORY.md` 或 `memory.md` -> `{workspace}/.workbuddy/memory/MEMORY.md`
- `~/.openclaw/workspace/memory/*.md` -> `{workspace}/.workbuddy/memory/`

规则：
- 日期型 memory 文件如果已经是 `YYYY-MM-DD.md`，原样保留文件名
- 如果 OpenClaw 的 `MEMORY.md` 很大，合并到 WorkBuddy `MEMORY.md`，不要整文件直接覆盖
- 两边内容重复时要去重

### 3. Skills

迁移：
- `~/.openclaw/skills/<skill>/` -> `~/.workbuddy/skills/<skill>/`
- `~/.openclaw/workspace/skills/<skill>/` -> `{workspace}/.workbuddy/skills/<skill>/`

规则：
- 如果 skill 目录里除了 `SKILL.md` 还有 `scripts/`、`references/`、`assets/`，复制整个 skill 目录
- 如果目标 skill 已存在，先 diff，再决定 merge、保留，或改名导入

### 4. MCP

主要来源：
- `~/.openclaw/openclaw.json` 中的 `mcp.servers`

可选来源：
- `~/.openclaw/extensions/*/.mcp.json`

目标：
- `~/.workbuddy/mcp.json`，顶层字段使用 `mcpServers`

规则：
- 把 OpenClaw 的 `mcp.servers` 转成 WorkBuddy 的 `mcpServers`
- 写入时合并到已有 `~/.workbuddy/mcp.json`，不要覆盖其他 server
- 如果从 OpenClaw 插件的 `.mcp.json` 中提取，只迁移 MCP server 定义，不迁移整个插件目录
- 如果某些 server 依赖环境变量或密钥，只保留这些 server 真正用到的键

目标格式示例：

```json
{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mc