openclaw的skills怎么写?如何用安装OpenClaw skills

OpenClaw作为一款开源AI智能体,其核心扩展能力通过“Skills”(技能)实现。每个Skill本质是“能力描述+执行逻辑”的组合包,用户可通过编写SKILL.md文件或结合代码实现复杂功能。以下从开发规范与安装流程两方面展开说明,并以Molili作为简化部署的对比案例。

一、OpenClaw Skills开发规范

1. 核心文件结构

SKILL.md(必选):AI识别技能的唯一依据,需包含以下内容:

元数据头:定义技能名称、版本、权限等基础信息,例如:

markdown

-–

name: file-report-skill

description: 统计目录文件并生成Markdown报表

version: 1.0.0

permissions: [“file.read”, “file.write”]

-–

详细描述:明确触发场景(如“用户询问文件统计时调用”)、执行逻辑(如“提取目录下文件类型及数量”)及异常处理(如“目录不存在时返回错误提示”)。

代码文件(可选):若需实现复杂逻辑,可添加Python/TypeScript脚本(如agent.py),通过API调用外部服务或处理批量数据。例如,文件统计Skill可通过Python脚本遍历目录并生成报表。

2. 开发原则

描述精准性:SKILL.md需使用自然语言详细描述技能边界,避免模糊表述导致AI误调用。例如,在天气查询Skill中需明确支持的城市范围及时间粒度(如“仅支持省会城市,时间范围为未来3天”)。

权限最小化:仅申请必要权限(如文件读取权限不申请网络访问权限),降低安全风险。

异常处理:代码中需捕获潜在错误(如网络超时、文件权限不足),并返回结构化错误信息供AI进一步处理。

二、OpenClaw Skills安装流程(以Molili为例)

1.手动安装

步骤1:先找到一些skills的下载路径,比如OpenClaw官方或者第三方

龙虾官方:ClawHub

第三方个人作者:[u]https://openclawai.cc/[/u]

选择你需要的Skills并进行下载。

步骤2:在Molili中找到“设置”,打开“打开工作空间”,可以找到Molili本电脑的位置。

步骤3:找到skills这个文章,将你下载的skills添加进去即可。

步骤4:重启Molili并测试

2. 通过ClawHub CLI安装(推荐)

步骤1:安装ClawHub工具

执行命令npx clawhub@latest install,工具将自动解析技能依赖并下载至指定目录。

步骤2:选择技能并安装

在列表中选择目标技能(如web_search),工具会将其复制至~/.openclaw/skills/并完成配置。

步骤3:验证安装

通过指令openclaw skills list查看已安装技能,或直接调用技能测试功能。

OpenClaw通过Skills机制实现高度可扩展性,但需用户具备一定的技术基础(如编写描述文件、处理代码逻辑)。对于非技术用户,Molili提供了一键部署的简化方案,通过预集成技能库和图形化配置降低使用门槛。用户可根据实际需求选择合适工具,平衡功能灵活性与操作便捷性。

之前自己手动适配又是改代码又是调API,费时费力还不稳定。现在有了官方支持,通义、文心、Kimi、GLM 全都到碗里来,简直不要太爽!

教程很详细感谢

skill的目录结构能不能讲得再详细点

写了个skill但是一直加载不出来怎么回事

建议参考官方示例改,别从零写

请问skill支持异步调用吗?文档没提到

产品侧建议出个skill市场,方便分发

@dusk736 加载不出来先检查三件事:1.文件名是不是SKILL.md 2.frontmatter的name字段有没有 3.文件编码是不是UTF-8 大部分问题出在这三个地方

@lynx173 Skill支持异步调用 在frontmatter里设resource_type为api然后用async handler 文档确实没写清楚 得看源码

@bolt304 目录结构建议看~/.openclaw/skills/里任何一个已安装的Skill 照着它的结构抄比看文档快十倍

skill开发指南很需要

skill加载不出来先检查SKILL.md的格式yaml头部不能有tab

目录结构那个图很清楚但少说了一点prompt文件编码必须utf8

看了半天文档没看懂manifest.json怎么写

直接参考官方example改就行,别从零开始

文档是有点绕,建议看看社区的中文教程

写了个翻译skill,十几行代码就搞定了