小灵犀 · SKILLS导师

三步成为Skills创造者

遵循OpenClaw工程哲学，轻松开发、安装、守护您的技能

理解技能本质

Skill = “SKILL.md 描述 + 可选代码”。AI通过阅读自然语言描述学会调用工具，无需复杂API对接。

SKILL.md

声明式

                        name: email-manager

                        description: 管理邮件

                        tools:

                          - name: send-email

                            description: 发送邮件

开发 & 安装

新手从纯描述开始；进阶用Python/TypeScript实现复杂逻辑。通过Clawhub一键安装。

~/.openclaw/skills/

clawhub install

                        # 创建技能目录

                        mkdir -p ~/.openclaw/skills/my-qr-code

                        # 安装社区技能

                        clawhub install email

安全与审计

15%的社区技能可能包含恶意指令。使用沙箱运行，扫描后再安装，定期审计日志。

沙箱隔离

提示词注入

                        # 扫描技能安全

                        openclaw skills scan --url https://clawhub.com/skills/xxx

                        # 查看审计日志

                        cat ~/openclaw/logs/audit.log

🧰 OpenClaw Skills 完全库

基于Awesome Openclaw Skills与官方ClawHub分类，覆盖31个领域，以下展示最常用技能

开发辅助类

技能名称	功能描述	安装量	安装命令
github-pr	PR获取、预览、合并、测试，本地化处理	2.1k+	clawhub install github-pr
docker-essentials	Docker命令与工作流，容器化部署	1.8k+	clawhub install docker-essentials
kubernetes	K8s/OpenShift全面管理，多云容器编排	1.5k+	clawhub install kubernetes
debug-pro	系统化调试方法论，复杂Bug排查	1.2k+	clawhub install debug-pro
nextjs-expert	Next.js 14/15应用构建，全栈开发	1.1k+	clawhub install nextjs-expert

办公效率类

技能名称	功能描述	安装量	安装命令
Email	多平台邮件收发、搜索、整理，支持Gmail/Outlook	2,172	clawhub install email
imap-smtp-email	IMAP/SMTP协议原生邮件管理，支持附件	1,077	clawhub install imap-smtp-email
Gmail	专属Gmail账户管理，标签同步	1,049	clawhub install gmail
pdf-processor	PDF转Word、文档批量处理、格式转换	890+	clawhub install pdf-processor
todoist	任务创建、项目管理，与Todoist同步	760+	clawhub install todoist

AI & 大模型类

技能名称	功能描述	安装量	安装命令
agent-orchestrator	复杂任务的元代理编排，多智能体协同	2.3k+	clawhub install agent-orchestrator
memory-system-v2	快速语义记忆系统，向量数据库支持	1.9k+	clawhub install memory-system-v2
raglite	本地优先RAG缓存，隐私保护检索	1.4k+	clawhub install raglite
model-router	综合AI模型路由，成本-质量平衡	1.2k+	clawhub install model-router
perplexity	Perplexity API网页搜索，实时信息	1.1k+	clawhub install perplexity

百度官方Skills

技能名称	功能描述	数据源	安装命令
Baidu Search	实时全网信息检索，最新资讯	百度搜索	clawhub install baidu-search
Baidu Baike	权威结构化百科知识，词条检索	百度百科	clawhub install baidu-baike
Baidu Scholar	学术文献检索，论文资料搜集	百度学术	clawhub install baidu-scholar
AI PPT Generator	根据主题快速生成PPT草稿	文心大模型	clawhub install ai-ppt-generator
千帆深度研究Agent	复杂课题多步调研，生成深度报告	百度千帆	clawhub install qianfan-deep-research

📄 SKILL.md 规范

YAML前置数据 + Markdown说明体，完整描述技能行为

YAML 前置数据

字段	必填	说明
name	✅	技能唯一标识 (小写+横杠)
description	✅	简短功能描述
version	✅	语义化版本号
author	✅	作者名/昵称
permissions	❌	所需权限 (文件写入/网络访问等)
dependencies	❌	依赖包列表

Markdown 必备章节

1. 功能描述 – 核心用途概述
2. 适用场景 – 多示例说明何时使用
3. 使用说明 – 按步骤拆解执行流程
4. 返回格式 – 示例输出
5. 边缘情况 – 参数缺失/异常处理

                # 完整示例 (generate-qr-code)

                ---

                name: generate-qr-code

                description: 生成二维码/条形码

                version: 1.0.0

                author: xlx-team

                permissions: 文件写入权限

                dependencies:

                  - qrcode

                  - pillow

                ---

                # Generate QR Code Skill

                ## 1. Description

                ... (详细说明)

🐍 Python 技能示例 · 生成二维码

带代码的Skill目录结构与核心逻辑

                        # 目录结构

                        ~/.openclaw/skills/generate-qr-code/

                        ├── SKILL.md

                        ├── agent.py

                        └── references/

                                └── example-qr.png

                        # agent.py (核心)

                        import qrcode, os

                        def generate_qr(text, size=300, color="black", save_path=None):

                            if save_path is None:

                                save_path = os.path.expanduser("~/Desktop/qr.png")

                            qr = qrcode.QRCode()

                            qr.add_data(text)

                            img = qr.make_image(fill_color=color)

                            img.save(save_path)

                            return {"success": True, "path": save_path}

📦 发布到ClawHub

分享您的技能，让全球用户安装

发布命令

                    clawhub publish ~/.openclaw/skills/my-skill \

                      --slug my-skill \

                      --name "技能展示名称" \

                      --version 1.0.0 \

                      --description "简短描述" \

                      --public \

                      --author "您的名字" \

                      --license MIT

--slug：技能唯一标识（小写+横杠）
--public：公开可见（去掉则私有）
发布后可通过 clawhub search 技能名 验证

安全警钟：15%的社区技能存在风险

VirusTotal分析发现，数百个技能包含恶意指令，例如窃取密钥、反弹Shell、篡改上下文文件。以下为已识别的恶意技能（切勿安装）：

better-polymarket wake-up evilweather rankaj devinism

🛡️ 安全开发三原则：

权限最小化：仅授予技能必需的权限，在SKILL.md中明确标注
来源验证：安装前查看SKILL.md，高危权限技能谨慎安装
定期更新：执行clawhub update --all获取安全补丁

                    # 技能审核清单 (发布前自查)

                    □ 无硬编码敏感信息 (API密钥/密码)

                    □ 所有网络请求使用HTTPS

                    □ 文件操作限定在用户授权目录

                    □ 不执行未经参数校验的系统命令

                    □ SKILL.md中明确列出所有权限需求

🔧 常见问题排查

技能不响应、AI不识别、权限错误……一站式解决

技能调用无响应

                        openclaw skills list

                        openclaw skills status --name "技能名"

                        openclaw skills reload

                        openclaw logs --level debug

AI不识别技能

原因：SKILL.md中“适用场景”示例不足。增加更多用户表达方式示例，然后openclaw skills reload。

依赖安装失败

                        pip install qrcode pillow   # Python

                        npm install qrcode           # Node.js

网络访问受限

openclaw config set clawhub.mirror "https://mirror.aliyun.com/clawhub/"

⚡ 组合技能实战

多个Skills协同，完成复杂自动化任务

热点追踪 + 邮件日报

用浏览器技能抓取今日热搜，AI整理摘要后，通过Email技能自动发送到工作邮箱。

用浏览器查询今日5大热点，整理成邮件，发送至 me@xlx.app

服务器故障自愈 + 灯光提醒

Prometheus监控触发 → OpenClaw SSH排查 → 重启服务 → 通过Home Assistant闪灯提醒。

重启192.168.1.108，完成后闪烁书房灯光

🧙 SKILLS 导师