指南：5步從零創(chuàng)建并上架你的第一個Office Skill)
Claw3D技能開發(fā)指南5步從零創(chuàng)建并上架你的第一個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 構(gòu)建的開源 3D 引擎與虛擬辦公平臺讓你的 AI Agent 團隊在 3D 辦公室中真實協(xié)作。本文是一份完整的 Claw3D 技能開發(fā)指南手把手教你從零創(chuàng)建一個 Office Skill 并上架到技能市場Skill Marketplace讓 Agent 學(xué)會處理待辦事項、任務(wù)管理等辦公技能全程無需深厚前端背景跟著做即可。先看懂 Claw3D 的技能體系Office Skill 是什么在 Claw3D 中Skill技能是賦予 Agent 可復(fù)用工作能力的最小單元。一個技能本質(zhì)就是一個文件夾里面放著一個SKILL.md說明書告訴 Agent什么時候被觸發(fā)Trigger——用戶說哪些話、發(fā)生什么事時啟動觸發(fā)后 Agent 該干什么——比如先走到自己的工位再開始處理任務(wù)狀態(tài)存在哪里、格式長什么樣——確保每次讀寫都確定、可復(fù)現(xiàn)。 心智模型SKILL.md就是寫給 AI 的崗位操作手冊寫得越明確Agent 執(zhí)行得越穩(wěn)定。官方對技能機制的第一性原理說明發(fā)現(xiàn)、優(yōu)先級、快照、注入流程見 skills-overview.md完整開發(fā)規(guī)范在 CREATING_SKILLS.md。第一步創(chuàng)建技能文件 SKILL.md含觸發(fā)器寫法每個技能都放在assets/skills/package-id/目錄下。以官方參考實現(xiàn) assets/skills/todo-board/SKILL.md 為模板結(jié)構(gòu)非常清晰assets/ skills/ todo-board/ SKILL.md todo-list.example.json一個合格的SKILL.md包含三部分frontmatter 元信息、Trigger 觸發(fā)塊、操作工作流說明。1.1 frontmatter技能的身份證--- name: todo description: Maintain a shared workspace TODO list with blocked tasks. metadata: {openclaw:{skillKey:todo-board}} ---name用戶在界面上看到的技能名稱metadata.openclaw.skillKey技能唯一鍵必須穩(wěn)定且與安裝后的文件夾名一致。1.2 Trigger讓 Agent 在 3D 辦公室里動起來這是 Claw3D 技能區(qū)別于普通 Agent 技能的靈魂——觸發(fā)時 Agent 有物理行為。以下是一個標(biāo)準(zhǔn)觸發(fā)塊摘自 todo-board 技能{ activation: { anyPhrases: [todo, todo list, blocked task] }, movement: { target: desk, skipIfAlreadyThere: true } }要點anyPhrases寫短而穩(wěn)定的短語命中即觸發(fā)Telegram 等外部渠道消息同樣有效movement.target目前支持desk、github、gym、qa_lab四種地點定義在 src/lib/office/places.tsJSON 塊才是 Claw3D 運行時真正解析的內(nèi)容不要只靠自然語言描述觸發(fā)行為。1.3 工作流說明明確到可直接執(zhí)行參考 assets/skills/todo-board/SKILL.md 中的必選工作流先讀文件、缺則創(chuàng)建、每次變更寫回磁盤、文件損壞則修復(fù)、請求模糊則先問清楚。配套的數(shù)據(jù)格式示例可對照 assets/skills/todo-board/todo-list.example.json。第二步把文件鏡像進(jìn) packaged.ts客戶端安裝副本Claw3D 安裝技能時不是直接讀取assets/skills/目錄而是從客戶端內(nèi)嵌的安全字符串中取文件。因此每個新技能都要在 src/lib/skills/packaged.ts 中登記一份對應(yīng)副本const PACKAGED_SKILL_FILES: Recordstring, PackagedSkillFile[] { my-skill: [ { relativePath: SKILL.md, content: MY_SKILL_MD }, ], };?? 兩份副本必須逐字節(jié)一致空格、frontmatter、文件名都不能有偏差。項目內(nèi)置了漂移檢測測試 tests/unit/packagedSkills.test.ts防止資產(chǎn)文件與內(nèi)嵌副本打架。第三步注冊到 catalog.ts讓技能進(jìn)入市場在 src/lib/skills/catalog.ts 的PACKAGED_SKILLS數(shù)組中添加一條定義{ packageId: my-skill, skillKey: my-skill, name: my-skill, description: Short description., installSource: openclaw-workspace, creatorName: your-handle, }字段速查字段作用packageId內(nèi)部資產(chǎn) ID通常是assets/skills/下的文件夾名skillKeyOpenClaw 技能鍵 安裝后的文件夾名name界面顯示名稱installSource當(dāng)前打包技能固定填openclaw-workspacecreatorName市場里顯示為 Powered by ... 的署名如需自定義分類、標(biāo)語、能力標(biāo)簽可在 src/lib/skills/marketplace.ts 中添加展示元數(shù)據(jù)覆蓋category、tagline、capabilities、editorBadge等。官方建議署名要真實不要偽造下載量。第四步理解安裝流程與上架后的效果點擊安裝后src/lib/skills/install-gateway.ts 會創(chuàng)建一個臨時網(wǎng)關(guān) Agent按SKILL.md指令把技能文件寫入所選工作區(qū)的workspace/skills/skillKey/ SKILL.md todo-list.example.json技能運行中產(chǎn)生的數(shù)據(jù)如todo-skill/todo-list.json屬于運行時狀態(tài)文件與安裝包本身分離由技能說明書約定路徑和 schema。技能上架后用戶可在 Studio 的技能市場中看到它、一鍵安裝并在 Agent 設(shè)置的Skills 標(biāo)簽頁中通過允許列表精細(xì)控制哪個 Agent 可以使用該技能allowlist 語義不配置全部可用顯式數(shù)組僅限所列。第五步跑測試驗證你的技能改動創(chuàng)建或修改打包技能后執(zhí)行官方推薦驗證三連npm test -- tests/unit/packagedSkills.test.ts tests/unit/skillsInstallGateway.test.ts npm run lint npm run typecheck若新增技能記得同步擴展packagedSkills.test.ts讓資產(chǎn)文件、內(nèi)嵌副本、市場元數(shù)據(jù)三者始終保持對齊。質(zhì)量清單讓你的技能達(dá)到生產(chǎn)級以todo-board為質(zhì)量標(biāo)桿CREATING_SKILLS.md 第 6 節(jié)? 明確的觸發(fā)器 明確的辦公室物理行為? 指令顯式、確定模型可直接照做? 狀態(tài)文件化并寫明 schema? 模糊請求強制先澄清不瞎猜? 安裝包只含技能真正需要的文件? 市場元數(shù)據(jù)真實、有署名。常見問題 FAQQ技能沒觸發(fā)怎么辦檢查## Trigger的 JSON 塊是否完整、anyPhrases是否足夠短小常見沒有觸發(fā)塊時會回退到 src/lib/office/places.ts 中的中央默認(rèn)觸發(fā)注冊表。Q改了 SKILL.md 但市場顯示不一致幾乎一定是packaged.ts內(nèi)嵌副本不同步跑一下packagedSkills.test.ts就能抓到漂移。Q技能安裝到了哪個目錄當(dāng)前打包安裝流程寫入workspace/skills/skillKey/安裝目標(biāo)為所選 Agent 的工作區(qū)安裝走默認(rèn) Agent 工作區(qū)上下文界面會給出范圍提示。 恭喜到這里你已經(jīng)掌握了 Claw3D 技能開發(fā)的全流程建文件 → 鏡像內(nèi)嵌 → 注冊市場 → 驗證測試 → 上架發(fā)布。想要本地動手先克隆倉庫git clone https://gitcode.com/gh_mirrors/cl/Claw3D打開 CREATING_SKILLS.md 邊對照邊寫你的第一個 Office Skill 就能進(jìn)入 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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Claw3D技能開發(fā)指南：5步從零創(chuàng)建并上架你的第一個Office Skill
Claw3D技能開發(fā)指南5步從零創(chuàng)建并上架你的第一個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 構(gòu)建的開源 3D 引擎與虛擬辦公平臺讓你的 AI Agent 團隊在 3D 辦公室中真實協(xié)作。本文是一份完整的 Claw3D 技能開發(fā)指南手把手教你從零創(chuàng)建一個 Office Skill 并上架到技能市場Skill Marketplace讓 Agent 學(xué)會處理待辦事項、任務(wù)管理等辦公技能全程無需深厚前端背景跟著做即可。先看懂 Claw3D 的技能體系Office Skill 是什么在 Claw3D 中Skill技能是賦予 Agent 可復(fù)用工作能力的最小單元。一個技能本質(zhì)就是一個文件夾里面放著一個SKILL.md說明書告訴 Agent什么時候被觸發(fā)Trigger——用戶說哪些話、發(fā)生什么事時啟動觸發(fā)后 Agent 該干什么——比如先走到自己的工位再開始處理任務(wù)狀態(tài)存在哪里、格式長什么樣——確保每次讀寫都確定、可復(fù)現(xiàn)。 心智模型SKILL.md就是寫給 AI 的崗位操作手冊寫得越明確Agent 執(zhí)行得越穩(wěn)定。官方對技能機制的第一性原理說明發(fā)現(xiàn)、優(yōu)先級、快照、注入流程見 skills-overview.md完整開發(fā)規(guī)范在 CREATING_SKILLS.md。第一步創(chuàng)建技能文件 SKILL.md含觸發(fā)器寫法每個技能都放在assets/skills/package-id/目錄下。以官方參考實現(xiàn) assets/skills/todo-board/SKILL.md 為模板結(jié)構(gòu)非常清晰assets/ skills/ todo-board/ SKILL.md todo-list.example.json一個合格的SKILL.md包含三部分frontmatter 元信息、Trigger 觸發(fā)塊、操作工作流說明。1.1 frontmatter技能的身份證--- name: todo description: Maintain a shared workspace TODO list with blocked tasks. metadata: {openclaw:{skillKey:todo-board}} ---name用戶在界面上看到的技能名稱metadata.openclaw.skillKey技能唯一鍵必須穩(wěn)定且與安裝后的文件夾名一致。1.2 Trigger讓 Agent 在 3D 辦公室里動起來這是 Claw3D 技能區(qū)別于普通 Agent 技能的靈魂——觸發(fā)時 Agent 有物理行為。以下是一個標(biāo)準(zhǔn)觸發(fā)塊摘自 todo-board 技能{ activation: { anyPhrases: [todo, todo list, blocked task] }, movement: { target: desk, skipIfAlreadyThere: true } }要點anyPhrases寫短而穩(wěn)定的短語命中即觸發(fā)Telegram 等外部渠道消息同樣有效movement.target目前支持desk、github、gym、qa_lab四種地點定義在 src/lib/office/places.tsJSON 塊才是 Claw3D 運行時真正解析的內(nèi)容不要只靠自然語言描述觸發(fā)行為。1.3 工作流說明明確到可直接執(zhí)行參考 assets/skills/todo-board/SKILL.md 中的必選工作流先讀文件、缺則創(chuàng)建、每次變更寫回磁盤、文件損壞則修復(fù)、請求模糊則先問清楚。配套的數(shù)據(jù)格式示例可對照 assets/skills/todo-board/todo-list.example.json。第二步把文件鏡像進(jìn) packaged.ts客戶端安裝副本Claw3D 安裝技能時不是直接讀取assets/skills/目錄而是從客戶端內(nèi)嵌的安全字符串中取文件。因此每個新技能都要在 src/lib/skills/packaged.ts 中登記一份對應(yīng)副本const PACKAGED_SKILL_FILES: Recordstring, PackagedSkillFile[] { my-skill: [ { relativePath: SKILL.md, content: MY_SKILL_MD }, ], };?? 兩份副本必須逐字節(jié)一致空格、frontmatter、文件名都不能有偏差。項目內(nèi)置了漂移檢測測試 tests/unit/packagedSkills.test.ts防止資產(chǎn)文件與內(nèi)嵌副本打架。第三步注冊到 catalog.ts讓技能進(jìn)入市場在 src/lib/skills/catalog.ts 的PACKAGED_SKILLS數(shù)組中添加一條定義{ packageId: my-skill, skillKey: my-skill, name: my-skill, description: Short description., installSource: openclaw-workspace, creatorName: your-handle, }字段速查字段作用packageId內(nèi)部資產(chǎn) ID通常是assets/skills/下的文件夾名skillKeyOpenClaw 技能鍵 安裝后的文件夾名name界面顯示名稱installSource當(dāng)前打包技能固定填openclaw-workspacecreatorName市場里顯示為 Powered by ... 的署名如需自定義分類、標(biāo)語、能力標(biāo)簽可在 src/lib/skills/marketplace.ts 中添加展示元數(shù)據(jù)覆蓋category、tagline、capabilities、editorBadge等。官方建議署名要真實不要偽造下載量。第四步理解安裝流程與上架后的效果點擊安裝后src/lib/skills/install-gateway.ts 會創(chuàng)建一個臨時網(wǎng)關(guān) Agent按SKILL.md指令把技能文件寫入所選工作區(qū)的workspace/skills/skillKey/ SKILL.md todo-list.example.json技能運行中產(chǎn)生的數(shù)據(jù)如todo-skill/todo-list.json屬于運行時狀態(tài)文件與安裝包本身分離由技能說明書約定路徑和 schema。技能上架后用戶可在 Studio 的技能市場中看到它、一鍵安裝并在 Agent 設(shè)置的Skills 標(biāo)簽頁中通過允許列表精細(xì)控制哪個 Agent 可以使用該技能allowlist 語義不配置全部可用顯式數(shù)組僅限所列。第五步跑測試驗證你的技能改動創(chuàng)建或修改打包技能后執(zhí)行官方推薦驗證三連npm test -- tests/unit/packagedSkills.test.ts tests/unit/skillsInstallGateway.test.ts npm run lint npm run typecheck若新增技能記得同步擴展packagedSkills.test.ts讓資產(chǎn)文件、內(nèi)嵌副本、市場元數(shù)據(jù)三者始終保持對齊。質(zhì)量清單讓你的技能達(dá)到生產(chǎn)級以todo-board為質(zhì)量標(biāo)桿CREATING_SKILLS.md 第 6 節(jié)? 明確的觸發(fā)器 明確的辦公室物理行為? 指令顯式、確定模型可直接照做? 狀態(tài)文件化并寫明 schema? 模糊請求強制先澄清不瞎猜? 安裝包只含技能真正需要的文件? 市場元數(shù)據(jù)真實、有署名。常見問題 FAQQ技能沒觸發(fā)怎么辦檢查## Trigger的 JSON 塊是否完整、anyPhrases是否足夠短小常見沒有觸發(fā)塊時會回退到 src/lib/office/places.ts 中的中央默認(rèn)觸發(fā)注冊表。Q改了 SKILL.md 但市場顯示不一致幾乎一定是packaged.ts內(nèi)嵌副本不同步跑一下packagedSkills.test.ts就能抓到漂移。Q技能安裝到了哪個目錄當(dāng)前打包安裝流程寫入workspace/skills/skillKey/安裝目標(biāo)為所選 Agent 的工作區(qū)安裝走默認(rèn) Agent 工作區(qū)上下文界面會給出范圍提示。 恭喜到這里你已經(jīng)掌握了 Claw3D 技能開發(fā)的全流程建文件 → 鏡像內(nèi)嵌 → 注冊市場 → 驗證測試 → 上架發(fā)布。想要本地動手先克隆倉庫git clone https://gitcode.com/gh_mirrors/cl/Claw3D打開 CREATING_SKILLS.md 邊對照邊寫你的第一個 Office Skill 就能進(jìn)入 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創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考