需按五步操作:一、检查Skill包含skill.json及必需字段并补全__init__.py;二、复制到config.yaml中skills_root指定路径且路径无中文或空格;三、用qclaw.cli注册命令完成注册;四、依requirements.txt或skill.json的dependencies安装依赖;五、重启QClaw并在日志确认加载成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您在社区下载了适用于QClaw的新技能(Skill),但无法直接启用或识别,通常是因为该Skill未被正确导入至QClaw的技能目录结构中,或缺少必要的注册与依赖配置。以下是将第三方Skill成功导入并启用的具体操作步骤:
一、确认Skill包结构是否合规
QClaw仅识别符合其规范的Skill目录格式。一个可被识别的Skill必须包含skill.json元信息文件,并处于独立子目录中。若下载的是压缩包,需先解压并检查内部结构是否满足要求。
1、解压下载的Skill压缩包,查看根目录下是否存在skill.json文件。
2、确认skill.json中包含必需字段:"name"、"version"、"entry"(指向主Python模块)及"description"。
3、检查是否存在__init__.py文件;若无,需手动创建空文件以确保Python包可被导入。
二、将Skill复制到QClaw技能目录
QClaw在启动时会扫描指定路径下的子目录以加载Skill。必须将Skill文件夹完整复制至QClaw配置的skills_root路径,否则不会被检测到。
1、打开QClaw主程序所在目录,进入config.yaml文件,查找skills_root字段值(默认常为./skills)。
2、进入该路径,将解压后的Skill文件夹(如weather-skill)整体复制粘贴至此目录下。
3、确认该文件夹权限可读,且不含中文路径或空格——路径中出现中文或空格会导致加载失败。
三、执行Skill注册命令
部分Skill依赖外部Python包或需向QClaw核心注册触发器与意图。仅复制文件夹不足以激活功能,需通过CLI工具完成注册流程。
1、在终端中切换至QClaw主程序所在目录。
2、运行命令:python -m qclaw.cli skill register weather-skill(将weather-skill替换为实际文件夹名)。
3、观察输出日志:若显示"Registered successfully"且无ImportError,则注册完成。
四、检查依赖并安装缺失模块
第三方Skill常依赖特定Python库(如requests、pytz),若未安装,QClaw在加载时会跳过该Skill且不报错,仅在日志中提示ImportError。
1、进入Skill文件夹,查看是否存在requirements.txt文件。
2、若有,执行:pip install -r requirements.txt(建议在QClaw所用Python环境中运行)。
3、若无requirements.txt,打开skill.json,检查"dependencies"字段列出的包名,并逐一安装。
五、重启QClaw并验证加载状态
QClaw仅在启动阶段扫描并初始化Skill,任何运行时的目录变更或注册操作均需重启服务才能生效。
1、终止当前QClaw进程(使用Ctrl+C或kill命令)。
2、重新运行启动命令,例如:python -m qclaw.main。
3、启动日志中逐行查找Skill名称,确认出现类似"Loaded skill: weather-skill (v1.2.0)"的提示行。










