SKILL.md - OpenClaw 迁移指南

目的

当工作区正在将 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 和锁文件保持同步。
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 品牌发布新版本时。