1. OpenClaw Skill 安装方式到底怎么选ClawHub、CLI 与 SkillHub 的真实差异OpenClaw Skill 是给 OpenClaw 智能体挂载可复用能力的最小单元一个 Skill 通常就是一份带SKILL.md描述和若干脚本的目录装进工作区后智能体在对话里就能直接调用它完成搜索、总结、抓取、格式转换这类具体任务。它适合三类人一是刚接触 OpenClaw、想快速给智能体加能力的新手二是已经在跑多智能体、需要批量管理技能目录的开发者三是把 OpenClaw 部署在云服务器上、希望通过应用管理界面统一维护的运维同学。安装路径看着多其实核心就两条走市场ClawHub、SkillHub自动拉取或者走本地CLI、手动、git clone自己放进去。选哪条取决于你的网络环境、对版本可控性的要求以及你是否需要把模型调用统一收敛到同一个 Key 上。我自己在几台机器上反复装过同一批 Skill最直观的体会是市场安装省事但受网络和限流影响大本地安装可控但要自己管目录和依赖。而真正容易被忽略的一环是 Skill 运行起来之后调用模型时用的 Base URL 和 Key——如果每个 Skill 各配一套后面排查问题会非常痛苦。所以这篇不只讲怎么把 Skill 装进去还会把 TaoToken 的统一 Key 接进 Skill 运行环境让所有技能走同一个入口。先把五种方式摆在一起对比你一眼就能看出适用场景安装方式适用场景优点主要坑点ClawHub CLI想要最新最全技能官方渠道、更新及时国内访问受限、易触发限流对话安装图省事、装单个技能一句话搞定智能体可能自己现写一个手动安装有技术基础、要改源码灵活可控需自己解压、放对目录SkillHub国内用户日常使用访问稳定、操作简单需先装商店应用管理界面云服务器部署图形化、免命令行仅部分应用型实例支持这张表不是让你只选一个实际用起来往往是组合先用 SkillHub 或手动方式把常用技能装好再用 CLI 补装个别只在 ClawHub 上有的技能。下面按这个思路从环境准备讲到验证调用。需要先明确一个概念Skill 本身不绑定模型它只是能力描述和脚本真正决定它调用哪个模型、走哪个地址的是 OpenClaw 的运行环境配置。所以「安装 Skill」和「配置模型入口」是两件事但必须一起做否则技能装好了却调不通模型你会以为是安装失败。这也是很多人卡住的地方。2. TaoToken 前置准备把统一 Key 和 Base URL 拿到手在装任何 Skill 之前先把模型入口准备好这样后面每装一个技能都能立刻验证。TaoToken 的作用是给你一个统一的 API 入口OpenClaw 里所有 Skill 调用模型时都指向同一个 Base URL 和同一个 Key省得每个技能单独配。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录。登录后进入控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在这里你能看到账户余额、用量和模型列表。第二步创建 API Key。进入 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 点新建复制生成的 Key。这个 Key 就是后面要填进 OpenClaw 配置里的凭证注意别泄露也别提交到 git 仓库。第三步确认 Base URL。TaoToken 的 API 地址是 https://taotoken.net/api 注意这个地址不带任何查询参数配置时原样填写即可。模型 ID 按你实际要用的填比如对话类、代码类各有对应名称具体以控制台模型列表为准。如果你不确定该用哪个模型可以先去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 试一句确认 Key 能用、模型有响应再往 OpenClaw 里配。这一步花两分钟能省掉后面大量「到底是 Key 错还是 Skill 错」的排查时间。对于长期跑编码类、Agent 类任务的用户可以考虑 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合持续高频调用场景。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 遇到字段不确定时以文档为准。这里有个关键点要强调OpenClaw 的 Skill 运行环境读取模型配置通常来自环境变量或配置文件。你要做的是把OPENAI_BASE_URL或对应字段指向https://taotoken.net/api把 Key 填进去把模型 ID 填对。三件套齐了Skill 才能跑通。下面进入具体安装。3. 可复制配置ClawHub 源、CLI 安装与 TaoToken 接入片段这一节给你能直接复制的命令和配置片段。先讲 ClawHub CLI 安装再讲本地加载最后把 TaoToken 的配置写进去。ClawHub CLI 的安装官方推荐用 npx 简化命令也可以全局装。国内环境建议先切镜像源再装# 切换 npm 镜像源加速安装 npm config set registry https://registry.npmmirror.com # 全局安装 clawhub npm i -g clawhub # 或者用官方推荐的免安装方式 npx clawhublatest install baidu-search搜索技能有两种方式一是去官网 https://clawhub.ai 搜二是命令行搜# 命令行搜索技能 clawhub search baidu-search # 安装指定技能 clawhub install baidu-search如果你在安装时看到这样的报错✖ Rate limit exceeded (retry in 1s, remaining: 0/30, reset in 1s)这是触发了限流不是你的命令写错了。缓解方式是登录账号但整体体验不稳定所以我不太推荐把 ClawHub CLI 当主力方式用它补装个别技能即可。手动安装适合要改源码或离线部署的场景。把技能包放到工作区技能目录再解压# 进入技能目录 cd /root/.openclaw/workspace/skills/ # 假设已上传 baidu-search.zip unzip baidu-search.zip -d baidu-search/ # 确认目录结构SKILL.md 应在技能根目录 ls baidu-search/SkillHub 是国内用户更稳的选择。先让 OpenClaw 检查并安装商店再装技能提示词可以直接这样说请先检查是否已安装 SkillHub 商店若未安装请根据 https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/skillhub.md 安装 SkillHub 商店然后安装 summarize 技能。 若已安装则直接安装 summarize 技能。接下来是重点把 TaoToken 接进 Skill 运行环境。OpenClaw 的模型配置一般放在环境变量或 settings 文件里。用环境变量的方式可以在启动前导出export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY你的TaoToken Key export OPENAI_MODEL你的模型ID如果你用的是配置文件方式可以写一份 JSON 片段路径按你实际的 OpenClaw 配置目录来放{ model: { base_url: https://taotoken.net/api, api_key: 你的TaoToken Key, model_id: 你的模型ID } }注意三件套必须齐全Base URL 填https://taotoken.net/apiKey 填控制台生成的Model ID 填控制台模型列表里的名称。少任何一个Skill 调用都会失败。如果你用的是 Claude Code 类接入配置字段名可能不同但本质还是这三样参考接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里的字段说明。配置写完后重启 OpenClaw 让环境变量或配置生效。这一步别跳过很多人改完配置没重启然后一直报连不上。4. 验证请求装完 Skill 后怎么确认真的能调用装完不等于能用必须验证。验证分两层先确认模型入口通再确认 Skill 能调起来。第一层直接测 TaoToken 入口。用 curl 发一个最小请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken Key \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: 回复 ok}] }如果返回里有正常的choices字段和内容说明 Key、Base URL、模型 ID 三件套没问题。如果报 401是 Key 问题如果报模型不存在是 Model ID 写错如果连接超时检查网络和 Base URL 是否写成了带路径的错误形式。第二层在 OpenClaw 里验证 Skill。装完技能后去 Web UI 的技能页面看是否列出。以手动安装为例目录结构应该是这样/root/.openclaw/workspace/skills/ └── baidu-search/ ├── SKILL.md └── ...其他脚本然后在对话里直接调用比如用 baidu-search 技能帮我搜一下今天的天气如果技能正常返回结果说明安装和模型接入都通了。如果技能被识别但调用时报模型相关错误回到第一层检查三件套。如果技能根本没出现在列表里检查目录名和SKILL.md是否存在。实测下来最容易出问题的是目录层级放错。技能目录必须直接放在skills/下不能多套一层否则 OpenClaw 扫不到。另一个常见问题是解压后SKILL.md不在根目录而是被包在子文件夹里这种情况把内容上移一层即可。验证通过后建议把配置固化下来别每次手动 export。可以把环境变量写进启动脚本或者写进 OpenClaw 的配置文件这样重启后依然生效。5. 本篇常见错排查401、限流、技能不识别与配置不生效这一节把真实会遇到的报错和对应处理列清楚对照着查。401 未授权通常有三种原因Key 复制时带了空格或换行Key 已失效或被删请求头格式写错。处理方式是重新从 API Keys 页面复制确认Authorization: Bearer后面紧跟 Key中间只有一个空格。限流报错Rate limit exceeded出现在 ClawHub CLI 安装时。这是市场侧的限制不是你本地的问题。缓解方式是错峰重试或者改用 SkillHub、手动安装绕开。别反复快速重试只会让限流更久。技能装了但列表里没有先查目录。正确路径是/root/.openclaw/workspace/skills/技能名/SKILL.md要在技能名目录的根层。如果用了 git clone注意 clone 下来的目录名可能和技能名不一致需要重命名。配置改了但不生效八成是没重启 OpenClaw。环境变量和配置文件都是在启动时读取的改完必须重启进程。另外确认你改的是当前运行实例读取的那份配置多实例部署时容易改错文件。调用时报reading choices相关错误一般是返回体结构不符合预期常见于 Base URL 写错比如多写了/v1或少写了路径。TaoToken 的 Base URL 就是https://taotoken.net/api按这个填具体路径由客户端拼接。OAuth 相关报错多出现在用账号登录方式接入的场景。如果你走的是 Key 方式一般不会遇到如果遇到检查是否误用了需要 OAuth 的接入方式改用 API Key 方式即可。本地代理失败local proxy failed这类报错通常是本机网络或代理配置干扰了请求。检查环境变量里是否有残留的代理设置临时清掉再试unset HTTP_PROXY unset HTTPS_PROXY排查顺序建议固定下来先 curl 测入口再查 OpenClaw 配置三件套再看技能目录最后看是否重启。按这个顺序绝大多数问题五分钟内能定位。6. 把 Skill 装好之后统一入口带来的长期收益Skill 装完只是开始真正省心的是后面长期维护。当你把 TaoToken 作为统一入口接进 OpenClaw 运行环境后所有 Skill 调用模型都走同一个 Base URL 和 Key换模型、查用量、排查问题都只在一个地方操作不用逐个技能去改配置。日常使用建议这样分工常用技能用 SkillHub 装稳定且访问顺畅只在 ClawHub 上有的技能用 CLI 补装遇到限流就换手动方式云服务器部署的用应用管理界面统一维护。模型入口始终指向https://taotoken.net/apiKey 从控制台管理模型 ID 按任务类型选。如果你还在选模型或验证 Key 是否可用先去模型对话页面 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 试一句长期跑编码和 Agent 任务的看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 接入字段不确定就翻文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Key 管理和新建都在 API Keys 页面 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。最后留一个我踩过的坑技能目录里如果有多个版本的SKILL.mdOpenClaw 可能读到旧的那份导致行为和你预期不一致。装完新版本后把旧目录清掉再放新的别直接覆盖避免残留文件干扰。
