1. 为什么你的 OpenClaw 装完 Skills 却跑不起来很多人第一次接触 OpenClaw Skills都会经历一个相似的落差照着文档敲完clawhub install终端提示成功重启 Gateway然后在对话里调用技能结果要么是技能列表里根本看不到要么是看到了但一调用就报鉴权失败。问题往往不在 Skills 本身而在于安装通道、配置文件和 API 通道这三件事没有对齐。OpenClaw Skills 本质上是社区贡献的扩展能力包它让 OpenClaw 从“会聊天”变成“能干活”——查天气、做实时搜索、管理 GitHub 仓库、格式化 Markdown都是靠 Skill 挂载进来的。安装后 OpenClaw 下次启动会自动加载但前提是技能目录、openclaw.json配置和底层模型/API 通道三者都正确。适合谁适合已经跑通 OpenClaw 基础对话、准备把 Agent 能力往生产场景推的开发者也适合从旧版本迁移 Skills 的人。我试过在同一个环境里混用 ClawHub CLI 和手动解压两种方式结果技能优先级打架排查了半天。所以这篇不打算只给你命令清单而是把 ClawHub 与 CLI 双通道的安装、配置、验证、排障串成一条能跟做的链路并且把鉴权统一到 TaoToken 的 Key/API 通道上避免你在多个 Key 之间来回切换。核心检索词先明确OpenClaw Skills 是社区扩展功能ClawHub 是官方技能注册表CLI 是安装入口安装与配置的关键在于“装对位置、配对 Key、重启生效”。下面按这个顺序展开。2. TaoToken 前置统一 Key 与 API 通道在装 Skills 之前先把底层通道理顺否则后面每个需要网络的 Skill 都要单独配 Key维护成本极高。TaoToken 在这里的角色是统一鉴权入口你只需要一个 Key就能让 OpenClaw 以及它挂载的 Skills 走同一条 API 通道。先拿到 Key。访问 API Keys 管理页创建https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup创建后你会得到一串以sk-开头的 Key先复制保存。接着确认 Base URLOpenClaw 及 Skills 调用统一走https://taotoken.net/api注意这里不加 UTM 参数保持接口地址干净。如果你需要先验证模型通道是否通可以打开模型对话页做一次最小请求https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup在对话页里选一个模型发一句“ping”能正常返回就说明 Key 和通道没问题。这一步很关键因为后面 Skills 报错时你要能区分是 Skill 本身的问题还是底层通道的问题。对于长期跑编码类或 Agent 类任务的场景建议直接看 Coding Plan它把额度、模型和调用方式打包好了省得你逐个 Skill 配 Keyhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup接入文档在这里遇到参数不确定时对照查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup把 Key 和 Base URL 准备好后再进入 Skills 安装环节。这样后面配置openclaw.json时环境变量直接引用同一套值不用为每个 Skill 单独申请。3. 可复制配置ClawHub 源与 openclaw.json 片段这一节给你可以直接复制的配置。先装 ClawHub CLI它是官方推荐的安装通道支持一键安装、自动更新和版本管理# 使用 npm 安装 npm i -g clawhub # 或使用 pnpm 安装 pnpm add -g clawhub # 验证安装 clawhub --version装完后搜索并安装技能。以天气技能为例# 搜索技能 clawhub search weather # 安装技能 clawhub install weather-now # 安装特定版本 clawhub install weather-now2.1.0如果你要装的是还没发布到 ClawHub 的技能走 OpenClaw CLI 从 GitHub 安装# 安装 OpenClaw CLI npm i -g openclaw # 从 GitHub 安装 openclaw skill install --github https://github.com/openclaw/skills # 从特定分支或标签安装 openclaw skill install --github https://github.com/openclaw/skills --ref v1.0.0手动安装则把技能 ZIP 解压到对应目录注意优先级是工作区 全局 内置全局目录~/.openclaw/skills/skill-name/ 工作区目录workspace/skills/skill-name/接下来是配置。需要 API Key 或环境变量的 Skill统一在~/.openclaw/openclaw.json里配置。下面这段 JSON 把 TaoToken 的 Key 和 Base URL 注入到技能环境变量中路径与原文一致{ skills: { entries: { weather-now: { enabled: true, env: { TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api } }, felo-search: { enabled: true, env: { TAOTOKEN_API_KEY: sk-你的Key, TAOTOKEN_BASE_URL: https://taotoken.net/api } } } } }如果你用的是 TOML 风格的配置或需要 settings 片段可以按同样结构映射[skills.entries.weather-now] enabled true [skills.entries.weather-now.env] TAOTOKEN_API_KEY sk-你的Key TAOTOKEN_BASE_URL https://taotoken.net/api配置里三个要素必须齐全Base URL、Key、Model ID。Model ID 按你实际使用的模型填写比如在 Coding Plan 里选定的模型标识。缺任何一个Skill 调用时都会在鉴权或路由阶段失败。4. 验证请求从 skills list 到真实调用配置写完不代表生效必须走一遍验证。第一步看已安装且可用的技能openclaw skills list --eligible这条命令只列出满足依赖、配置完整、可以加载的技能。如果某个技能装了但没出现在这里说明它缺配置或依赖没满足。第二步看单个技能详情openclaw skills info weather-now输出里会显示技能路径、版本、启用状态和所需环境变量。对照检查TAOTOKEN_API_KEY和TAOTOKEN_BASE_URL是否被正确读取。第三步重启 Gateway 服务让配置生效openclaw gateway restart重启后做一次真实调用。在 OpenClaw 对话里触发技能比如问“北京今天天气怎么样”观察返回。成功的话你会看到技能被调用并返回结构化结果。如果失败先看 Gateway 日志openclaw gateway logs --tail 100日志里如果出现401说明 Key 无效或没被读取出现local proxy failed说明 Base URL 或网络通道有问题出现reading choices相关报错通常是模型返回结构不符合预期检查 Model ID 是否填对。验证通过后建议把这次成功的配置备份一份迁移环境时直接复用省得重新排查。5. 常见报错排查401、local proxy failed、reading choices排障的核心是分清错误发生在哪一层。下面按真实报错逐条对照。401 Unauthorized最常见。原因通常是openclaw.json里的 Key 写错、Key 已失效或者环境变量名和技能期望的不一致。检查步骤确认 Key 以sk-开头且无多余空格确认env字段里的变量名与技能文档要求一致重启 Gateway 后再试。如果用的是 Coding Plan确认额度未耗尽。local proxy failed这个报错指向通道层。检查TAOTOKEN_BASE_URL是否写成https://taotoken.net/api注意不要多加路径或参数。同时确认本机网络能正常访问该地址可以用 curl 做最小验证curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:你的Model ID,messages:[{role:user,content:ping}]}能返回正常 JSON 就说明通道没问题问题在 OpenClaw 配置侧。reading choices或类似解析报错通常是模型返回结构与技能预期不匹配。检查 Model ID 是否填成了不支持该技能调用格式的模型确认技能版本与 OpenClaw 版本兼容必要时回滚到技能的历史版本clawhub install weather-now2.1.0OAuth 相关报错部分技能如 GitHub 集成需要 OAuth 授权。这类技能除了 Key还要完成授权流程。检查技能文档里的授权步骤确认回调地址和权限范围正确。如果技能同时支持 API Key 和 OAuth优先用 Key 方式配置更简单。技能装了但列表里看不到检查安装目录优先级。工作区目录会覆盖全局目录如果同名技能在两处都存在实际生效的是工作区版本。用openclaw skills info确认实际加载路径。排查时记住一个顺序先确认通道curl 能通再确认配置env 被读取最后确认技能本身版本兼容。按这个顺序走大部分问题能在十分钟内定位。6. 把 Skills 接入你的日常工作流装好 Skills 只是起点真正省时间的是把它接进日常流程。我的做法是把高频技能固定在工作区目录低频或实验性的放全局目录这样不同项目之间互不干扰。需要迁移时直接复制工作区的skills目录和openclaw.json里的对应片段即可。对于需要长期跑编码或 Agent 任务的场景建议把 Key 和额度统一到 Coding Plan 管理避免每个 Skill 单独配 Key 导致的混乱https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup需要新建或轮换 Key 时回到 API Keys 页操作https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup参数不确定就查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_skills_setup最后提醒一句安装高风险技能能执行系统命令或访问文件系统前先看它的 SKILL.md 和源码确认行为符合预期再启用。低风险技能可以放心装中等风险的需要 API Key 的技能按本文的配置方式统一走 TaoToken 通道即可。
