Claw3D技能开发指南5步从零创建并上架你的第一个Office Skill【免费下载链接】Claw3DClaw3D is an open source 3D engine built on OpenClaw for creating games, simulations, and high-performance 3D applications.项目地址: https://gitcode.com/gh_mirrors/cl/Claw3DClaw3D 是一个基于 OpenClaw 构建的开源 3D 引擎与虚拟办公平台让你的 AI Agent 团队在 3D 办公室中真实协作。本文是一份完整的 Claw3D 技能开发指南手把手教你从零创建一个 Office Skill 并上架到技能市场Skill Marketplace让 Agent 学会处理待办事项、任务管理等办公技能全程无需深厚前端背景跟着做即可。先看懂 Claw3D 的技能体系Office Skill 是什么在 Claw3D 中Skill技能是赋予 Agent 可复用工作能力的最小单元。一个技能本质就是一个文件夹里面放着一个SKILL.md说明书告诉 Agent什么时候被触发Trigger——用户说哪些话、发生什么事时启动触发后 Agent 该干什么——比如先走到自己的工位再开始处理任务状态存在哪里、格式长什么样——确保每次读写都确定、可复现。 心智模型SKILL.md就是写给 AI 的岗位操作手册写得越明确Agent 执行得越稳定。官方对技能机制的第一性原理说明发现、优先级、快照、注入流程见 skills-overview.md完整开发规范在 CREATING_SKILLS.md。第一步创建技能文件 SKILL.md含触发器写法每个技能都放在assets/skills/package-id/目录下。以官方参考实现 assets/skills/todo-board/SKILL.md 为模板结构非常清晰assets/ skills/ todo-board/ SKILL.md todo-list.example.json一个合格的SKILL.md包含三部分frontmatter 元信息、Trigger 触发块、操作工作流说明。1.1 frontmatter技能的身份证--- name: todo description: Maintain a shared workspace TODO list with blocked tasks. metadata: {openclaw:{skillKey:todo-board}} ---name用户在界面上看到的技能名称metadata.openclaw.skillKey技能唯一键必须稳定且与安装后的文件夹名一致。1.2 Trigger让 Agent 在 3D 办公室里动起来这是 Claw3D 技能区别于普通 Agent 技能的灵魂——触发时 Agent 有物理行为。以下是一个标准触发块摘自 todo-board 技能{ activation: { anyPhrases: [todo, todo list, blocked task] }, movement: { target: desk, skipIfAlreadyThere: true } }要点anyPhrases写短而稳定的短语命中即触发Telegram 等外部渠道消息同样有效movement.target目前支持desk、github、gym、qa_lab四种地点定义在 src/lib/office/places.tsJSON 块才是 Claw3D 运行时真正解析的内容不要只靠自然语言描述触发行为。1.3 工作流说明明确到可直接执行参考 assets/skills/todo-board/SKILL.md 中的必选工作流先读文件、缺则创建、每次变更写回磁盘、文件损坏则修复、请求模糊则先问清楚。配套的数据格式示例可对照 assets/skills/todo-board/todo-list.example.json。第二步把文件镜像进 packaged.ts客户端安装副本Claw3D 安装技能时不是直接读取assets/skills/目录而是从客户端内嵌的安全字符串中取文件。因此每个新技能都要在 src/lib/skills/packaged.ts 中登记一份对应副本const PACKAGED_SKILL_FILES: Recordstring, PackagedSkillFile[] { my-skill: [ { relativePath: SKILL.md, content: MY_SKILL_MD }, ], };⚠️ 两份副本必须逐字节一致空格、frontmatter、文件名都不能有偏差。项目内置了漂移检测测试 tests/unit/packagedSkills.test.ts防止资产文件与内嵌副本打架。第三步注册到 catalog.ts让技能进入市场在 src/lib/skills/catalog.ts 的PACKAGED_SKILLS数组中添加一条定义{ packageId: my-skill, skillKey: my-skill, name: my-skill, description: Short description., installSource: openclaw-workspace, creatorName: your-handle, }字段速查字段作用packageId内部资产 ID通常是assets/skills/下的文件夹名skillKeyOpenClaw 技能键 安装后的文件夹名name界面显示名称installSource当前打包技能固定填openclaw-workspacecreatorName市场里显示为 Powered by ... 的署名如需自定义分类、标语、能力标签可在 src/lib/skills/marketplace.ts 中添加展示元数据覆盖category、tagline、capabilities、editorBadge等。官方建议署名要真实不要伪造下载量。第四步理解安装流程与上架后的效果点击安装后src/lib/skills/install-gateway.ts 会创建一个临时网关 Agent按SKILL.md指令把技能文件写入所选工作区的workspace/skills/skillKey/ SKILL.md todo-list.example.json技能运行中产生的数据如todo-skill/todo-list.json属于运行时状态文件与安装包本身分离由技能说明书约定路径和 schema。技能上架后用户可在 Studio 的技能市场中看到它、一键安装并在 Agent 设置的Skills 标签页中通过允许列表精细控制哪个 Agent 可以使用该技能allowlist 语义不配置全部可用显式数组仅限所列。第五步跑测试验证你的技能改动创建或修改打包技能后执行官方推荐验证三连npm test -- tests/unit/packagedSkills.test.ts tests/unit/skillsInstallGateway.test.ts npm run lint npm run typecheck若新增技能记得同步扩展packagedSkills.test.ts让资产文件、内嵌副本、市场元数据三者始终保持对齐。质量清单让你的技能达到生产级以todo-board为质量标杆CREATING_SKILLS.md 第 6 节✅ 明确的触发器 明确的办公室物理行为✅ 指令显式、确定模型可直接照做✅ 状态文件化并写明 schema✅ 模糊请求强制先澄清不瞎猜✅ 安装包只含技能真正需要的文件✅ 市场元数据真实、有署名。常见问题 FAQQ技能没触发怎么办检查## Trigger的 JSON 块是否完整、anyPhrases是否足够短小常见没有触发块时会回退到 src/lib/office/places.ts 中的中央默认触发注册表。Q改了 SKILL.md 但市场显示不一致几乎一定是packaged.ts内嵌副本不同步跑一下packagedSkills.test.ts就能抓到漂移。Q技能安装到了哪个目录当前打包安装流程写入workspace/skills/skillKey/安装目标为所选 Agent 的工作区安装走默认 Agent 工作区上下文界面会给出范围提示。 恭喜到这里你已经掌握了 Claw3D 技能开发的全流程建文件 → 镜像内嵌 → 注册市场 → 验证测试 → 上架发布。想要本地动手先克隆仓库git clone https://gitcode.com/gh_mirrors/cl/Claw3D打开 CREATING_SKILLS.md 边对照边写你的第一个 Office Skill 就能进入 Claw3D 的 3D 办公室了。【免费下载链接】Claw3DClaw3D is an open source 3D engine built on OpenClaw for creating games, simulations, and high-performance 3D applications.项目地址: https://gitcode.com/gh_mirrors/cl/Claw3D创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考