OpenClaw Skill 开发全攻略｜2026 最新机制 + 文件处理实操，看完直接落地开发 - AI创想

# 1. 创建用户技能目录（若不存在则自动创建，不用担心重复执行报错）mkdir -p ~/.openclaw/skills/
# 2. 创建具体技能文件夹（以“天气查询”技能为例，可替换为自己的技能名称）mkdir -p ~/.openclaw/skills/my-weather-skill
# 3. 进入技能目录，准备编写SKILL.md和代码文件cd ~/.openclaw/skills/my-weather-skill

复制代码

---
# 固定元数据头（必须完整，AI 优先读取，缺一不可）
name: weather-query # 技能唯一名称，小写字母+横杠，不要重复
description: 查询全球主要城市实时天气，支持中文查询（含温度、天气状况、湿度、风力） # 技能简短描述，让用户一眼知道能做什么
version: 1.0.0 # 版本号，后续更新可升级，比如1.0.1
author: 你的名字 # 填写自己的名字或昵称，发布到社区会显示
permissions: 网络访问权限（用于调用天气 API） # 技能所需权限，明确标注
---
# Weather Query Skill（技能名称，可自定义，建议和name对应，更清晰）
## 1. Description（技能详细说明，让AI知道这个技能的具体作用）
当用户询问天气相关问题时，使用此技能查询实时天气数据，以清晰、友好的中文格式返回结果，不用多余的英文，帮助用户快速了解目标城市的天气情况，比如温度、天气状况、湿度、风力，必要时补充温馨提示。
## 2. When to use（触发场景：明确AI什么时候该调用这个技能，多举实际示例）
- 用户说：“北京今天天气怎么样？”
- 用户说：“上海明天会下雨吗？”
- 用户说：“纽约当前温度是多少？”
- 用户说：“成都后天的天气预报”
- 用户说：“帮我查一下广州近 3 天的天气”
- 用户说：“深圳今天热不热，需要穿外套吗？” # 补充更贴近日常的指令
## 3. How to use（调用逻辑：教AI怎么使用这个技能，按步骤写，越清晰越好）
1. 从用户消息中提取2个核心信息，缺一不可：
- 目标城市（必须，比如“北京”“上海”“纽约”，如果是国外城市，优先用中文名称）；
- 查询时间（可选，默认“今天”，支持“明天”“后天”“近3天”，超过3天提示“长期预报精度有限”）；
2. 调用 OpenClaw 内置的天气查询工具，或公开的天气 API 获取实时数据（不用手动写API调用代码，AI会自动处理）；
3. 整理数据并返回，格式固定，用户看着清晰：
- 开头明确“城市 + 时间”（比如“北京 2026年2月10日天气”）；
- 核心信息：温度（默认摄氏度，国外城市也用摄氏度，符合中文用户习惯）、天气状况（晴/雨/多云等）、湿度、风力；
- 结尾补充温馨提示（比如“今日有雨，建议带伞”“气温较低，注意保暖”）；
4. 若未提取到城市，主动追问用户，语气友好，比如“请告诉我具体要查询的城市名称，我帮你查实时天气~”。
## 4. Edge cases（边缘场景：处理异常情况，避免技能执行失败，提升用户体验）
- 模糊地点（如“家附近”“公司旁边”）：回复“请告诉我具体城市名称，以便准确查询天气，比如北京、上海”；
- 未支持城市（如小众县城、偏远地区）：回复“暂不支持该城市的天气查询，建议尝试省会或主要城市，比如查询石家庄天气”；
- 未来多天查询（如“深圳近一周天气”）：优先返回未来3天概览，说明“长期预报精度有限，仅作参考”；
- 无网络情况：回复“当前网络不可用，无法查询天气，请检查网络连接后重试哦”；
- 输入错误（如“北京”“上嗨”）：自动纠正，比如“你是不是想查北京的天气？我帮你查询北京的实时天气~”。

复制代码

~/.openclaw/skills/generate-qr-code/ # 技能根目录，名称用小写字母+横杠
├── SKILL.md # 核心描述文件（必须有，和纯文本技能一致）
├── agent.py # Python 执行逻辑（核心代码文件，实现生成二维码的功能）
└── references/ # 辅助资源文件夹（可选，放示例图片、说明文档）
└── example-qr.png # 示例二维码图片（用于说明技能效果，可选）

复制代码

---
name: generate-qr-code # 技能唯一名称，和目录名称对应
description: 生成二维码/条形码，支持文本、URL、WiFi 配置等内容，可自定义尺寸、颜色并指定保存路径
version: 1.0.0
author: 你的名字
permissions: 文件写入权限（用于保存二维码图片） # 生成二维码需要保存到本地，必须声明此权限
---
# Generate QR Code Skill（生成二维码技能）
## 1. Description
当用户需要将文本、URL、WiFi 信息等转换为可视化二维码时，使用此技能生成二维码图片，并保存到指定路径（默认保存到桌面，适配 Windows/macOS/Linux 多系统），支持自定义尺寸和颜色，生成成功后告知用户保存路径，方便查找。
## 2. When to use（触发场景，多举日常使用示例，AI更容易识别）
- 用户说：“帮我把 https://openclaw.ai 生成二维码”
- 用户说：“生成一个包含 WiFi 信息的二维码，名称：MyWiFi，密码：12345678”
- 用户说：“生成黑色二维码，内容是‘Hello OpenClaw’，保存到 D 盘根目录”
- 用户说：“帮我做一个 400px 大小的二维码，内容是我的手机号 13800138000”
- 用户说：“生成红色二维码，内容是‘2026项目会议纪要’，保存到桌面，尺寸 500px”
## 3. How to use（调用逻辑，明确什么时候调用代码，参数怎么提取）
1. 从用户消息中提取核心参数，区分必选和可选，避免遗漏：
- 必选：生成内容（文本/URL/WiFi 信息，WiFi 格式需为“WIFI:S:名称;T:类型;P:密码;;”，比如“WIFI:S:MyWiFi;T:WPA;P:12345678;;”）；
- 可选：尺寸（默认 300px，范围 100-1000px，超出范围提示“尺寸建议在100-1000px之间”）、颜色（默认黑色，支持英文颜色名或十六进制色值，如 #FF0000 红色）、保存路径（默认桌面）；
2. 若用户未指定可选参数，直接使用默认值，不用追问用户；
3. 调用 agent.py 中的 generate_qr 异步函数，将提取到的参数传入，执行生成操作（必须调用代码，AI 不单独执行生成逻辑）；
4. 返回结果：生成成功后，告知用户二维码保存路径，比如“二维码生成成功！已保存到：~/Desktop/qr_code.png”；若生成失败，说明具体原因，比如“指定路径无写入权限，请更换保存路径（如桌面）”。
## 4. Implementation（代码关联说明，新手重点看，明确参数对应关系）
- 依赖库：qrcode（生成二维码的核心库）、Pillow（图片处理，调整尺寸、颜色）；
- 核心函数：async def generate_qr(text: str, size: int = 300, color: str = "black", save_path: str = None)；
- 参数说明（和上面的提取参数对应，AI 会自动匹配）：
- text：二维码内容（必选，不能为空，为空会返回失败提示）；
- size：二维码尺寸（单位 px，默认 300，超出100-1000px范围会自动调整为300）；
- color：填充颜色（默认 black，支持英文颜色名如 red、blue，或十六进制色值如 #FF0000）；
- save_path：保存路径（默认桌面，文件名默认 qr_code.png，用户指定路径则按用户要求保存）。
## 5. Edge cases（边缘场景，覆盖常见错误，提升稳定性）
- 内容为空：回复“请提供需要生成二维码的内容（如文本、URL、WiFi 信息），我马上为你生成”；
- 保存路径无权限：回复“指定路径无写入权限，请更换保存路径（如桌面），或提升文件写入权限”；
- 未安装依赖库：自动尝试安装 qrcode 和 Pillow，若安装失败，提示用户手动执行“pip install qrcode pillow”；
- 特殊字符内容（如中文、特殊符号）：自动过滤无效字符，确保二维码可正常识别，生成后提示用户“已过滤无效字符，二维码可正常扫描”；
- 尺寸超出范围：回复“尺寸建议在100-1000px之间，已自动调整为默认300px，生成二维码”。

复制代码

import qrcode
from PIL import Image
import os
import subprocess
import sys
# 自动安装依赖库（用户可能没安装qrcode和Pillow，避免手动安装麻烦，新手友好）definstall_dependencies():
required_packages =["qrcode","pillow"]for package in required_packages:try:__import__(package)# 检查库是否已安装except ImportError:# 自动安装缺失的库，终端会显示安装过程，用户可看到进度
subprocess.check_call([sys.executable,"-m","pip","install", package])

复制代码