OpenClaw Skills 安装指南：给 AI 助手装上超能力

什么是 OpenClaw Skills？

如果你觉得 OpenClaw 的基础功能已经很强大了，那么 Skills 系统会让你大开眼界。Skills（技能）是 OpenClaw 的插件系统，通过安装不同的 Skill，你可以给 AI 助手添加各种专业能力——浏览器自动化、社交媒体运营、服务器安全审计、天气查询、产品营销策略……几乎无所不能。

你可以把 Skills 理解为"给 AI 装上的超能力包"。每个 Skill 都是一个自包含的功能模块，包含详细的使用说明（SKILL.md）和工具集成配置。AI 会在需要时自动读取对应的 Skill 文件，按照说明执行任务。

---

Skills 的工作原理

SKILL.md：技能的核心说明书

每个 Skill 的核心都是一个 SKILL.md 文件。这个 Markdown 文件详细描述了：

• 技能描述：这个 Skill 是做什么的
• 使用时机：什么时候应该自动激活这个 Skill
• 操作流程：具体的执行步骤和工具调用方式
• 配置要求：需要哪些前置条件和配置
• 示例：实际使用案例

当 AI 收到一个请求时，它会扫描已安装的 Skills 的描述信息，判断哪个 Skill 最适合当前任务，然后加载对应的 SKILL.md 来指导执行。这个过程是自动的——你不需要手动选择 Skill，AI 会智能匹配。

Skill 目录结构

~/.openclaw/skills/
├── skill-name-version/
│   ├── SKILL.md          # 技能说明文档（核心）
│   ├── tools/            # 工具脚本和集成
│   ├── config/           # 配置文件模板
│   ├── examples/         # 使用示例
│   └── README.md         # 额外说明（可选）
└── another-skill-version/
    ├── SKILL.md
    └── ...

🔑 关键理解：Skills 不是传统的代码插件。它们更像是"专家知识包"——告诉 AI 在特定领域应该怎么做。AI 的大模型能力 + Skill 的专业知识 = 超强的专业化 AI 助手。

---

安装 Skills：三种方式

方式一：通过 npm 安装（推荐）

最简单的方式是通过 npm 安装，和安装其他 Node.js 包一样：

# 安装单个 Skill
npm install openclaw-skill-weather -g

# 安装特定版本
npm install openclaw-skill-agent-browser@0.1.0 -g

# 安装多个 Skills
npm install openclaw-skill-weather openclaw-skill-healthcheck -g

方式二：通过 ClawHub 安装

ClawHub（clawhub.ai）是 OpenClaw 的官方 Skills 市场，提供了大量的社区和官方 Skills：

1. 访问 clawhub.ai 浏览可用的 Skills
2. 找到你需要的 Skill，查看文档和评价
3. 按照页面上的安装说明进行安装

方式三：手动安装

如果你有自定义的 Skill 或者从 GitHub 下载的 Skill，可以手动安装：

# 1. 克隆或下载 Skill 到 skills 目录
cd ~/.openclaw/skills/
git clone https://github.com/example/my-skill.git

# 2. 或者直接复制
cp -r /path/to/my-skill ~/.openclaw/skills/

# 3. 重启 Gateway 使 Skill 生效
openclaw gateway restart

---

配置和激活 Skills

自动激活机制

大部分 Skills 安装后会自动激活。AI 会在系统启动时扫描 ~/.openclaw/skills/ 目录，读取每个 Skill 的 SKILL.md 文件头部的描述信息，建立技能索引。当用户提出相关请求时，AI 会自动匹配并加载对应的 Skill。

查看已安装的 Skills

你可以通过以下方式查看已安装的 Skills：

# 在聊天中发送
/status

# 或者直接询问 AI
我安装了哪些 Skills？

Skill 级别配置

某些 Skills 需要额外的配置才能正常工作。常见的配置项包括：

配置类型	说明	示例
API Key	需要第三方服务的 API 密钥	天气服务、搜索引擎等
路径配置	指定工作目录或文件路径	浏览器路径、SSH 配置等
账户信息	社交媒体等平台的登录凭证	小红书、Twitter 账号
阈值设置	触发条件的参数	健康检查的告警阈值

这些配置通常在 Skill 的 SKILL.md 中有详细说明。安装新 Skill 后，务必阅读 SKILL.md 的配置部分。

---

如何阅读 SKILL.md

SKILL.md 是每个 Skill 的灵魂文件。无论是使用还是创建 Skill，读懂 SKILL.md 都是关键。一个典型的 SKILL.md 包含以下部分：

# Skill 名称
简短描述这个 Skill 的用途

## 何时使用
描述在什么情况下应该激活这个 Skill
（AI 会根据这部分内容进行自动匹配）

## 前置条件
需要安装什么、配置什么才能使用

## 操作步骤
详细的执行流程，包括：
- 需要调用哪些工具
- 参数如何传递
- 结果如何处理

## 示例
实际使用案例，帮助理解用法

## 注意事项
常见问题、限制条件、安全提醒

当你使用一个 Skill 时，AI 会自动加载并遵循 SKILL.md 中的指示。你不需要手动执行 SKILL.md 中的步骤——那是 AI 的工作。你只需要理解这个 Skill 能做什么，然后用自然语言告诉 AI 你的需求。

💡 使用技巧：如果你不确定某个 Skill 怎么用，直接问 AI："XXX Skill 怎么用？"它会读取 SKILL.md 然后给你一个通俗易懂的解释。

---

创建自定义 Skills

如果你有特定的工作流程想要自动化，可以创建自己的 Skill。创建 Skill 的核心就是写一个 SKILL.md 文件。

最小化 Skill 示例

# 我的自定义 Skill

## 何时使用
当用户要求执行 XXX 操作时使用此 Skill。

## 操作步骤
1. 读取文件 /path/to/data
2. 执行分析
3. 输出结果

## 示例
用户："帮我分析 XXX"
AI：按照此 Skill 的步骤执行...

你也可以使用 skill-creator 这个 Skill 来辅助创建新的 Skill——它会引导你完成 SKILL.md 的编写过程。

Skill 编写最佳实践

• 描述清晰："何时使用"部分要写得明确，这样 AI 才能准确匹配
• 步骤详细：操作步骤要具体到可执行，不要有歧义
• 示例丰富：多写几个实际使用案例，帮助 AI 理解意图
• 安全第一：涉及外部操作时，明确标注风险和确认步骤
• 模块化：一个 Skill 做一件事，不要把所有功能塞到一个 Skill 里

---

Skill 管理：启用、禁用、更新

禁用 Skill

如果某个 Skill 暂时不需要，你可以禁用它而不必卸载：

# 方法1：重命名目录（在目录名前加 . 前缀）
mv ~/.openclaw/skills/my-skill ~/.openclaw/skills/.my-skill.disabled

# 方法2：删除 SKILL.md（保留其他文件）
mv ~/.openclaw/skills/my-skill/SKILL.md ~/.openclaw/skills/my-skill/SKILL.md.disabled

# 重启 Gateway
openclaw gateway restart

更新 Skill

# npm 安装的 Skill
npm update openclaw-skill-weather -g

# Git 克隆的 Skill
cd ~/.openclaw/skills/my-skill
git pull

卸载 Skill

# npm 安装的
npm uninstall openclaw-skill-weather -g

# 手动安装的
rm -rf ~/.openclaw/skills/my-skill

openclaw gateway restart

---

常见问题和故障排除

问题 1：安装 Skill 后 AI 不识别

• 确认 Skill 目录在 ~/.openclaw/skills/ 下
• 确认 SKILL.md 文件存在且格式正确
• 重启 Gateway：openclaw gateway restart
• 检查 SKILL.md 的"何时使用"部分是否描述清晰

问题 2：Skill 执行时报错

• 检查是否完成了 SKILL.md 中要求的前置配置
• 确认 API Key 或账户凭证有效
• 查看 Gateway 日志获取详细错误信息：openclaw gateway logs
• 确认依赖的工具已安装（如浏览器驱动等）

问题 3：多个 Skill 冲突

如果两个 Skill 的"何时使用"描述过于相似，AI 可能会选错。解决方法是让每个 Skill 的触发条件更加明确和独特。

问题 4：Skill 占用太多 Token

某些 Skill 的 SKILL.md 文件很长，加载时会消耗较多 Token。如果成本敏感，可以精简 SKILL.md 内容，只保留核心信息，或者禁用不常用的 Skill。

---

总结

Skills 是 OpenClaw 生态系统的核心扩展机制。通过安装合适的 Skills，你可以把一个通用的 AI 助手变成一个专业级的数字员工。从浏览器自动化到社交媒体运营，从服务器监控到内容营销——只有你想不到，没有 Skills 做不到。

1. 先从官方推荐的 Skills 开始安装
2. 仔细阅读每个 Skill 的 SKILL.md
3. 根据实际需求创建自定义 Skills
4. 定期更新和管理已安装的 Skills

下一篇我们会推荐 2026 年最值得安装的 10 个 OpenClaw Skills，帮你快速找到适合自己需求的超能力包。