乐于分享
好东西不私藏

OpenClaw 技能开发入门:3 小时写一个能帮你干活的 AI 助手

OpenClaw 技能开发入门:3 小时写一个能帮你干活的 AI 助手
OpenClaw 技能开发入门:3 小时写一个能帮你干活的 AI 助手

不是教程,是朋友之间的经验分享。不追求完美,追求能跑起来。


一、为什么我要写这个?

说实话,写这篇文章之前我犹豫了很久。
最近这一个月,我一直在用 OpenClaw + Claude 干活。效率提升不是一点半点——文件自动整理、数据批量处理、网页信息抓取,这些以前要花几小时的事,现在跟 AI 说一句话就搞定了。
但每次在群里分享,总有人问我:

"听起来很爽,但技能开发是不是很难?我没编程基础能行吗?"

"配置环境就要搞一天吧?"

"有没有现成的模板可以抄?"

问的人多了,我就想:要不我把自己踩过的坑都记下来,写一篇谁都能看懂的入门指南?
所以有了这篇文章。
我的承诺很简单: - 不装专家,我也是刚入门 - 不跳步骤,代码逐行解释 - 不画大饼,3 小时真的能跑起来
先说结论:技能开发没你想的那么复杂。有高中编程基础就能上手,没有?边查边学也能搞定。

二、OpenClaw 到底是啥?

先别急着看代码,咱们先把概念捋清楚。
一句话解释
OpenClaw 是一个能让你用自然语言指挥 AI 干活的框架。
类比理解
想象一下,你有一个超级聪明的实习生(AI 大模型),他什么道理都懂,但有个问题——他没有手和脚
他知道怎么整理文件,但打不开你的文件夹
他知道怎么查天气,但上不了网
他知道怎么发邮件,但登不上你的邮箱
OpenClaw 就是给这个实习生装上了"手脚"。通过"技能"(Skill)这个机制,告诉 AI:

"当用户说 XXX 的时候,你可以用 YYY 工具去做 ZZZ 的事"

技能是什么?
技能 = 触发条件 + 工具调用 + 结果输出
举个例子,我写了一个"文件整理技能":
组件
说明
触发条件
用户说"整理下载文件夹"
工具调用
读取文件夹 → 按类型分类 → 移动到对应目录
结果输出
"已整理 35 个文件,图片 12 个、文档 8 个、压缩包 15 个"

三、准备工作:这些东西你得有

别被"开发"两个字吓到,准备工作其实很简单。
环境要求
# 1. Node.js(v18 以上) node -v  查看版本,没有的话去 nodejs.org 下载 # 2. Git(用于克隆项目) git --version  # 大部分电脑自带  # 3. 一个能跑代码的地方 # 可以是你的本地电脑,也可以是云服务器 
账号准备
用云端 API - Claude API / OpenAI API / 千问 API / 豆包API等 - 需要充值,但智能程度更高 - 我用的 Claude,每个月大概几十块钱
时间预算
我特意计时了:
步骤
预计时间
环境配置
30 分钟
写 SKILL.md
30 分钟
写核心代码
60 分钟
测试调试
40 分钟
合计约 3 小时
心理建设
这句话请你一定记住:

允许自己犯错,踩坑是学习的一部分。

我写第一个技能的时候,光是环境配置就搞了 2 小时。代码报错?太正常了。我会在后面把我的踩坑记录都写出来。

四、核心教程:手把手写第一个技能

咱们要写的技能很简单:自动整理下载文件夹
功能描述: - 读取指定文件夹 - 按文件类型分类(图片、文档、压缩包等) - 移动到对应的子文件夹 - 输出整理报告
4.1 第一步:创建技能目录结构(20 分钟)
在你的 workspace 下创建一个新文件夹:
cd ~/.openclaw/workspace/skills mkdir file-organizer cd file-organizer 
创建以下文件结构:
file-organizer/  ├── SKILL.md      技能说明文件 ├── index.js      # 主逻辑  └── package.json  # 依赖配置 
创建 package.json
{"name": "file-organizer",   "version": "1.0.0",   "description": "自动整理下载文件夹的 AI 技能",   "main": "index.js",   "dependencies": {             "fs": "^0.0.1-security",             "path": "^0.12.7"           } } 
安装依赖:
npm install 
4.2 第二步:写 SKILL.md(30 分钟)
这是技能的"身份证",告诉 OpenClaw 什么时候调用这个技能。
# File Organizer Skill  #触发条件 当用户提到以下关键词时触发此技能: - 整理文件夹 - 整理下载目录 - 文件分类 - 清理下载文件夹  ## 输入参数 - folderPath: 要整理的文件夹路径(可选,默认为~/Downloads)  ## 输出结果 - 整理报告:各类文件数量及移动位置  ## 使用示例 用户:帮我整理一下下载文件夹 AI:好的,正在整理 ~/Downloads 文件夹... 
关键点: - 触发条件要写得具体,但也要覆盖常见说法 - 参数要有默认值,降低使用门槛 - 示例要真实,用户会直接照着说
4.3 第三步:写核心逻辑(60 分钟)
这是最核心的部分,咱们逐行解释。
// index.js  const fs = require('fs'); const path = require('path');  // 文件类型映射表 const FILE_TYPE_MAP = {               image: ['.jpg''.jpeg''.png''.gif''.webp''.svg'],            document: ['.pdf''.doc''.docx''.xls''.xlsx''.ppt''.pptx''.txt''.md'],           archive: ['.zip''.rar''.7z''.tar''.gz'],          video: ['.mp4''.avi''.mov''.mkv''.flv'],           audio: ['.mp3''.wav''.flac''.aac'],           installer: ['.exe''.dmg''.pkg''.deb'          };  // 主函数:整理文件夹 async function organizeFolder(folderPath) {         // 1. 验证路径是否存在         if (!fs.existsSync(folderPath)) {               throw new Error(`文件夹不存在:${folderPath}`);             }          // 2. 读取文件夹内容         const files = fs.readdirSync(folderPath);       // 3. 统计结果         const stats = {               total0,               byType: {},               errors: []             };          // 4. 遍历文件         for (const file of files) {            // 跳过隐藏文件和目录             if (file.startsWith('.')) continue;              const filePath = path.join(folderPath, file);              // 只处理文件,跳过子文件夹             if (!fs.statSync(filePath).isFile()) continue;              stats.total++;              // 5. 判断文件类型             const ext = path.extname(file).toLowerCase();             let fileType = 'other';              for (const [type, extensions] of Object.entries(FILE_TYPE_MAP)) {               if (extensions.includes(ext)) {                     fileType = type;                     break;                   }             }              // 6. 创建目标文件夹并移动文件             try {                   const targetDir = path.join(folderPath, fileType);                     if (!fs.existsSync(targetDir)) {                           fs.mkdirSync(targetDir, { recursivetrue });                         }                    const targetPath = path.join(targetDir, file);                // 如果目标文件已存在,添加时间戳                   let finalPath = targetPath;                   let counter = 1;                   while (fs.existsSync(finalPath)) {                     const name = path.basename(file, ext);                     finalPath = path.join(targetDir, `${name}_${counter}${ext}`);                     counter++;                   }                    fs.renameSync(filePath, finalPath);                    // 统计                   stats.byType[fileType] = (stats.byType[fileType] || 0) + 1;                  }             catch (error) {                     stats.errors.push({ file, error: error.message });                   }               }           return stats;        }         // 生成报告        function generateReport(stats         {   let report = `✅ 整理完成!\n\n`;            report += `📊 共处理 ${stats.total} 个文件\n\n`;            report += `📁 分类结果:\n`;             for (const [type, count] of Object.entries(stats.byType)) {              const emoji = {                image'🖼️',                document'📄',                archive'📦',                video'🎬',                audio'🎵',                installer'📥',                other'📎'              }[type];               report += `  ${emoji}${type}${count} 个\n`;   }             if (stats.errors.length > 0) {              report += `\n⚠️ 有 ${stats.errors.length} 个文件处理失败\n`;            }             return report; }           // 导出给 OpenClaw 调用          module.exports = {            name'file-organizer',            description'自动整理文件夹,按文件类型分类',            executeasync (params) => {              const folderPath = params.folderPath || path.join(require('os').homedir(), 'Downloads');               console.log(`🔍 开始整理:${folderPath}`);               const stats = await organizeFolder(folderPath);              const report = generateReport(stats);               console.log(report);              return report;            } }; 
4.4 第四步:测试调试(40 分钟)
本地测试
#创建测试文件夹 mkdir -p /test-downloads  # 放几个测试文件进去 touch /test-downloads/test.jpg touch /test-downloads/report.pdf touch /test-downloads/archive.zip  # 运行技能 node -e " const organizer = require('./index.js'); organizer.execute({ folderPath: '/Users/your-name/test-downloads' }); " 
预期输出
🔍 开始整理:/Users/your-name/test-downloads ✅ 整理完成!  📊 共处理 3 个文件  📁 分类结果:   🖼️ image: 1 个   📄 document: 1 个   📦 archive: 1 个 
我的踩坑记录
这里分享我实际遇到的 3 个问题:
坑 1:权限问题
ErrorEACCES: permission denied 
解决:确保对目标文件夹有读写权限,Mac 上可能需要 chmod 或者在系统设置里给权限。
坑 2:路径中有空格
文件夹路径:/Users/xxx/My Downloads 
解决:用 path.join() 而不是字符串拼接,它会自动处理空格。
坑 3:文件重名覆盖
目标文件夹已有同名文件,直接覆盖会丢数据 
解决:代码里加了计数器,自动重命名为 file_1.jpg、file_2.jpg...

五、进阶:让技能更聪明一点

基础功能跑起来后,可以考虑这些优化方向:
加记忆功能
让技能记住用户的偏好:
// 保存用户配置 const config = {     lastFolder'~/Downloads',     customRules: {         '.sketch''design',         '.fig''design'      } };// 下次自动用上次的文件夹 
多工具协作
组合多个技能实现更复杂的功能:
文件整理 + 云盘同步 + 通知推送                 ↓ 整理完自动上传到百度网盘,然后发微信通知你 
错误处理优化
别让用户看到一堆报错:
// 不好的做法 throw new Error(error.stack);  // 好的做法 return `⚠️ 整理过程中遇到一点问题:${error.message},请稍后再试`
性能小技巧
大文件夹分批处理,避免卡死
用 fs.promises 异步操作,不阻塞主线程
跳过系统文件和隐藏文件

六、实战案例:我写的这个技能能干嘛

我的下载文件夹一直是重灾区: - 截图几十张,找的时候翻半天 - 各种 PDF、Word 混在一起 - 安装包下载完就忘了删
使用前
Downloads/ ├── 截图 2026-03-30 10.23.png ├── 截图 2026-03-30 11.45.png ├── 合同.pdf ├── 报价单.xlsx ├── node-v24.11.1.pkg ├── 某软件.dmg └── ... (还有 80+ 个文件) 
使用后
Downloads├── image/ │   ├── 截图 2026-03-30 10.23.png │   └── 截图 2026-03-30 11.45.png ├── document/ │   ├── 合同.pdf │   └── 报价单.xlsx ├── installer/ │   ├── node-v24.11.1.pkg │   └── 某软件.dmg └── ... (清爽了) 
拿过去改改就能用,不用从零开始。
你可以改成:
  • 按日期分类:创建 2026-03/、2026-02/ 这样的文件夹
  • 按项目分类:识别文件名中的项目关键词
  • 自动删除旧文件:超过 30 天的安装包直接删
  • 云同步:整理完自动上传到网盘

七、常见问题 Q&A

Q: 没有编程基础能学吗?
A: 能。我就是边查文档边写的。
建议学习路径: 1. 先跑通我的代码 2. 改改参数,看看会发生什么 3. 尝试加一个小功能 4. 遇到问题就 Google/问 AI
Q: 用哪个模型比较好?
A:
追求效果:Claude 3.5/4,理解能力更强 
性价比:百度文心/通义千问,便宜够用
Q: 技能写错了会把电脑搞坏吗?
A: 只要不做以下操作,基本是安全的: 
- ❌ 不删除系统文件 
- ❌ 不修改系统配置 
- ❌ 不执行来路不明的代码
我的代码里特意加了验证,不会处理隐藏文件和系统目录。
Q: 怎么分享给别人用?
A:  
1. 把整个技能文件夹打包 
2. 对方放到他们的 ~/.openclaw/workspace/skills/ 目录 
3. 重启 OpenClaw 就能用或者发布到 ClawHub(OpenClaw 的技能市场)。

八、下一步你可以做什么

别只看不练,现在就动手。
这篇文章你就算一字不落地看完,不动手也学不会。反过来,就算你只跟着做了 50%,也比光看强 10 倍。
我整理了一些资料:
资源
链接
OpenClaw 官方文档
docs.openclaw.ai
技能开发规范
GitHub - AgentSkills
Node.js 入门教程
nodejs.org/learn
我的代码仓库
[待补充]
写好了记得告诉我!
在评论区晒出你的第一个技能
遇到问题也可以留言,我看到会回
想让我写什么进阶教程,也可以提