OpenClaw 自定义技能（Skill）完整开发教程

关注

VIP免费原创最新推荐文章于 2026-08-04 14:10:35 发布 711 阅读 AI 写同款· GEO 优化 ›

OpenClaw 技能开发指南：从零创建自定义 Skill 简单说，Skill 就是把 AI 的某种能力打包成独立模块触发条件：什么情况下应该使用这个技能执行逻辑：具体要做什么操作（调用哪些工具）输出规范：结果应该如何呈现✅自动识别用户需求，匹配对应技能✅标准化执行，每次都用同样的流程✅能力复用，一次开发，多次使用✅工具集成，无缝调用文件、浏览器、API 等。阅读详情

一、前置基础认知
1. 什么是 Skill 技能
Skill 是 OpenClawSkills 技能层的最小可插拔单元，是 AI 真正操作电脑、调用接口、处理文件的执行载体。
四层架构对应关系：

Gateway接收指令 → Agent判断需求 → 匹配自定义Skill执行 → Memory存储结果

所有本地文件读写、接口请求、脚本运行、业务自动化都依靠自定义 Skill 实现，分为两类：

轻量文档型 Skill（SKILL.md）：无需代码，仅写自然语言执行脚本，新手快速搭建简单自动化；
代码插件型 Skill（JS/TS/Python）：复杂业务、API 对接、批量文件处理、企业私有系统对接，支持完整逻辑、参数校验、权限管控。

2. 技能标准目录结构（固定规范）
所有自定义技能统一存放路径：
Windows(WSL2) / Linux / macOS：~/.openclaw/workspace/skills/
单个技能文件夹完整结构：

my-office-stat/ # 技能唯一名称（小写、连字符，不能中文）

├── SKILL.md # 【必需】技能元数据+功能描述，AI识别调用的核心

├── manifest.json # 【代码型必需】权限、参数、运行环境声明

├── index.js / index.ts # 【代码型必需】主执行逻辑入口

├── scripts/ # 可选：存放bash/python辅助脚本

├── assets/ # 可选：报表模板、静态资源

└── references/ # 可选：API文档、业务参考资料

二、开发前置环境准备

已完整部署 OpenClaw，网关正常运行

openclaw gateway start -d
openclaw status

开发依赖（二选一）
·JS/TS 开发（官方推荐）：Node.js 22 LTS，内置openclaw-sdk无需额外安装
·Python 开发：Python3.10+，在 manifest 声明 runtime 为python
基础命令：技能目录热加载，修改文件无需重启网关，系统自动监听变更
三、方案 1：零代码轻量技能（SKILL.md，新手入门）
适合简单自动化：文件整理、简易 shell 脚本、固定重复流程，不用编写 JS 代码。

步骤 1：创建技能文件夹

# 创建文本批量处理技能
mkdir -p ~/.openclaw/workspace/skills/text-batch-handle
cd ~/.openclaw/workspace/skills/text-batch-handle

步骤 2：编写 SKILL.md（核心文件）
文件顶部---包裹 YAML 元数据，下方写 Markdown 功能说明与执行逻辑。

---

name: text-batch-handle

description: 批量处理本地文本文件，支持去重、大小写转换、关键词提取，当用户需要批量处理txt文档时自动调用

emoji: "📝"

user-invocable: true

alway

最低0.47元/天解锁文章

标签

#openclaw #人工智能 #技能开发 #个人开发

OpenClaw安装技能（skill） OpenClaw 的核心竞争力，不在于模型参数，而在于生态与技能（skill）组合能力。当你把各种skill整合到一起时，你获得的已经不只是一个 AI 工具，而是一个可以执行真实任务的智能工作系统。阅读详情

OpenClaw 自定义技能（Skill）完整开发教程

二、开发前置环境准备

相关推荐