ClawSkills logoClawSkills

openclaw-migration

通过详述文件移动、更新、测试和文档步骤,指导将 Clawd 项目重命名为 OpenClaw,以实现一致的迁移。

介绍

# SKILL.md - OpenClaw Migration

## 目的 当工作区正在进行将 Clawd 项目重命名为 OpenClaw 的过程中,此技能驻留在仓库中,以便所有人——无论是人类还是助手——都能遵循相同的迁移手册。它概述了在将代码库、文档和工具与新品牌保持一致时,需要移动、重命名和测试的内容。

## 使用场景 - 人类询问迁移状态、计划或检查清单(例如,“我们要如何将 Clawd 迁移至 OpenClaw?”)。 - 您即将重命名目录、更新配置文件,或解释旧构建产物的存放位置。 - 新贡献者需要一致的步骤,以确保重命名不会破坏构建或自动化流程。

## 迁移手册 1. **盘点当前布局**:`clawdbot/` 是现有的应用程序根目录,包含 `src/`、`apps/`、`docs/`、`skills/`、`package.json`、测试和工具。仓库根目录还托管着代理元数据(`AGENTS.md`)、人格文件(`SOUL.md`、`MEMORY.md` 等)以及 `skills.json` 等产物。 2. **创建 OpenClaw 根目录**:将 `clawdbot/` 重命名为 `openclaw/`,或者将其内容复制到新的 `openclaw/` 分支中。保留隐藏文件(`.github`、`.agent`、`.ox` 配置等),并确保 `package.json`、`pnpm-workspace.yaml` 和 lockfile 保持同步。 3. **更新引用**:在文档、README、技能定义、配置文件、CI 工作流中搜索“Clawd”(区分大小写),并将其重命名为“OpenClaw”。 - 特别注意 `README-header.png`、`docs/*.md`、`AGENTS.md` 和 `SOUL.md`(人格描述中可能会直接提到 Clawd)。 - 更新任何引用 `clawdbot` 路径的 CLI/`npm run` 脚本。 4. **迁移通用元数据**:确定 `AGENTS.md`、`SOUL.md`、`MEMORY.md`、`skills.json`、`skills/` 应相对于新的应用根目录存放在何处。如果人类可见的文件用于引导新成员(主要人格、心跳、身份等),请将其保留在仓库根目录。 5. **验证工具**:在 `openclaw/` 目录内重新运行 `pnpm test`、`pnpm lint` 和任何 `docs` 构建脚本,以确保新布局适用于现有的 CI。 6. **更新文档**:在 `README.md`(根目录和应用内)中提及此次迁移,以便贡献者知道该仓库现在托管的是 OpenClaw。记录如何从新目录运行应用程序。 7. **清理产物**:一旦新结构稳定,删除或归档旧的 `clawdbot/` 目录,或者保留一个参考 README 来解释归档内容以确保可追溯性。

## 验证 - `package.json` 脚本(`dev`、`build`、`bootstrap`)仍能解析到正确的文件夹。 - `pnpm` 工作区引用和 `tsconfig` 路径指向 `openclaw/`(如果已重命名)。 - `skills.json` 仍然列出了正确的技能目录和版本。 - CI/CD 工作流(GitHub Actions、Fly、Render)在其配置中使用了新名称。

## 沟通 - 在迁移审查期间与审查者分享此 SKILL.md,以便他们确认每个步骤。 - 向 Ivan 发送摘要时,请包含已移动文件列表和新的 `openclaw/` 入口点。

## 触发条件 - 来自 Ivan 的任何关于“迁移”、“重命名”或“Clawd → OpenClaw”的问题。 - 准备发布应以 OpenClaw 品牌命名的版本时。

更多产品