1. 为什么你的 OpenClaw 装了 Skill 却像没装很多人第一次接触 OpenClaw 的 Skill 机制都会经历同一个困惑明明按文档把文件夹丢进去了openclaw doctor也跑了可对话时模型就是不调用那个技能。问题往往不在模型而在 Skill 的安装路径、目录结构、SKILL.md 的 frontmatter 三者中至少有一个没对齐。OpenClaw 的 Skill 本质上是一份写给大模型看的“操作说明书”。它不是一个可执行插件而是一个 Markdown 文件加上若干可选资源Gateway 在组装 System Prompt 时会把 SKILL.md 的正文塞进去模型读到name和description后判断当前任务是否匹配再决定要不要按里面的步骤走。所以 Skill 能不能生效取决于两件事Gateway 有没有扫描到它以及 SKILL.md 写得够不够“让模型一眼看懂什么时候该用”。这篇面向正在用 ClawHub CLI 管理 Skill 的开发者把安装、挂载、编写、自检串成一条可复制的闭环。我会给出 ClawHub CLI 的安装与更新命令、本地挂载的目录规则、一份能直接改的 SKILL.md 骨架以及openclaw doctor报错时的排查顺序。另外Skill 里如果涉及调用外部模型Key 和 API 通道怎么统一管理我会用 TaoToken 做示例避免每个 Skill 各配一套密钥。适合谁看已经跑起 OpenClaw、想扩展自定义能力的人被clawhub install卡住或openclaw doctor报 skill not found 的人以及想写第一个 SKILL.md 但不知道 frontmatter 该填什么的人。2. 前置准备ClawHub CLI 与 TaoToken 通道2.1 安装 ClawHub CLIClawHub 是 OpenClaw 生态里的 Skill 注册中心CLI 负责拉取、更新、同步。前提是本机已经有 Node.js 环境建议 18 以上然后全局安装npm install -g openclaw/clawhub-cli装完验证版本确认命令可用clawhub --version如果提示command not found检查 npm 全局 bin 目录是否在 PATH 里。Windows 下通常是C:\Users\用户名\AppData\Roaming\npmmacOS/Linux 下是/usr/local/bin或~/.npm-global/bin。2.2 为什么 Skill 里要统一 Key 通道写 Skill 时一个绕不开的问题是如果这个 Skill 需要调用大模型比如做摘要、做代码审查Key 从哪来最糟的做法是把 Key 硬编码进 SKILL.md 或脚本里一旦 Skill 被分享出去就泄露了。更稳的做法是让 Skill 通过统一的环境变量读取 API 通道。我习惯用 TaoToken 做这层统一入口它兼容 OpenAI 风格的接口一个 Key 可以给多个 Skill 和工具复用。你可以在控制台创建 Key# 控制台创建 API Key 后写入环境变量 export TAOTOKEN_API_KEYsk-你的key export TAOTOKEN_BASE_URLhttps://taotoken.net/api这样 Skill 的脚本里只引用TAOTOKEN_API_KEY不出现任何明文密钥。模型对话、编码类 Skill 都能走同一个通道换工具时不用重新配一遍。如果你还没建 Key可以先到控制台的 API Keys 页面生成一个再回来继续。3. 可复制配置安装、挂载与 SKILL.md 骨架3.1 用 ClawHub CLI 安装与更新标准安装方式是从注册中心直接拉取命令格式是作者/技能名clawhub install openclaw/agent-browser安装完成后必须重启网关让路由和 System Prompt 重新加载openclaw gateway restart批量更新已安装的 Skillclawhub update --all扫描本地并同步发布更新clawhub sync --all注意clawhub install依赖网络到注册中心如果拉取很慢或超时可以改用下面的本地挂载方式把 Skill 文件夹直接放进工作区效果一样。3.2 本地挂载的目录规则开发自定义 Skill 时直接把文件夹放进 OpenClaw 的工作区即可。路径分两种作用域作用域路径说明全局生效~/.openclaw/skills/所有 Agent 都能用单 Agent 专属~/.openclaw/agents/agentId/skills/只对该 Agent 生效工作区级当前文件夹/skills/随项目走适合团队共享Windows 下如果用 npm 安装内置技能在C:\Users\用户名\AppData\Roaming\npm\node_modules\openclaw\skills这里预装了 clawhub、coding-agent、healthcheck 等几十个内置技能。自定义技能建议放在托管目录C:\Users\用户名\.openclaw\workspace\skillsclawhub 的默认安装目录也在这里。名称冲突时的读取优先级是工作区 Skills 单 Agent 专属 全局。也就是说项目里的同名 Skill 会覆盖全局的。3.3 标准目录结构Gateway 解析 Skill 时真正必读的只有 SKILL.md其余目录都是给脚本和参考资料用的my-skill/ ├── SKILL.md # 必须模型读的就是它 ├── scripts/ # 可选脚本 │ ├── run.py │ └── helper.sh ├── references/ # 可选参考文档 │ └── usage.md ├── assets/ # 可选模板、样例 │ └── template.json └── LICENSE.txt # 可选3.4 一份能直接改的 SKILL.md 骨架frontmatter 里的name和description是模型判断“要不要用这个技能”的唯一依据description 要写清楚触发场景而不是功能罗列。下面这份骨架可以直接复制改名--- name: find-skills description: 当用户问“怎么做 X”“有没有做 X 的技能”“能不能帮我做 X”或表达想扩展 Agent 能力时使用。帮助用户发现并安装可用的 Skill。 --- # Find Skills 这个技能帮助用户从 Skill 生态中发现并安装技能。 ## 何时使用 当用户出现以下情况时触发 - 问“怎么做 X”而 X 可能是已有技能覆盖的常见任务 - 说“找一个做 X 的技能” - 问“你能做 X 吗”而 X 是某种专门能力 - 想搜索工具、模板或工作流 ## 执行步骤 1. 识别领域和具体任务判断是否属于常见场景 2. 用关键词搜索npx skills find [query] 3. 把结果连同安装命令一起呈现给用户 4. 用户确认后执行安装npx skills add owner/reposkill -g -y ## 约束 - 搜索关键词要具体“react testing”优于“testing” - 一次没搜到就换同义词再试 - 找不到时如实告知并建议用户用 npx skills init 自建 ## 失败处理 如果搜索无结果不要编造技能名直接说明未找到并提议用通用能力直接完成任务。这份结构对应了经典写法先声明何时用再定义名词然后分步骤执行最后给约束和失败处理。模型读到“何时使用”和“执行步骤”后匹配到对应意图就会按流程走。4. 验证openclaw doctor 与一次真实调用4.1 用 openclaw doctor 自检把 Skill 放进目录后运行openclaw doctor它会扫描所有 Skill 路径检测并注册新加入的本地技能。正常输出里会列出识别到的技能名和来源路径。如果某个 Skill 没出现说明路径或 frontmatter 有问题往下看第 5 节的排查。4.2 验证 Skill 内的模型调用通道如果 Skill 脚本需要调模型先单独验证 TaoToken 通道是否通curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 ok}] }返回里能看到正常的choices结构就说明 Key 和通道没问题Skill 脚本里可以放心引用同一套环境变量。想先在网页端确认模型可用可以直接用模型对话页面试一句省去配环境的步骤。4.3 触发一次真实调用重启网关后在对话里输入一个能命中 description 的请求比如“帮我找一个做 React 性能优化的技能”。如果 Skill 生效模型会按 SKILL.md 里的步骤先搜索再给安装命令。这一步能跑通说明从安装到自检的闭环完整了。5. 本篇常见错排查5.1 openclaw doctor 不显示新 Skill先确认文件夹名和 frontmatter 里的name是否一致再确认 SKILL.md 是否在文件夹根目录而不是子目录。frontmatter 必须以---开头和结尾中间不能有空行或多余缩进。YAML 里冒号后要有空格name:find-skills这种写法会解析失败。5.2 装了但模型不调用九成是 description 写得太泛。像“处理文档相关任务”这种描述模型无法判断何时触发。改成具体场景把用户可能说的原话写进去比如“当用户要求合并多个 Excel 或生成目录时使用”。description 是给模型看的触发条件不是给人看的功能简介。5.3 clawhub install 卡住或超时注册中心拉取受网络影响较大可以改用本地挂载手动下载 Skill 文件夹放进~/.openclaw/skills/再跑openclaw doctor。功能完全一致只是少了自动更新。5.4 同名 Skill 行为不对检查是否有多个同名 Skill 分布在不同路径。按优先级工作区会覆盖全局。用openclaw doctor的输出确认实际加载的是哪一个把不需要的删掉或改名。5.5 Skill 脚本读不到 Key确认环境变量是在启动 Gateway 的那个 shell 里 export 的。如果 Gateway 是 systemd 或后台服务启动需要在服务配置里注入TAOTOKEN_API_KEY而不是只在当前终端设置。脚本里用os.environ.get(TAOTOKEN_API_KEY)读取不要写死。6. 把 Skill 接入长期工作流单个 Skill 跑通之后下一步通常是把它接进日常编码或 Agent 流程。这时候 Key 和通道的稳定性比单个 Skill 的写法更重要因为多个 Skill 会共享同一套 API 通道。如果你的 Skill 组合偏向长期编码、代码审查、自动化任务可以考虑用 Coding Plan 统一管理额度避免每个 Skill 单独配 Key 导致混乱。接入文档里有完整的鉴权和参数说明写 Skill 脚本前过一遍能省不少调试时间。整个流程走下来核心就三件事路径放对、frontmatter 写准、doctor 跑通。剩下的都是在这三件事上做微调。
企业数字化 ERP 产品动态
相关推荐
网络规划设计师一年考几次新手入门避坑指南 网络规划设计师一年考几次新手入门避坑指南 网站做好了没人访问，这是无数新手入门建站时最扎心的现实。你熬了几个通宵调CSS，买了最贵的服务器，结果打开后台一看，UV（独立访客）是个位数，甚至只有你自己。这时候很多人会想，是不是技术不行？其实不… · 2026/9/27 22:42:39
OpenRouter 完整介绍：用统一 API 网关打通大模型故障转移 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 22:42:33
新手网站设计定价怎么选？3个漏洞让利润减半 新手网站设计定价怎么选？3个漏洞让利润减半 备案流程一头雾水，报价单发出去石沉大海，甚至被客户指着鼻子骂“不专业”。很多刚入行的设计师或前端转行做网站，最头疼的不是代码写不出来，而是 新手网站设计定价… · 2026/9/27 22:42:33
3步搞定SEO零基础入门教程，一文搞懂建站避坑 3步搞定SEO零基础入门教程，一文搞懂建站避坑 改个需求建站公司拖一周，这种憋屈事你是不是也干过？明明只是改个联系邮箱，对方却说要排期、要测试、要上线，一周过去了，页面还是老样子。很多运营和老板都在找【seo零基础入门教程】，想着自己上手，… · 2026/9/28 0:27:11
qq可以做公司免费网站吗?老手对比评测真实落地步骤 qq可以做公司免费网站吗?老手对比评测真实落地步骤 域名和服务器是两座大山，很多设计师刚转行做前端时，一听到“独立部署”就头大。其实，利用QQ生态里的免费资源，真的能低成本甚至零成本搭起一个公司展示站。… · 2026/9/28 0:26:53
简创网站建设费用揭秘：保姆级建站教程避坑指南 简创网站建设费用揭秘：保姆级建站教程避坑指南 很多老板刚接触做网站，第一反应往往是：“这玩意儿到底要多少钱？”结果一打听，报价从两千到两万不等，有的甚至要十几万，瞬间就被绕晕了。更让人头疼的是，除了建站费，还冒出域名、服务器、SSL证书、I… · 2026/9/28 0:26:47
如何免费开个人网站：3步搞定源码下载，告别丑模板 如何免费开个人网站：3步搞定源码下载，告别丑模板 别再被那些千篇一律、配色刺眼的模板网站折磨了。说实话，看着自己精心准备的文案被塞进一个满是“Lorem… · 2026/9/28 0:26:23
2026最新卖建材的网站有哪些？被黑挂马别慌，附实战自查指南 2026最新卖建材的网站有哪些？被黑挂马别慌，附实战自查指南 上周刚帮一个做混凝土外加剂的老板救急。他那站突然跳出博彩广告，后台密码全改，吓得他以为号丢了。其实这就是典型的网站被黑挂马。很多建材老板不懂技术，一旦中招，要么重装系统丢数据，要… · 2026/9/28 0:26:10
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
制作网页比较方便的软件怎么选?一文搞懂避坑指南 制作网页比较方便的软件怎么选?一文搞懂避坑指南 很多老板一上来就问：做个网站多少钱？但我反问他：你的域名买了吗？服务器租了吗？他一脸懵。这就是典型的“域名服务器搞不懂”。别急，今天咱们不聊虚的，直接 一文搞懂 那些让你头秃的技术名词。… · 2026/9/28 0:00:06
婚恋网站实战案例：避开3个高价坑，省钱50%还能跑赢流量 婚恋网站实战案例：避开3个高价坑，省钱50%还能跑赢流量 找婚恋网站建站公司，最怕的就是被坑高价。很多同行跟我吐槽，报价单上写得模棱两可，功能栏里全是“高级定制”、“专属UI”，结果落地全是套壳。今天不聊虚的，直接甩几个我经手的 实战案例… · 2026/9/28 0:00:19
济南做网站多少钱：3个案例拆解，防黑源码下载全攻略 济南做网站多少钱：3个案例拆解，防黑源码下载全攻略 上周济南一个做建材的老板找我，脸都绿了。他的官网首页弹出了赌博广告，后台被植入了挖矿脚本。他慌得问我：“网站被黑挂马不知道怎么办？能不能直接找之前的外包公司要源码下载，看看哪里被动了手脚？… · 2026/9/28 0:00:25
