收到“需要安装技能”提示时，说明QClaw缺少任务依赖的技能模块，需通过自动安装、手动注册、修复签名验证或清理缓存重建索引四种方式解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用QClaw执行任务时收到“需要安装技能”的提示，说明当前运行环境缺少该任务所依赖的特定技能模块。QClaw在调用某些功能前会校验本地是否已注册对应技能，未检测到则触发此提示。以下是几种可行的操作方案：
一、启用QClaw内置技能自动安装机制
QClaw默认支持从官方技能仓库拉取并安装缺失技能，前提是配置了有效的技能源地址且网络可达。该方式无需手动下载，由框架自动完成依赖解析与安装。
1、确认QClaw配置文件config.yaml中skills_repo字段已设置为有效URL，例如：https://github.com/qclaw/skills.git。
2、在终端进入QClaw主程序目录，执行命令：qclaw --install-skill --name=目标技能名（将“目标技能名”替换为提示中具体指出的技能标识，如“web_crawler”）。
3、等待控制台输出“Skill installed successfully”及版本号信息，表示安装完成。
二、手动下载并注册技能包
当自动安装失败或需指定版本时，可直接获取技能源码包，通过本地路径注册。该方法绕过网络校验，适用于离线或受控环境。
1、访问QClaw官方技能仓库页面，定位对应技能子目录，点击“Code → Download ZIP”，保存压缩包至本地任意路径。
2、解压ZIP文件，确保解压后根目录包含skill.yaml和main.py两个必需文件。
3、在终端执行注册命令：qclaw --register-skill /path/to/unzipped/skill/folder（将路径替换为实际解压路径）。
4、检查输出中是否出现“Registered skill: [技能名] v[版本号]”，确认注册成功。
三、检查并修复技能签名验证失败问题
部分QClaw部署启用了技能签名强制校验，若自动安装的技能包签名不匹配或证书过期，会拒绝加载并持续提示“需要安装技能”。此时需更新信任链或临时禁用校验。
1、查看错误日志末尾是否含“signature verification failed”字样，若有则进入本流程。
2、执行命令刷新签名密钥：qclaw --update-sig-keys。
3、若仍失败，可临时允许未签名技能（仅限测试环境）：qclaw --disable-sig-check，随后重试自动安装步骤。
四、清理冲突技能缓存并重建索引
旧版本技能残留或索引损坏可能导致QClaw误判技能缺失。清除缓存后重新扫描可恢复正确识别状态。
1、定位QClaw缓存目录，通常为用户主目录下~/.qclaw/skills_cache/。
2、执行命令删除缓存：rm -rf ~/.qclaw/skills_cache/*（Linux/macOS）或使用资源管理器清空对应Windows路径。
3、运行索引重建命令：qclaw --rebuild-skill-index。
4、重启QClaw服务进程，再次触发原任务观察提示是否消失。
