1. 先把技能装进 openclaw两种原始路径都不能省把技能包拖进 openclaw 的 skills 目录重启 gateway 后技能却卡在“等待模型响应”——这是很多人在 openclaw 跑新技能时遇到的第一道坎。技能本身没问题问题是 openclaw 要把你的请求发给大模型而原 Key 的额度或网络通道并不牢靠。这时候把模型通道切到 TaoToken在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 Key 后配置就能跑通。但先别急技能文件必须先正确落盘所以原文里那两条装技能的路我们一条条走。1.1 让 openclaw 自己从 hub 抓技能包原文说的第一种方式最省事直接在 openclaw 的对话流里告诉它去技能市场里找某个技能并装上。相当于你并不需要知道技能包长什么样openclaw 会代替你完成“搜索、下载、解压、放目录”这一整套动作。具体在你自己的 openclaw 版本里触发方式可能叫 add-skill、install skill 或者直接自然语言描述你要的技能名。找不到入口时看一眼 openclaw 界面上的提示多数版本会在输入框里给出命令前缀。装完之后openclaw 会告诉你“技能已加入 xx 目录”这时技能已经被放进了 skills 文件夹跟手动安装的结果没有区别。这一步对后续配置 Key 没有任何影响你不需要记住技能包的实际内容。1.2 为什么“自动装好”不等于“马上能跑”很多人在这一步误以为技能装好就等于万事大吉。实际上 openclaw 的技能加载过程分成两段第一段是技能文件进目录第二段是调用技能时向大模型发起请求。自动安装只完成了第一段。第二段启动时openclaw 会读取当前配置的模型 Key 和接口地址用它们把技能里的提示词和工作流“喂”给模型。如果你的原 Key 是某个工具的测试额度、或者已经欠费技能大概率在对话里转几圈然后报 401。这时候别急着删技能文件问题不在技能而在模型通道。这也就是为什么本文要把 TaoToken 接到 openclaw 的模型配置上。先继续把手动装技能走完我们最后统一切通道。2. 手动解压技能包clawhub.ai 的压缩包怎么落地2.1 没有 skills 目录就新建有则打开原文第二种方式更直观也更好排查问题自己动手把技能包放进 skills 目录。打开 openclaw 的配置目录找一下里面有没有 skills 这个文件夹。没有就新建有就直接打开。Linux/macOS 下的目录名是~/.openclaw/skills/Windows 下通常在用户目录的.openclaw\skills\不管你的版本怎么命名找到“技能目录”这一层就行。# 先确认 openclaw 配置目录里有没有 skills ls ~/.openclaw/ # 没有就直接建一个 mkdir -p ~/.openclaw/skills注意这个目录名必须叫 skills。拼成 skill、skills-old、my-skills 都会让 openclaw 认不出来等于白放。如果你之前把技能放在别的地方并手动指定过路径那另说对绝大多数默认安装来说skills 这个名字就是唯一约定。2.2 解压 clawhub.ai 下载的压缩包技能来源是技能市场在这个场景下就是原文提到的 clawhub.ai。你在上面找到需要的技能后下载下来的通常是一个压缩包。打开压缩包先确认里面是不是直接带着技能文件夹。有些压缩包解压后只有散落的文件那样 openclaw 识别不到你必须把它们收进一个独立文件夹再放进 skills 目录。# 把下载好的压缩包解压到临时目录 unzip ~/Downloads/some-skill.zip -d ~/Downloads/some-skill-tmp # 确认解压后的结构再整个文件夹放进 skills mv ~/Downloads/some-skill-tmp ~/.openclaw/skills/判断技能是否被识别看文件夹内部是否有一个技能清单文件比如 .md 或 .json具体后缀因技能而异。没有这个清单openclaw 会直接跳过该目录。这也是“装了却看不到技能”最常见的文件层原因跟 Key 无关。3. 跑新技能前把模型 Key 切到 TaoToken3.1 技能装好只代表加载成功真正调用还得靠模型技能只是在 openclaw 里定义了一套“怎么做”的流程真正执行这套流程的时候openclaw 需要把技能里的指令、变量、上下文一起发给大模型去规划和生成结果。换句话说openclaw 是大脑皮层的调度器大模型才是算力核心。没有可用的模型通道技能装再多也只是一堆静态文件。原 Key 的问题通常是这几类组织级 Key 额度被同事跑完、个人 Key 有地区限制、或者用了某个平台送的体验额度但已经过期。与其去挨个查是哪个环节断了不如直接把 openclaw 的模型供应商整体切到 TaoToken 这个统一接入通道上让所有技能请求都走同一个稳定入口。3.2 去官网创建 Key先别急着填进工具打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册登录后在控制台里创建 API Key。创建完成后会得到一长串字符复制出来记好。这里要特别提醒官网地址和接口地址是两回事官网只负责注册、创建 Key、看用量、看模型广场真正填进 openclaw 的接口地址是 https://taotoken.net/api末尾没有 /v1也不带任何追踪参数。摘出来单独看一眼两个地址的分工用途地址注册 / 创建 Key / 查看模型广场https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endopenclaw 模型配置里的 Base URLhttps://taotoken.net/apiKey 拿到手后就是以YOUR_API_KEY为代表的占位符下面所有配置里都先用它代替等配置完成后你再把自己的真实 Key 粘贴进去。3.3 openclaw 模型配置里填 Base URL 和 Key打开 openclaw 的设置面板找到模型供应商或模型配置入口。不同版本里这个入口可能叫 Providers、Models 或直接叫 Settings字段基本一致。新增一个自定义供应商把上文表格里的接口地址填进去。下面是配置项的文本形态你照着字段录入即可不用管它底层是不是 JSON。Base URL: https://taotoken.net/api API Key: YOUR_API_KEY Model ID: 以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场为准这里最容易翻车的是 Model ID。很多教程喜欢直接写一个具体模型名但你自己的技能对模型的兼容性版本是有要求的最稳妥的办法是在模型广场页面上看当前网关支持哪几个 ID再挑一个与你技能描述里约定一致的。宁可多花三十秒确认也不要随便填一个记忆里的名字进去。3.4 为什么 Base URL 不能带 /v1TaoToken 的接口入口是 https://taotoken.net/api这个路径已经是完整的接入点。如果你在后面补上 /v1openclaw 会把请求发到 https://taotoken.net/api/v1网关会直接返回 404。同样的道理也不要在 Base URL 末尾加问号参数、加斜杠。它就跟快递收件地址一样多写一个单元号都可能导致投递失败。另外有些工具会自动在你填写的 Base URL 后面拼 /v1openclaw 不会。所以你填什么它就发什么。这也是为什么配置完以后必须先实测一次而不是看着设置面板点点头就关掉。4. 重启 gateway 并跑一次新技能4.1 让配置生效的唯一一步openclaw 的技能列表在启动时读取模型供应商配置也在启动时载入内存。改完配置不重启openclaw 还拿着旧 Key 和旧接口在跑自然不生效。原文里给的重启命令就是标准动作openclaw gateway restart执行完以后等几秒钟让服务完成初始化。如果你的 openclaw 是前台跑的重启后终端会重新打一遍启动日志如果是后台服务方式用 openclaw status 看一眼状态。只有 gateway 回到 running 状态配置才算真正加载。4.2 跑一次新技能验证通道重启后随便选一个刚才装好的技能在 openclaw 对话里发出一个最简单的指令让它完整走一遍技能流程。观察两点技能是否被正确识别并进入执行流程执行过程中是否正常返回结果而不是卡在请求阶段。如果技能正常返回内容说明文件层和模型层都通了。此时打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台的用量页面你应该能看到刚才那一次调用的记录。看到记录这件事才算闭环。注意是官网用量页不是 openclaw 日志官网记录的是你通过 TaoToken 通道消耗的真实调用次数。5. 遇到 401 或超时按这两条排查5.1 401 UnauthorizedKey 没被正确读取技能报 401几乎可以断定是 Key 的问题。先把 openclaw 设置面板里的 YYY_API_KEY 字段打开看真实 Key 的头部几个字符是不是跟你从官网复制的一致。最常见的低级错误是复制的时候多带了一个空格或者把 Key 粘进了 Model ID 的输入框。还有一种隐蔽情况你在系统环境变量里也设置过同名 Key而 openclaw 优先读了环境变量里的旧值。核对方法很简单临时把环境变量清掉再重启一次 gateway 看是否恢复正常。5.2 超时或 404接口地址写偏了请求超时不全是网络问题更常见的是接口地址多写了 /v1或者把 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 整个粘进了 Base URL。记住那个分工原则带 utm_source 的地址是给人点的https://taotoken.net/api 才是给机器填的。改回正确地址后再执行一次 openclaw gateway restart。如果还是超时检查一下当前网络是否能正常访问该接口可以用 curl 做一个最小连通性测试确认服务端通不通。6. 让这次调用在用量页里留下记录切到 TaoToken 不是换一下配置就结束真正需要确认的是 openclaw 的技能请求确实通过了网关。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 的用量页面找到刚刚那次调用对应的记录。记录里能看到模型 ID、调用时间、Token 消耗。如果这里空荡荡说明 openclaw 还在走旧配置回到第 4 节重新执行 gateway restart然后再次调用技能。如果用量页有记录但技能返回还是报错那就进入排障部分按 401 或超时的分支逐项核对 Key 与 Base URL。我做这件事的时候习惯把上面那张表格截下来放在 openclaw 设置面板旁边每次填配置都对着它看一遍到目前为止还没有第二次填错过。