1. qclaw 装完 SkillHub 之后为什么还要配 TaoTokenqclaw 本身是一个本地 AI 客户端SkillHub 是给它挂上的 AI Skills 商店装完之后你能在客户端里浏览、搜索、一键加载各种技能。但很多人卡在同一个地方商店装好了技能列表也能刷出来可一旦真正调用某个 Skill 去跑对话或代码任务就报鉴权失败、模型不可用、请求超时。原因不复杂——SkillHub 负责的是「技能从哪来」而技能背后要调用的模型通道得由你自己在 qclaw 的配置里接上。这篇就按「先装商店、再配通道、最后验证」的顺序走一遍。核心检索词先摆出来qclaw 安装 SkillHub、SkillHub 商店安装、AI Skills 社区、qclaw 插件安装、SkillHub 使用教程。适合谁看已经在本地跑 qclaw、想让技能市场真正可用、并且希望用一个统一 Key 打通模型调用的开发者。装商店那步很快真正决定你能不能跑通的是后面的 config.toml / settings.json 骨架和 TaoToken 的填写位置我会把可复制的片段都给出来。我试过把商店和通道分开配结果排查了半天才发现是 Key 没落到正确的字段上。所以下面每一步都标了「改哪个文件、填哪一行、怎么确认生效」你照着做基本能一次跑通。2. 前置准备qclaw 环境与 TaoToken 统一 Key2.1 qclaw 侧要满足的条件开始之前确认三件事qclaw 已经安装并能正常启动客户端里的 AI 对话功能本身可用哪怕先用默认通道你有权限修改 qclaw 的配置文件目录。qclaw 的配置一般落在用户目录下的配置文件夹里常见是~/.qclaw/macOS / Linux或%USERPROFILE%\.qclaw\Windows里面会有config.toml和settings.json两个文件。不同版本命名可能略有差异以你本地实际生成的为准。2.2 拿到 TaoToken 的统一 KeyTaoToken 在这里的角色是「统一模型通道 统一 Key」。你不需要为每个 Skill 单独配一家模型服务只要在 qclaw 里把 base_url 指向 TaoToken 的 API 地址再填一个 Key所有走这个通道的技能就都能调起来。操作路径先到官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册登录然后进控制台创建 API Key。控制台入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。创建后复制那串sk-开头的 Key先存到本地临时文件里下一步要填进配置。注意Key 只显示一次页面关掉就看不到了务必先复制再关。API 基础地址用 https://taotoken.net/api 这个地址不带任何查询参数直接作为 base_url 填。2.3 装 SkillHub 商店本身SkillHub 的安装走对话式最省事打开 qclaw 对话窗口把官方给的安装提示词整段发过去客户端会自动拉取安装脚本并完成组件下载与配置接入。装完后客户端里会出现 SkillHub 入口能搜索和浏览 AI Skills。这一步和通道配置是两件事商店装好不代表模型通道就通了别混在一起排查。3. 可复制配置config.toml 与 settings.json 骨架3.1 config.toml 里填 TaoToken 通道qclaw 的模型通道通常写在config.toml。下面是一个可直接改的骨架重点是base_url和api_key两行# ~/.qclaw/config.toml [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 default_model claude-sonnet-4-5 timeout 60 [skillhub] enabled true registry https://skillhub.cn auto_update truebase_url一定用https://taotoken.net/api不要自己拼/v1之类的后缀通道侧会按标准路径路由。default_model填你账号下可用的模型名不确定就先留一个通用对话模型跑通后再换。timeout给 60 秒技能里如果有长任务可以调到 120。3.2 settings.json 里对齐 SkillHub 与通道有些 qclaw 版本把运行时设置放在settings.json这里要保证 SkillHub 的调用走的是同一个 provider{ activeProvider: taotoken, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [claude-sonnet-4-5, gpt-4o-mini] } }, skillhub: { enabled: true, installPath: ~/.qclaw/skills, autoLoad: true } }两个文件如果同时存在以客户端实际读取的那个为准不确定就两个都填成一致避免出现「config 里是 A、settings 里是 B」的错位。installPath是技能落地目录autoLoad打开后商店里装的技能会在启动时自动加载。3.3 环境变量兜底可选如果你不想把 Key 写进文件可以用环境变量qclaw 一般会优先读环境变量export TAOTOKEN_API_KEYsk-你的TaoToken密钥 export TAOTOKEN_BASE_URLhttps://taotoken.net/apiWindows 下用setx TAOTOKEN_API_KEY sk-...。设完重启 qclaw 生效。这种方式适合多客户端共用同一个 Key 的场景。4. 验证请求确认 SkillHub 连通与技能加载4.1 先验通道再验商店顺序很重要先确认模型通道能通再看商店技能能不能加载。用一条最小请求打通道curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回里带choices字段和一段正常回复说明 Key 和 base_url 都对。如果返回 401是 Key 问题返回 404多半是 base_url 拼错了超时则检查网络和 timeout 设置。4.2 在 qclaw 里跑一次技能调用通道通了之后回到 qclaw打开 SkillHub 入口随便选一个轻量技能比如文本改写类触发一次调用。观察客户端日志或输出面板能看到请求发往taotoken.net/api、并且拿到模型返回就说明「商店 通道」这条链路完整打通了。技能列表能刷出来只证明商店连通能真正跑出结果才证明通道接对了。4.3 检查技能加载目录确认技能确实落地了ls -la ~/.qclaw/skills应该能看到从 SkillHub 安装下来的技能文件夹。如果目录是空的说明installPath配错或autoLoad没开回到第 3 节核对。5. 本篇常见错排查5.1 报鉴权失败 / 401九成是 Key 没填对或填错位置。检查config.toml的api_key和settings.json的apiKey是否一致有没有多余空格或换行。环境变量和文件同时存在时确认哪个优先级更高别让旧 Key 覆盖了新 Key。5.2 商店能开但技能调用超时这是典型的「商店通了、通道没通」。先跑 4.1 的 curl确认通道本身可用再看timeout是不是太短长任务技能建议 120 秒起。如果 curl 通、客户端不通检查 qclaw 是否真的读了你改的那个配置文件。5.3 base_url 写错导致 404常见错误是写成https://taotoken.net/api/v1或带上一堆查询参数。正确写法就是https://taotoken.net/api路径由通道侧处理。改完记得重启客户端。5.4 技能装了但列表不显示看installPath指向的目录里有没有文件再看autoLoad是否为 true。有些版本需要手动触发一次「重新加载技能」或者重启 qclaw 才会刷新列表。5.5 多模型切换后报模型不存在default_model或models数组里填的模型名必须是你账号下实际可用的。填了个不存在的名字请求会被拒。不确定就先只留一个确认可用的模型跑通再扩。6. 接下来怎么用按场景选对入口链路跑通后日常使用分三种情况。如果你是在排障或做接入调试重点看 API Keys 和接入文档Key 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入说明在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你只是想快速验证某个模型在技能里的表现直接开模型对话页试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你是长期拿 qclaw 跑编码或 Agent 类任务建议上 Coding Plan额度更稳https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。最后给个实用习惯把config.toml和settings.json里的 provider 段单独备份一份换机器或重装 qclaw 时直接覆盖省得重新对字段。技能装多了之后定期清一下~/.qclaw/skills里不用的启动会快不少。