1. 为什么 Skills 装完总是调不通很多人第一次接触 OpenClaw Skills卡住的地方往往不是“不会装”而是装完之后发现 Agent 根本调不动。我见过最常见的三种情况本地把技能文件夹丢进目录openclaw skills list能看到名字但一执行就报依赖缺失用 ClawHub 装好了结果模型请求走的是默认通道延迟高还偶尔超时命令行里clawhub install成功重启网关后技能却显示disabled。这些问题的根子不在 Skills 本身而在于安装路径和 API 通道是两件事。Skills 决定 Agent 能做什么API 通道决定它调用模型时走哪条路。本地安装、ClawHub 安装、命令行安装这三种方式在文件落盘位置、依赖解析、网关加载时机上都有差异如果不把 Key 和 Base URL 统一到一条稳定通道上装得再对也会在调用环节翻车。这篇就按“本地 / ClawHub / 命令行”三条路径拆开讲每条路径都给到可复制的settings.json和config.toml骨架并且统一把模型请求指向 TaoToken 的 API 通道。这样不管你用哪种方式装 Skills验证动作都是一致的装完 → 配通道 → 发一次真实请求 → 看返回。适合谁看已经在用 OpenClaw 或类似 Agent 框架、需要把 Skills 接入统一 Key 管理的开发者以及刚装完 Skills 发现调不通、想排查是安装问题还是通道问题的同学。2. 装 Skills 之前先把 TaoToken 通道配好Skills 的安装和模型通道的配置是解耦的但顺序建议反过来先配通道再装 Skills。原因是很多 Skills 在安装后的自检阶段就会发一次模型请求比如 skill-vetter 做安全审查如果通道没配好你会误以为是技能装坏了。TaoToken 在这里的角色是统一入口你不需要在每一个 Skill 里单独填 Key而是把 Base URL 和 API Key 写在 OpenClaw 的全局配置里所有 Skills 共享同一条通道。这样本地安装、ClawHub 安装、命令行安装三种方式装出来的技能调用时走的是同一个出口。先拿 Key。打开控制台创建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentskills-install-guideutm_campaignrewrite创建后复制那串sk-开头的 Key后面配置里会用到。注意 Key 只在创建时完整显示一次建议先存到密码管理器。Base URL 统一用https://taotoken.net/api这个地址不加任何查询参数直接作为 OpenAI 兼容协议的base_url使用。如果你用的是 Anthropic 协议风格的客户端接入文档里有对应的路径说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentskills-install-guideutm_campaignrewrite配通道的时候有个细节容易踩OpenClaw 的配置分两层一层是网关级config.toml一层是技能级settings.json。网关级决定默认走哪条通道技能级可以覆盖。建议只在网关级配一次技能级留空继承否则后面装新 Skill 时容易漏配。3. 三种安装路径的可复制配置3.1 本地安装文件落盘 settings.json 骨架本地安装适合自己写的 Skill 或从 Git 仓库拉下来的源码。核心动作是把技能目录放到工作区然后让网关重新加载。Linux / Mac 路径mkdir -p ~/.openclaw/workspace/skills cd ~/.openclaw/workspace/skills git clone https://github.com/yourname/your-skill.git ./your-skillWindows 路径对应New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.openclaw\workspace\skills cd $env:USERPROFILE\.openclaw\workspace\skills git clone https://github.com/yourname/your-skill.git .\your-skill放好之后技能目录里通常需要一个settings.json来描述入口和依赖。最小骨架长这样{ name: your-skill, version: 1.0.0, entry: index.js, runtime: node, env: { OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: ${TAOTOKEN_API_KEY} }, dependencies: [] }这里的关键是env段把OPENAI_BASE_URL指向 TaoTokenKey 用环境变量占位不要硬编码进文件。然后在网关级config.toml里注入真实 Key[gateway] workspace ~/.openclaw/workspace restart_on_change true [model] provider openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model gpt-4o-mini [skills] auto_load true paths [~/.openclaw/workspace/skills]环境变量在启动网关前导出export TAOTOKEN_API_KEYsk-你的Key openclaw gateway restart本地安装最容易出问题的是路径含中文或空格。~/.openclaw/workspace/skills这条路径保持纯英文技能文件夹名也别用中文否则加载阶段会静默失败——list里看不到日志里也不一定报错。3.2 ClawHub 安装商店拉取 版本管理ClawHub 是官方技能商店客户端适合装公开技能。先全局装 CLInpm i -g clawhub clawhub --version搜索和安装clawhub search search clawhub install tavily-search clawhub install tavily-search --version 1.2.0 clawhub listClawHub 装出来的技能会落到它自己的缓存目录再由网关软链或复制到工作区。这一步的配置差异在于ClawHub 安装的技能默认继承网关级通道所以config.toml里的[model]段必须配好否则技能装完调用时会走默认公网地址。如果你希望某个 ClawHub 技能走单独的通道比如测试用可以在技能目录下加一个覆盖用的settings.json{ name: tavily-search, inherit_gateway: false, env: { OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: ${TAOTOKEN_API_KEY} } }inherit_gateway: false表示不继承网关默认走自己这份。多数情况下不需要这么干保持继承最省心。更新和批量维护clawhub update --all clawhub install skill-vetter装完记得重启网关ClawHub 的变更不会自动热加载openclaw gateway restart openclaw skills list3.3 命令行安装脚本化 批量验证命令行安装本质是把前面两步脚本化适合 CI 或需要批量部署的场景。核心是把安装、配置、验证串成一条命令链。#!/usr/bin/env bash set -euo pipefail export TAOTOKEN_API_KEY${TAOTOKEN_API_KEY:?请先设置 TAOTOKEN_API_KEY} # 1. 确保 CLI 存在 command -v clawhub /dev/null 21 || npm i -g clawhub # 2. 批量安装 for skill in tavily-search skill-vetter; do clawhub install $skill --force done # 3. 重启网关 openclaw gateway restart # 4. 列出可用技能 openclaw skills list --eligible命令行场景下的config.toml和本地安装一致区别在于你可以用环境变量覆盖[model] provider openai-compatible base_url ${TAOTOKEN_BASE_URL} api_key_env TAOTOKEN_API_KEY default_model gpt-4o-mini启动时export TAOTOKEN_BASE_URLhttps://taotoken.net/api export TAOTOKEN_API_KEYsk-你的Key openclaw gateway restart命令行安装的坑主要在--force的滥用它会覆盖已有配置如果你之前手动改过某个技能的settings.json--force会把它冲掉。批量脚本里建议先clawhub list记录现状再决定要不要强制覆盖。4. 验证请求三种路径装完都跑这一套不管用哪种方式装验证动作统一。先确认技能被识别openclaw skills list openclaw skills list --eligible openclaw skills info tavily-search--eligible只显示依赖满足、可以启用的技能。如果某个技能在list里有、在--eligible里没有说明依赖没装齐跟通道无关。然后启用并重启openclaw skills enable tavily-search openclaw gateway restart最后发一次真实请求验证通道是否通。用 curl 直接打 TaoToken 的接口curl -s https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: ping}] }返回里能看到choices字段和内容说明通道正常。如果这里就报 401那是 Key 问题报 404检查 Base URL 是不是写成了带路径的地址超时检查网络出口。通道通了之后再让 Agent 实际调一次技能。在对话里输入请用 tavily-search 技能搜索 OpenClaw skills 安装如果技能返回了搜索结果说明安装 通道 调用整条链路都通了。想单独验证模型对话是否正常可以用模型对话入口发一条https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentskills-install-guideutm_campaignrewrite5. 本篇常见错排查报错一skills list为空但文件夹确实存在。九成是路径问题。检查config.toml里的paths是否指向了正确的工作区以及技能文件夹名是否含中文或空格。另外确认auto_load true否则需要手动openclaw skills enable。报错二技能显示disabledenable 后重启又变回 disabled。通常是依赖缺失。跑openclaw skills info 技能名看依赖项缺 Node 模块就补npm install缺系统命令就装对应工具。依赖不满足时网关会在重启后自动禁用该技能。报错三调用技能时报 401 或invalid api key。Key 没注入到网关进程。export的环境变量只对当前 shell 有效如果你用 systemd 或 pm2 托管网关需要在服务配置里单独声明环境变量。检查方式是openclaw gateway status看进程环境。报错四ClawHub 安装超时或下载慢。换 npm 镜像npm config set registry https://registry.npmmirror.com然后重试clawhub install。注意镜像只影响 CLI 自身的包下载技能内容还是从 ClawHub 源拉取。报错五本地安装的技能能 list 到但调用时找不到入口。检查settings.json里的entry字段是否指向真实存在的文件以及runtime是否和文件类型匹配。Node 技能用index.jsPython 技能用main.py写错会导致加载失败。报错六改了config.toml但没生效。网关不会自动重载配置必须openclaw gateway restart。如果你在config.toml里设了restart_on_change true那只有工作区文件变更会触发重启配置文件本身变更仍需手动重启。排查顺序建议固定成list→info→enable→restart→ curl 测通道 → 对话测技能。这样能快速定位是安装层、配置层还是通道层的问题。6. 长期跑 Skills通道和 Key 怎么管三种安装方式解决的是“技能怎么进来”但技能跑起来之后真正影响体验的是通道稳定性和 Key 管理。如果你只是偶尔试几个技能网关级配一次 TaoToken 就够了但如果你要长期跑编码类、Agent 类技能建议把 Key 和通道做成可切换的配置。需要长期编码或跑 Agent 的场景可以看下 Coding Plan 的额度方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentskills-install-guideutm_campaignrewrite接入细节和协议差异都在文档里配config.toml时对着改base_url和provider字段即可https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentskills-install-guideutm_campaignrewrite我自己的做法是把TAOTOKEN_API_KEY放在系统的密钥管理里config.toml只引用环境变量名这样换 Key 不用改配置文件重启网关就生效。技能目录单独用 Git 管理settings.json里不出现任何明文 Key团队协作时也不会泄露。最后提醒一个实操细节每次clawhub update --all之后先跑一遍openclaw skills list --eligible确认没有技能因为依赖变更掉出可用列表再重启网关。这一步能挡掉大部分“更新完就调不通”的情况。