QClaw兼容技能筛选与更新操作全攻略

QClaw的技能列表里只能看到“兼容技能”？这其实是很多用户遇到的第一个坑。

如果你发现主界面技能列表中只显示了寥寥几个被标注为“兼容技能”的选项，而ClawHub上那些新发布的热门技能一个都看不到——别慌，这并非功能出了毛病，而是一个安全机制在起作用。说白了，就是当前技能市场通道没打开，或者本地运行的QClaw版本太低，系统主动把不匹配的技能给隐藏了。

要解决这个问题，分三步走，缺一不可。

确认QClaw客户端是否满足ClawHub技能运行前提

ClawHub的技能从v2.3.0版本开始，采用了一套全新的SKILL.md协议和沙箱执行环境。如果你用的还是旧版QClaw，系统会直接把这些不匹配的技能全部隐藏掉，连搜索结果里都不会出现。

怎么验证？跟着做就行：

第一步：点击界面右下角的齿轮图标，进入「关于QClaw」页面。

第二步：核对版本号——版本号必须为v2.3.0或更高。如果显示的是v2.2.x或更低，那说明还没升级，后面所有操作都是白费功夫。

第三步：版本不对的话，立即去claw.guanjia.qq.com/download下载最新安装包，覆盖安装一次就行，之前的配置会自动保留，不用担心。

启用ClawHub官方技能源并完成账号绑定

就算版本达标了，QClaw默认也是关闭外部技能源的。不授权的话，它还是只让你看本地预装的那几个“兼容技能”白名单。

这里有两种方式搞定：

方法一：图形界面操作，最简单

1. 进入设置 → 技能管理 → 技能市场，把「允许从ClawHub安装技能」开关打开。

2. 点击「绑定腾讯账号」，用微信扫码完成认证——这一步是硬性要求，不绑定的话，ClawHub技能永远加载不出来。

3. 等待大约10秒钟，界面会自动刷新，你会发现多出了一个ClawHub市场入口卡片。

方法二：命令行快速验证，适合批量部署环境

在终端里执行：qclaw --market clawhub --auth-status。如果返回的是true，说明通道已经就绪；如果报错“unauthorized”，那就还需要补扫微信码。

在内置浏览器中刷新技能列表并筛选全部技能

QClaw有个严格限制：所有ClawHub技能必须通过它内置的可信浏览器来加载元数据，不允许用外部浏览器跳转安装。不然签名校验会失败，技能会被系统静默过滤掉，你连影子都看不到。

最后一步，也很关键：

1. 点击刚刚出现的ClawHub市场入口卡片，进入内置浏览器界面。

2. 点击右上角的三个点，选择「刷新列表」——这一步是强制重新拉取ClawHub的全量技能索引，而不仅仅是读取本地缓存副本。

3. 刷新完成后，在搜索栏输入任意关键词（比如“web”），或者直接点击顶部的「全部技能」标签。这时候应该能看到数百个可安装的技能项，像ta vily-web-search、pdf-summarize这些热门技能都会出现。

4. 如果刷新之后还是只显示寥寥几个技能，那就要检查网络是否拦截了clawhub.ai这个域名。可以试试把DNS切换为114.114.114.114，然后重新来一遍。