Skills 系统：给 AI 安装技能、解锁真实能力

📖 本章目标：理解 Skills 机制，学会安装和使用技能扩展 OpenClaw 能力

---

5.1 什么是 Skill

Skill 是教 AI 执行任务的指令文件夹，是 OpenClaw 扩展能力的核心方式。

💡 Skill vs MCP 的关系：MCP 是厨房，Skill 是食谱。

一个 Skill 本质上是：

• 一套标准化的指令文档（SKILL.md）
• 加上可选的脚本、参考资料和资源文件
• AI 读取后就知道”该怎么做这件事”

---

5.2 Skill 目录结构

skill-name/
├── SKILL.md          # 必需！包含 YAML 元数据
├── scripts/          # 可执行脚本（可选）
├── references/       # 参考资料（可选）
└── assets/           # 资源文件（可选）

SKILL.md 必须包含的 YAML 元数据

---
name: skill-name
description: 技能的功能描述
trigger: 触发条件描述
---

---

5.3 为什么需要 Skill

好处	说明
标准化	统一的技能格式，便于管理和分享
复用性	一次编写，多次使用，跨 Agent 复用
低门槛	用户无需深入了解 AI 原理即可扩展功能
可组合	Skill 之间可互相调用，构建复杂工作流

---

5.4 三层优先级（从高到低）

1️⃣ 工作区 skills（项目专属）
   路径：workspace/skills/
   优先级：最高，覆盖同名全局/内置技能

2️⃣ 全局 skills（用户级别）
   路径：~/.openclaw/skills/
   优先级：中等

3️⃣ 内置 skills（官方默认）
   路径：npm 包内置
   优先级：最低，作为基础能力兜底

---

5.5 Skill 加载流程

扫描 SKILL.md 元数据
        ↓
注入环境变量与 API Key
        ↓
构建系统提示词（注入到 LLM 上下文）
        ↓
Agent 执行任务（调用 Skill 中的指令/脚本）
        ↓
执行完成后恢复环境

---

5.6 安装与管理命令

# 安装 Skill
openclaw skills install <名称>

# 查看可用 Skills（符合当前环境条件的）
openclaw skills list --eligible

# 查看 Skill 详细信息
openclaw skills info <名称>

# 更新 Skill 到最新版本
openclaw skills update <名称>

# 从 ClawHub 搜索技能
openclaw skills search <关键词>

---

5.7 推荐 Skills 清单

🔧 必备基础

Skill	用途
clawhub	ClawHub 技能市场，搜索安装更多技能
skill-creator	AI 自动创建新技能
web-search	网页搜索（Brave API）

⚡ 效率提升

Skill	用途
agent-browser	浏览器自动化
shell	Shell 命令执行
cron	定时任务
gmail	邮件管理
pdf	PDF 处理

💻 开发相关

Skill	用途
github	GitHub 操作（PR、Issues、CI）
git	Git 版本控制
coding-agent	代码开发助手

🌿 生活助手

Skill	用途
calendar	日历管理
translate	多语言翻译
image-gen	AI 图片生成

🖥️ 设备控制

Skill	用途
nodes	多节点管理
spotify	音乐控制
home-assistant	智能家居控制

---

5.8 ⚠️ 安全警告：ClawHavoc 供应链攻击

时间：2026 年 1-2 月 规模：ClawHub 约 12%~20% 的技能含恶意代码

恶意行为包括

• 窃取 API Key
• 篡改 SOUL.md（改变 Agent 行为）
• 植入木马

防护措施

措施	操作
安装前审查	查看 Skill 源码，确认无可疑脚本
安全扫描	使用 SecureClaw 工具扫描
使用精选列表	优先从 awesome-openclaw-skills 安装
权限最小化	只安装必要的技能，避免过度授权

⚠️ 铁律：不明来源的 Skill 一律不装！

---

← 上一章：渠道接入 | 返回目录 | 下一章：模型配置 →