Clawtique：OpenClaw的模块化能力管理器，解决插件污染与依赖难题

1. 项目概述Clawtique为OpenClaw打造的“衣橱”管理器如果你正在使用OpenClaw并且已经尝试过安装几个不同的技能Skill或者插件Plugin你可能会遇到一个典型的“环境污染”问题安装的东西越来越多文件散落在各处想彻底清理某个功能时却不知道哪些文件是它带来的哪些又是其他功能依赖的。最终你的OpenClaw工作空间变得臃肿且难以维护。这正是Clawtique要解决的核心痛点。你可以把它理解为一个专为OpenClaw设计的、高级的“包管理器”或“能力衣橱”。Clawtique引入了一个非常形象的概念——Dress礼服。一个Dress就是一个功能完整的“套装”它把实现某个特定任务所需的一切都打包在一起比如一个“日记伴侣”Dress里面可能包含了写日记的技能、定时提醒的Cron任务、一个用于美化排版的插件、几条让AI主动询问你一天感受的心跳规则甚至还有一些预设的日记模板文件。Clawtique的核心价值在于它让你可以像穿脱衣服一样一键“穿上”dress add或“脱下”dress remove某个功能套装整个过程干净利落不会留下任何“线头”即残留的配置文件或依赖。这对于希望保持OpenClaw工作空间整洁、或者需要在不同任务模式如写作模式、编程模式、学习模式间快速切换的用户来说是一个革命性的工具。这个项目本身采用Bun作为运行时并构建为一个Monorepo这意味着它的代码结构清晰模块化程度高便于开发者理解和贡献。无论你是OpenClaw的深度用户希望更优雅地管理你的AI助手能力还是一名开发者对如何构建一个干净、可追踪的插件/技能管理系统感兴趣Clawtique的设计思路和实现都值得深入探究。接下来我将带你从设计理念到实操细节完整拆解Clawtique。2. 核心设计理念与架构解析2.1 为什么是“Dress”而不是普通的“Package”在传统的软件包管理如npm, pip中包Package的安装往往是“叠加”式的。安装包A它会向系统注入自己的文件再安装包B它也可能修改或依赖一些公共文件。卸载时包管理器会尝试移除自己安装的文件但对于包运行期间产生的用户数据、或者被其他包修改的共享配置清理起来往往力不从心这就是所谓的“DLL Hell”或“依赖地狱”的变体。Clawtique的“Dress”概念巧妙地规避了这个问题。它的设计哲学是隔离与可逆。每个Dress被设计为一个自包含的、声明式的功能单元。它不直接、粗暴地修改OpenClaw的核心配置文件如AGENTS.md,SOUL.md而是通过一个精心设计的注入与发现链来动态加载。这就好比你的衣橱OpenClaw工作空间里有一个主衣架核心配置而每件衣服Dress都挂在一个独立的、带有标签的衣架上。当你需要穿某件衣服时你只是把这个独立衣架挂到主衣架上脱下时只需取下这个独立衣架。主衣架本身的结构始终保持不变。这种设计带来了几个关键优势安全性安装或移除Dress不会破坏OpenClaw的原始配置。最坏的情况是注入链失效但核心功能依然完好。可追踪性Clawtique通过自身的状态管理和Git仓库精确记录每个Dress安装和移除了哪些内容实现了操作的可审计性。干净卸载由于Dress的所有“部件”技能、定时任务等都在安装时被明确标记和定位卸载时可以精准移除避免了残留。2.2 核心工作机制注入链与文件流理解Clawtique如何工作关键在于理解OpenClaw的启动加载机制和Clawtique的“钩子”Hook。OpenClaw的默认加载流程 OpenClaw启动时会固定加载工作空间根目录下的几个核心元数据文件AGENTS.md定义AI代理行为SOUL.md定义核心人格与价值观USER.md用户上下文TOOLS.md可用工具IDENTITY.md代理身份。同时它会自动扫描~/.openclaw/workspace/skills/目录下的所有技能文件夹并将每个技能的SKILL.md文件中的名称和描述信息“注入”到每一次AI交互的上下文中。这是OpenClaw能力可扩展的基础。Clawtique的“钩子” Clawtique没有改变这个基础流程而是巧妙地“嵌入”了进去。它通过clawtique init命令在AGENTS.md文件中插入了一行引用指向一个由Clawtique管理的文件——DRESSES.md。这就形成了如下所述的发现链Discovery ChainAGENTS.md (OpenClaw始终加载) → 引用指向 DRESSES.md (由Clawtique创建和维护列出所有“已穿上”的Dress) → 每个在DRESSES.md中列出的Dress又链接到其自身的 DRESSCODE.md 文件 → DRESSCODE.md 文件详细描述了该Dress的所有组件技能、Cron、插件等。这个链式结构是Clawtique的灵魂。AGENTS.md作为不变的入口点DRESSES.md作为动态的目录而每个DRESSCODE.md则是具体Dress的“说明书”。当OpenClaw加载AGENTS.md时它会顺着引用找到DRESSES.md进而加载所有活跃Dress的DRESSCODE.md最终将所有Dress定义的能力整合到当前会话中。当你移除一个Dress时Clawtique只需将其从DRESSES.md列表中删除OpenClaw在下一次启动时就再也“看”不到它了实现了逻辑上的即时卸载。2.3 Dress的组成要素一个功能套装的解剖图一个完整的Dress不仅仅是一个技能。它是一个为了完成某个“工作”Job而精心编排的集合。让我们详细拆解它的每个部分Skills技能这是Dress的核心是AI能够执行的具体操作指南。每个技能是一个Markdown文件会被安装到~/.openclaw/workspace/skills/dress-id/SKILL.md。注意路径中的dress-id这保证了不同Dress的技能在物理上是隔离的方便管理。Crons定时任务让AI具备“主动”能力的关键。例如一个“晨间简报”Dress可以设置一个每天早上9点的Cron触发AI自动收集新闻并摘要。Clawtique会负责在系统层面或OpenClaw的任务调度器注册和注销这些定时任务。Plugins插件扩展OpenClaw本身功能的模块。比如一个Dress可能需要一个“邮件发送”插件或“日历读取”插件。Clawtique会管理这些插件的安装与依赖。Heartbeat rules心跳规则这是OpenClaw中实现“主动关怀”或“后台行为”的机制。Clawtique会将Dress定义的心跳规则追加到OpenClaw的HEARTBEAT.md文件中让AI在满足特定条件时自动执行某些操作例如“检测到用户超过2小时未活动主动询问是否需要休息”。Workspace files工作空间文件Dress可以携带一些模板或配置文件。例如一个“项目规划”Dress可能会提供几种不同的项目计划书模板。这些文件会被复制到~/.openclaw/workspace/dresses/dress-id/目录下供用户或AI技能使用。Daily memory section每日记忆分区OpenClaw的“每日笔记”是AI记忆用户互动的核心。一个Dress可以声明拥有其中的一个命名分区。例如“健身追踪”Dress可以拥有“## Fitness”分区专门记录用户的运动数据和AI的相关建议使记忆更有条理。注意Clawtique在安装Dress时会为上述大部分组件打上“属于该Dress”的标签通常通过元数据或记录在自身状态库中。这是实现“干净移除”的根本前提。没有准确的归属记录就无法做到精准清理。2.4 “Lingerie”内衣概念解决共享依赖的优雅方案在软件工程中共享依赖的管理一直是个难题。Clawtique用“Lingerie”这个风趣的概念给出了一个简洁的解决方案。你可以把Lingerie理解为基础插件或共享服务。例如多个Dress如“Slack通知助手”、“邮件处理专员”可能都需要使用“消息通道”插件来与外部通信。这个“消息通道”插件本身不直接提供最终用户功能但却是其他功能Dress的必需品。如果每个Dress都独立安装一份会造成冗余如果手动管理又容易出错。Clawtique的机制是自动安装当某个Dress在其声明中表明需要某个Lingerie如requires: messaging-channel时Clawtique会检查该Lingerie是否已安装。若未安装则自动安装它。引用计数Clawtique内部会维护一个依赖计数器。记录有多少个活跃的Dress依赖这个Lingerie。智能移除当你移除一个Dress时Clawtique会减少对应Lingerie的引用计数。只有当引用计数降为0即没有任何其他Dress需要它时Clawtique才会安全地移除这个Lingerie。这完美避免了“卸载一个功能却破坏了另一个不相关功能”的经典问题。这个设计体现了Clawtique在依赖管理上的成熟思考将复杂的共享状态管理简化为了自动化的引用计数对最终用户完全透明。3. 实操全流程从零开始使用Clawtique3.1 环境准备与初始化假设你已经安装并配置好了OpenClaw。使用Clawtique的第一步是安装它。根据项目信息它基于Bun因此我们优先使用Bun进行安装。# 使用Bun全局安装clawtique bun add -g clawtique # 或者从源码安装假设你在项目目录 bun install bun run build bun link # 链接到全局安装完成后进入你的OpenClaw工作空间目录通常是~/.openclaw或你自定义的位置。在运行任何命令前强烈建议备份你的AGENTS.md等核心配置文件这是一个良好的操作习惯。接下来执行初始化命令clawtique init这个命令背后做了以下几件重要的事情创建配置与状态目录在用户主目录下生成~/.clawtique/文件夹里面包含Clawtique自身的配置文件、状态数据库用于记录每个Dress的安装详情以及一个Git仓库。这个Git仓库至关重要它自动追踪所有对Dress的增删操作相当于一个版本控制系统让你可以回滚到任何之前的Dress组合状态。生成核心枢纽文件在你的OpenClaw工作空间根目录下创建DRESSES.md文件。这个文件初始可能是空的或者包含一些说明文字它是所有活跃Dress的清单。注入发现钩子这是最关键的一步。Clawtique会修改你的AGENTS.md文件在其中插入一行引用指向刚才创建的DRESSES.md。例如它可能在AGENTS.md的末尾添加类似这样的内容!-- Clawtique Dress Manager Hook -- !include DRESSES.md!include是OpenClaw支持的一种指令或类似机制用于包含其他文件内容。这样OpenClaw在加载AGENTS.md时就会自动将DRESSES.md的内容拉取进来。实操心得执行clawtique init后务必打开AGENTS.md检查一下注入是否成功。有时因为文件格式或权限问题注入可能失败。如果失败通常会有错误信息提示。你也可以手动按照上述格式添加引用行。确保这个钩子存在是后续所有Dress功能生效的前提。3.2 探索与安装你的第一件“Dress”初始化完成后你可以通过clawtique dress list如果支持或查阅Clawtique的Dress仓库来寻找可用的Dress。假设我们找到了一个名为journaling-companion日记伴侣的Dress。安装命令非常简单clawtique dress add journaling-companion让我们深入看看这条命令执行时Clawtique在后台的完整工作流解析Dress包Clawtique首先会从本地缓存或远程仓库获取journaling-companion的包定义文件可能是一个dress.json或manifest.md文件。这个文件定义了前面提到的所有组件技能、Cron、插件等。依赖检查与安装检查该Dress是否依赖某些“Lingerie”。如果有且未安装则先自动安装这些Lingerie。安装组件技能将Dress中的技能Markdown文件复制到~/.openclaw/workspace/skills/journaling-companion/目录下。插件通过OpenClaw的插件管理接口或直接安装到插件目录。Cron在Clawtique的状态库中注册定时任务并可能调用OpenClaw的调度器API或写入系统的crontab具体取决于实现。心跳规则读取Dress定义的心跳规则以追加Append而非覆盖的方式添加到OpenClaw的HEARTBEAT.md文件末尾。工作空间文件复制模板文件到~/.openclaw/workspace/dresses/journaling-companion/。生成DRESSCODE.md在Dress的安装目录可能是~/.openclaw/workspace/dresses/journaling-companion/或~/.clawtique/dresses/journaling-companion/下创建一个DRESSCODE.md文件。这个文件是人类和机器可读的清单详细列出了这个Dress安装的所有内容及其位置。这是卸载时的“地图”。更新DRESSES.md在OpenClaw工作空间的DRESSES.md文件中添加一行关于journaling-companion的记录通常包括其ID、名称和指向其DRESSCODE.md文件的链接。状态提交将本次安装操作的所有变更文件变动、状态记录提交到Clawtique自身的Git仓库中。这为你提供了回滚的可能。安装完成后你可以运行clawtique status来查看当前已安装的所有Dress及其状态。此时当你重启OpenClaw它就会通过AGENTS.md-DRESSES.md-journaling-companion的DRESSCODE.md这个链条加载日记伴侣的所有功能。AI助手现在应该就具备了写日记、定时提醒你写日记、按照特定模板整理日记等能力。3.3 个性化设置与切换Clawtique还提供了clawtique personality set id命令。这里的personality指的是OpenClaw的核心人格文件包AGENTS.md,SOUL.md,IDENTITY.md,TOOLS.md。这个功能适用于你想彻底切换AI的行为模式比如从“高效工作助理”人格切换到“创意写作伙伴”人格。重要警告这个命令会覆盖你现有的核心人格文件。其工作流程是从指定的人格包中取出文件覆盖当前工作空间中的AGENTS.md,SOUL.md,IDENTITY.md,TOOLS.md。由于覆盖操作会抹掉之前AGENTS.md中对DRESSES.md的引用所以Clawtique在覆盖完成后会重新执行注入将DRESSES.md的引用写回新的AGENTS.md中。这意味着你切换人格后之前安装的所有Dress通过DRESSES.md管理仍然有效。这是一个非常巧妙的设计将“基础人格”和“功能扩展”进行了分离。注意事项在使用personality set前必须确保你已经用clawtique init初始化过并且Clawtique的钩子注入机制正常工作。否则新人格文件可能不包含钩子导致所有已安装的Dress失效。最安全的做法是在切换人格后手动检查一下AGENTS.md文件末尾是否包含指向DRESSES.md的引用。3.4 干净移除Dress当你不再需要“日记伴侣”功能时就是体验Clawtique“干净移除”威力的时刻。clawtique dress remove journaling-companion这个命令的执行逻辑与安装相反但更加精细查阅DRESSCODE.md找到该Dress的DRESSCODE.md文件获取需要移除的完整清单。按序移除组件Cron从调度系统中注销该Dress注册的所有定时任务。技能删除~/.openclaw/workspace/skills/journaling-companion/目录。关键点Clawtique只删除它自己安装的技能。如果用户在该目录下手动添加了其他文件理论上不会被误删具体行为取决于实现但设计初衷是安全的。插件检查该插件是否被其他Dress依赖引用计数。如果引用计数1则只减少计数不删除插件。如果引用计数降为0则移除该插件。心跳规则这是比较棘手的部分。因为心跳规则是追加到HEARTBEAT.md文件中的。Clawtique需要精准地找到由这个Dress添加的那些行并将其删除而不是清空整个文件。这通常通过在添加规则时添加特殊注释标记如!-- Added by dress: journaling-companion --来实现。工作空间文件默认行为是保留。这是非常合理的因为用户在Dress使用期间可能在这些文件里创建了有价值的内容如写好的日记模板。Clawtique会保留~/.openclaw/workspace/dresses/journaling-companion/目录及其内容。如果需要强制清理可能会有--purge之类的选项。更新元数据从DRESSES.md中移除该Dress的条目。删除该Dress的DRESSCODE.md文件。状态更新与提交在Clawtique的状态库中标记该Dress为已移除并将此次移除操作作为一次新的提交记录到Git仓库。执行完毕后journaling-companion这个Dress就从你的系统中“蒸发”了。OpenClaw重启后由于DRESSES.md里已没有它对应的技能、Cron、心跳规则都不会再被加载。而你在使用期间产生的数据如AI写的日记内容则保留在OpenClaw的常规记忆或笔记系统中不受影响。这真正做到了“功能卸载数据保留”的理想状态。4. 高级主题与最佳实践4.1 状态管理与回滚Clawtique内置的Git仓库是其可靠性的基石。这个仓库位于~/.clawtique/.git它追踪的不是你的OpenClaw工作空间文件而是Clawtique自身的状态变更——即每一次dress add、dress remove、personality set操作。你可以进入~/.clawtique目录使用标准的Git命令来查看历史cd ~/.clawtique git log --oneline这会显示一串操作记录例如“Add dress: journaling-companion”, “Remove dress: news-summarizer”。如何利用它进行回滚假设你不小心移除了一个Dress或者安装新Dress后系统不稳定你可以使用Clawtique可能提供的回滚命令或者手动通过Git回退状态。例如如果Clawtique提供了clawtique history revert commit-hash它应该能根据历史状态重新计算并应用Dress集合。如果没有此类命令高级用户可以手动研究状态文件的结构但风险较高。最佳实践定期查看clawtique status输出并将其与你的需求进行比对。在进行任何重大变更如安装多个Dress或切换人格前可以考虑手动备份~/.clawtique目录。将其视为你的“系统配置备份”。4.2 创建你自己的DressClawtique的真正威力在于社区生态。你可以为自己常用的工作流创建自定义Dress。创建一个Dress通常涉及以下步骤规划功能明确这个Dress要完成什么任务。例如一个“代码审查助手”Dress。创建清单文件在一个新目录中创建一个manifest.json或类似文件用于声明Dress的元数据ID, 名称版本描述和组件。{ id: code-review-helper, name: Code Review Assistant, version: 1.0.0, description: An AI assistant for reviewing pull requests and code snippets., requires: [github-plugin], // 依赖的Lingerie skills: [{ id: review-pr, path: ./skills/review-pr.md }], crons: [{ schedule: 0 10 * * 1-5, // 工作日早上10点 command: trigger_skill code-review-helper/review-pr }], heartbeat_rules: [{ condition: new_pull_request, action: notify_and_review }], workspace_files: [{ source: ./templates/review-template.md, destination: templates/ }] }编写技能文件按照OpenClaw的技能格式编写skills/review-pr.md定义AI如何执行代码审查。打包将整个目录打包成.tar.gz或使用特定的包管理格式。发布与分享你可以将Dress发布到Clawtique的公共仓库或者直接在团队内部分享文件。通过创建自定义Dress你可以将任何重复性的、多步骤的AI交互场景标准化、产品化极大提升效率。4.3 故障排除与常见问题即使设计再精良在实际操作中也可能遇到问题。以下是一些常见场景及排查思路问题1安装Dress后OpenClaw没有表现出新功能。检查注入链首先确认AGENTS.md文件中是否包含指向DRESSES.md的正确引用。这是最可能的原因。检查DRESSES.md打开OpenClaw工作空间下的DRESSES.md查看目标Dress是否在列表中。如果不在说明安装未成功更新该文件。检查Dress状态运行clawtique status确认Dress是否显示为“active”或类似状态。查看日志运行clawtique dress add时是否显示了任何错误或警告信息Clawtique和OpenClaw的日志文件也可能提供线索。重启OpenClaw某些更改需要重启OpenClaw进程才能生效。问题2移除Dress后其心跳规则或Cron任务似乎还在运行。手动清理残留Clawtique的设计目标是自动清理但可能存在边界情况。检查HEARTBEAT.md文件手动删除标记为该Dress的规则区块。对于Cron检查OpenClaw的调度器界面或系统的crontab (crontab -l)。状态不一致可能是Clawtique的状态数据库与实际情况不同步。尝试运行clawtique repair或clawtique sync如果命令存在来修复状态。作为最后手段可以谨慎地手动清理~/.clawtique/state.json先备份并重新初始化。问题3clawtique personality set后所有Dress都消失了。钩子丢失这几乎可以肯定是新的人格文件覆盖了旧的AGENTS.md而Clawtique未能成功重新注入钩子。解决方案是运行clawtique init --force-rehook如果支持来强制重新注入。或者手动编辑新的AGENTS.md在文件末尾添加指向DRESSES.md的引用语句。完成后再次运行clawtique statusDress应该会重新出现。问题4我想备份/迁移我的整个Clawtique配置。核心目录备份~/.clawtique/整个文件夹。这里面包含了所有已安装Dress的定义、状态和Git历史。工作空间文件备份~/.openclaw/workspace/dresses/目录这里存放着各Dress的工作空间文件如果你选择保留的话。恢复在新机器上安装OpenClaw和Clawtique后先运行clawtique init然后停止Clawtique服务用备份的~/.clawtique/覆盖新生成的目录再用备份的dresses/目录覆盖对应位置。重启后你的Dress环境应该就恢复了。Clawtique代表了一种管理复杂AI助手扩展的先进思路。它将离散的能力封装成可独立安装卸载的“礼服”通过非侵入式的钩子机制实现动态加载并利用状态跟踪和引用计数解决依赖难题。对于追求效率与整洁的OpenClaw用户而言它是不可或缺的利器对于开发者而言其架构设计也提供了关于插件系统、依赖管理和干净部署的宝贵启示。开始用Clawtique来打理你的OpenClaw“衣橱”体验那种随心搭配、即穿即走的从容吧。如果在使用中遇到任何问题不妨多查阅其状态文件和日志它们往往是解开谜团的关键。