夜雨聆风
OpenClaw Skill 完全使用指南
编写日期：2026-04-28 | 适用版本：OpenClaw 最新版
1.📖 目录
-
什么是 Skill？ -
Skill 的存放位置与优先级 -
SKILL.md 文件结构详解 -
创建自己的 Skill -
安装社区 Skill（ClawHub） -
Skill 的管理命令 -
常见问题与解决方案
2.什么是 Skill？
Skill（技能）是 OpenClaw 的能力扩展单元，类似于插件或应用。它们运行在 Agent 上下文中，可以连接到各种工具和服务，极大地扩展 OpenClaw 的能力。
2.1Skill 能做什么？
-
🔍 教 Agent 使用特定工具（如浏览器自动化、文件处理） -
📋 定义固定的工作流程和检查清单 -
🧠 注入特定领域的专业知识 -
⚡ 实现特定功能的快捷指令
3.Skill 的存放位置与优先级
OpenClaw 从多个来源加载技能。按优先级从高到低排列：
/.openclaw/skills/ — 工作区专属技能
/skills/ — 工作区技能（兼容性路径） -
~/.agents/skills/ — 个人全局技能 -
~/.openclaw/skills/ — 托管/本地技能 -
内置技能 — 随安装包提供
4.SKILL.md 文件结构详解
每个 Skill 目录必须包含一个 SKILL.md 文件，采用 YAML frontmatter + Markdown 正文的格式。
-
name — Skill 名称，唯一标识 -
description — 技能描述，会注入到提示词中 -
metadata — 元数据配置（可选）
5.安装社区 Skill（ClawHub）
OpenClaw 拥有活跃的社区技能市场 ClawHub（https://clawhub.ai），目前已有 1700+ 技能可供使用。
5.1常用命令
# 搜索技能 openclaw skills search "excel" # 安装技能 openclaw skills install excel-tools # 指定版本安装 openclaw skills install excel-tools@1.2.0 # 从 GitHub 安装 openclaw skills install https://github.com/user/skill-name # 更新已安装的技能 openclaw skills update excel-tools # 卸载技能 openclaw skills uninstall excel-tools # 查看已安装列表 openclaw skills list 5.2必装推荐
-
excel-tools — Excel 读写、合并、拆分 -
pdf-utils — PDF 合并、拆分、旋转 -
docx-tools — Word 文档处理 -
image-tools — 图片格式转换、压缩 -
web-search — 网络搜索增强 -
file-manager — 批量文件管理
6.常见问题与解决方案
6.1Q1: 为什么我的 Skill 没有生效？
检查清单：
-
Skill 目录是否在正确的位置？ -
SKILL.md 文件是否在 Skill 目录的根目录？ -
YAML frontmatter 格式是否正确？ -
OpenClaw 是否已重启？
6.2Q2: Skill 之间冲突怎么办？
-
检查优先级：工作区 Skill > 全局 Skill -
删除不需要的 Skill：openclaw skills uninstall -
修改 Skill 描述：避免模糊的重叠触发条件
6.3Q3: 如何分享我创建的 Skill？
-
在 GitHub 创建公开仓库 -
包含完整的 SKILL.md 文件 -
可选：创建 README.md 详细说明 -
在 ClawHub 提交你的 Skill 链接
[!WARNING] ⚠️ ⚠️ 安全注意：安装第三方 Skill 前请仔细阅读 SKILL.md 内容，检查是否请求了敏感权限。
7.最佳实践
7.11. Skill 命名规范
# 推荐：使用 kebab-case，清晰表达功能 excel-processor web-scraper stock-analyzer # 避免：含糊不清或太通用 tool my-tool helper 7.22. Skill 触发词设计
在描述中加入明确的触发条件，例如：
当用户请求以下操作时激活此技能： - 分析股票 - 帮我看看这支股票 - 股票走势 - 使用stock-analysis斜杠命令 8.相关资源
-
OpenClaw 官网：https://openclaw.ai -
ClawHub 技能市场：https://clawhub.ai -
官方文档：https://docs.openclaw.ac.cn -
GitHub 仓库：https://github.com/claw-ai/openclaw -
中文社区：https://openclaw.cc
本文档会持续更新，如有问题欢迎反馈。