1. Cherry Studio 技能商店到底解决什么问题
Cherry Studio 在 2026 年版本里把「技能商店」做成了独立面板,这件事对日常写代码、写文档的人影响挺大。简单说,技能商店就是一个集中管理 OpenClaw 技能(Skills)的地方,你能在里面搜索、安装、更新、卸载技能,不用再手动去 GitHub 拉仓库、复制目录、改配置文件。它适合三类人:一是刚接触 Cherry Studio、想让 AI 真正动手干活而不是只聊天的新手;二是已经在用 OpenClaw 但技能散落在本地、版本混乱的老用户;三是团队里需要统一技能版本、统一模型入口的开发者。
技能(Skills)本质上是给 AI 加「手脚」。普通对话只能让模型输出文字,技能能让模型读写文件、调用 API、操作浏览器、跑定时任务。每个技能目录里至少有一个SKILL.md描述文件,说明这个技能叫什么、干什么、需要哪些工具和依赖;复杂一点的还会带scripts/放 Bash、Python、Node 脚本,带references/放参考文档。Cherry Studio 读取这些目录后,把技能注册进当前会话,模型在需要时就会调用对应脚本。
技能默认放在用户目录下的工作区里,Windows 上是C:\Users\用户名\.openclaw\workspace\skills\,macOS 和 Linux 是~/.openclaw/workspace/skills/。目录结构大致是这样:
skills/ ├── self-improving-proactive-agent/ │ ├── SKILL.md │ ├── scripts/ │ └── references/ ├── feishu-doc/ │ └── SKILL.md └── weather/ └── SKILL.md技能商店的价值在于,它把「找技能、装技能、验证技能」这条链路缩短了。以前你要自己去搜仓库、看 README、判断依赖,现在商店里直接列出技能名、用途、评分和安装命令。但商店本身不解决模型接入问题——技能跑起来要调用大模型,模型从哪来、Key 怎么统一管理,这是另一件事。这也是为什么这篇要把 TaoToken 统一 Key 接入和技能安装放在一起讲:技能装好了,模型入口没配好,调用照样失败。
我试过在没配统一 Key 的情况下装了一堆技能,结果每次调用都报 401,排查半天才发现是模型凭证没生效。所以下面的顺序是:先把模型入口配好,再装技能,最后验证技能加载和调用。这样每一步都有明确的成功标志,出问题也好定位。
2. TaoToken 统一 Key 前置准备与模型入口配置
TaoToken 在这里扮演的角色是「统一模型入口」。你不需要在每个技能、每个工具里分别填不同的模型地址和 Key,而是把 Base URL 和 API Key 配一次,让 Cherry Studio 和 OpenClaw 都走这个入口。这样做的好处是:换模型、加模型、管额度都只在一个地方操作,技能侧不用改。
先拿到两样东西:API Key 和 Base URL。API Key 在控制台的 API Keys 页面创建,Base URL 用https://taotoken.net/api。注意 Base URL 不要带末尾斜杠,也不要自己拼/v1,具体路径以接入文档为准。创建 Key 的时候建议按用途命名,比如cherry-openclaw-2026,方便后面排查是哪个 Key 在调用。
拿到 Key 之后,在 Cherry Studio 里配置模型服务。打开设置里的模型服务面板,新增一个自定义提供商,填入:
{ "provider": "taotoken", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": [ "claude-sonnet-4-5", "gpt-5", "deepseek-v3" ] }这段 JSON 是示意结构,实际字段名以 Cherry Studio 当前版本的设置界面为准。关键是三件套要对齐:Base URL 指向 TaoToken 的 API 地址,API Key 用刚创建的,Model ID 填你实际要用的模型标识。Model ID 写错是最常见的坑,比如把claude-sonnet-4-5写成claude-sonnet-4.5,请求会直接报模型不存在。
如果你用的是 OpenClaw 侧的配置文件,比如auth.json或settings.json,结构类似:
{ "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "defaultModel": "claude-sonnet-4-5" }配完之后不要急着装技能,先做一次最小验证:在 Cherry Studio 里发一条普通对话,确认模型能正常返回。如果这一步就报 401,说明 Key 或 Base URL 有问题;如果报模型不存在,说明 Model ID 写错了。把这一步跑通,再进技能商店,能省掉后面大量排查时间。
注意:API Key 不要写进会提交到 Git 的文件里,也不要贴在公开的 SKILL.md 中。技能脚本读取环境变量或本地配置文件更安全。
3. 技能商店精选技能与可复制安装配置
技能商店里技能很多,但真正每天会用到的就那么几类。下面按用途挑几个,给出安装命令和配置片段。安装方式主要是 ClawHub 命令行,部分官方技能需要手动下载。
基础必备类,建议每个用户都装:
npx clawhub install self-improving-proactive-agent npx clawhub install feishu-doc npx clawhub install feishu-wiki npx clawhub install weatherself-improving-proactive-agent负责记录你的每次纠正、维护心跳状态、主动优化工作模式,它会在技能目录下生成corrections.md、patterns.md、heartbeat-state.md、memory.md这些文件。feishu-doc用来读写飞书云文档,feishu-wiki操作知识库节点,weather查天气。这几个装完,日常问答和文档处理基本够用。
开发类技能:
npx clawhub install frontend-dev npx clawhub install fullstack-dev npx clawhub install playwright-browser-automation npx clawhub install docker-essentialsfrontend-dev支持 React、Vue、HTML、CSS、TypeScript 的组件生成和调试;fullstack-dev覆盖数据库设计、API 开发、前后端联调;playwright-browser-automation需要先装浏览器:
npx playwright install chromium npx playwright install firefox装完之后可以跑截图和内容提取:
npx playwright screenshot https://example.com output.png npx playwright extract https://news.site.com多模态类技能,MiniMax 官方工具包需要手动下载:
git clone https://github.com/MiniMax-AI/skills.git cp -r skills/minimax-multimodal-toolkit ~/.openclaw/workspace/skills/这个工具包覆盖语音合成、音乐生成、图片生成、视频生成。语音合成示例:
bash scripts/tts/generate_voice.sh tts "你好世界" -o hello.mp3 bash scripts/tts/generate_voice.sh tts "播报新闻" -v female-news -o news.mp3图片生成示例:
bash scripts/image/generate_image.sh \ --prompt "热带海滩,湛蓝海水,椰子树,日落,摄影作品" \ --aspect-ratio 16:9 \ -o beach_sunset.png视频生成示例:
bash scripts/video/generate_video.sh \ --mode t2v \ --prompt "海浪拍打礁石,[固定]镜头,6秒循环" \ --output ocean.mp4效率工具类:
npx clawhub install summarize npx clawhub install excel npx clawhub install githubsummarize对 URL、PDF、YouTube 视频做摘要,excel读写 Excel 并做数据分析,github通过 API 操作 Issues、PR、Repos。GitHub 技能常用命令:
gh issue search "bug" --repo owner/repo gh issue create --title "Bug报告" --body "描述..." gh pr status技能装完后,Cherry Studio 的技能面板应该能看到对应条目。如果装了但面板不显示,先检查技能目录里有没有SKILL.md,再检查目录名和技能名是否一致。
4. 验证技能加载与调用是否成功
装完技能不等于能用,必须做加载验证和调用验证两步。加载验证看技能有没有被 Cherry Studio 识别,调用验证看技能执行时模型入口通不通。
加载验证:打开 Cherry Studio 的技能面板,逐个确认技能状态是「已加载」而不是「未识别」。如果某个技能显示未识别,最常见原因是SKILL.md缺失或格式不对。你可以直接看文件头:
cat ~/.openclaw/workspace/skills/weather/SKILL.md正常的SKILL.md开头会有技能名称、功能描述、依赖说明。如果文件是空的或者只有几行乱码,说明下载不完整,重新装一次。
调用验证:用天气技能做最小测试。在对话里输入「天气 北京」,观察返回。成功的话会返回北京的天气信息;失败的话分几种情况:报 401 说明模型 Key 没生效,报技能未找到说明技能没加载,报脚本执行失败说明依赖没装。
再测一个需要模型参与的技能,比如summarize:
summarize https://example.com/article这个技能会先抓取网页内容,再调用模型做摘要。如果摘要能出来,说明「技能执行 + 模型调用」整条链路是通的。这一步很关键,因为很多技能本身是脚本,但摘要、分析这类动作要调模型,模型入口没配好就会卡在这里。
多模态技能验证稍微麻烦一点,以语音合成为例:
bash scripts/tts/generate_voice.sh tts "测试语音" -o test.mp3 ls -lh test.mp3如果test.mp3生成成功且大小正常,说明技能脚本和依赖都没问题。如果报错,先看脚本里的依赖有没有装,再看环境变量里有没有模型凭证。
提示:验证顺序建议是「普通对话 → 纯脚本技能 → 需要模型的技能 → 多模态技能」,从简单到复杂,出问题容易定位。
5. 本篇常见报错排查
这一节按真实报错来。第一个高频错误是 401:
Error: 401 Unauthorized这个基本是 API Key 问题。检查三处:Key 有没有复制完整、Base URL 是不是https://taotoken.net/api、Key 有没有过期或被禁用。如果 Key 是对的,检查是不是把 Key 写到了错误的位置,比如写进了技能脚本而不是 Cherry Studio 的模型服务配置。
第二个是 local proxy failed:
Error: local proxy failed to connect这个通常出现在本地代理配置和实际网络环境不匹配的时候。检查 Cherry Studio 的网络设置里有没有开启本地代理,如果开了但代理服务没跑,就会报这个。关掉本地代理,让请求直连 TaoToken 的 API 地址,一般能解决。
第三个是 reading choices:
Error: reading 'choices' of undefined这个报错说明请求发出去了,但返回结构不是预期的模型响应格式。常见原因是 Base URL 拼错了,比如多加了/v1或者少了路径段,导致请求打到了非模型接口。把 Base URL 改回https://taotoken.net/api,不要自己拼路径。
第四个是 OAuth 相关:
Error: OAuth token expired这个一般出现在 GitHub 技能或 Google Workspace 技能上,和模型 Key 无关。重新走一遍对应平台的授权流程即可。如果技能里用的是gh命令,跑gh auth login重新登录。
第五个是技能装了但不生效:
Skill not found: xxx先确认技能目录名和调用名一致,再确认SKILL.md存在。有些技能安装后目录名带版本号,调用时要用不带版本号的名字。如果还不行,重启 Cherry Studio,让它重新扫描技能目录。
排查时记住一个原则:先确认模型入口通不通,再确认技能加载没加载,最后确认技能脚本依赖全不全。这三层分开查,比一股脑改配置高效得多。
6. 统一 Key 接入后的长期使用建议
把 TaoToken 作为统一模型入口配好之后,后面加技能、换模型都不用再动技能侧配置。你可以把常用的模型 ID 整理成一个清单,放在 Cherry Studio 的模型服务设置里,需要切换时直接选。Coding Plan 适合长期编码和 Agent 场景,如果你每天都要跑大量代码生成和技能调用,可以了解下它的额度方式。
技能更新方面,ClawHub 支持搜索和列出已安装技能:
npx clawhub search 关键词 npx clawhub list定期跑一下npx clawhub list,看看有没有技能可以更新。对于self-improving-proactive-agent这类会写本地文件的技能,建议定期备份~/.openclaw/workspace/skills/目录,避免误删。
最后提醒一点:技能脚本里如果需要填模型地址,统一填 TaoToken 的 API 地址,不要混用多个入口。混用会导致排查困难,也会让额度管理变乱。统一入口、统一 Key、统一模型 ID,这三件事做到位,Cherry Studio 加 OpenClaw 的技能体系才能真正稳定跑起来。