OpenClaw 技能系统实战:安装、配置与自定义开发

从海量技能库中挑选所需能力，手把手教你安装、配置，甚至开发自己的专属技能。

目录

一、什么是技能？

二、技能生态概览

三、安装你的第一个技能

四、常用技能配置详解

五、技能组合与工作流

六、开发自定义技能

七、技能调试与排错

八、结语与预告

一、什么是技能？

在上一篇中，我们成功搭建了 OpenClaw 基础环境并接入了 QQ 机器人。但此时的 AI 助手只能进行简单的对话——就像一部智能手机刚出厂，只具备了最基础的通话功能。

技能（Skills）就是给这台"智能手机"安装的各种 App。

技能能做什么？

技能 vs 工具调用（Function Calling）

你可能会问：这不就是大模型的工具调用吗？

区别在这里：

• 工具调用是模型层面的能力，需要开发者自己编写每个工具的代码和 prompt
• 技能是封装好的、可复用的模块，开箱即用，且有统一的安装、配置、管理机制

简单说：技能让非开发者也能给 AI 助手扩展能力。

二、技能生态概览

2.1 官方技能库

OpenClaw 维护了一个官方技能仓库，你可以在这里找到经过审核的可靠技能。

访问方式：

# 列出所有可用技能
openclaw skills list

# 按关键词搜索（使用 clawhub）
clawhub search "weather"

热门官方技能清单：

2.2 社区技能与第三方来源

除了官方库，你还可以：

1. GitHub 搜索
   ：openclaw skill 或 openclaw plugin 关键词
2. ClawHub
   ：https://clawhub.com - OpenClaw 技能市场
3. 自己开发
   ：参考官方模板开发私有技能

2.3 技能存储位置

安装后的技能保存在：

• Windows
  ：%USERPROFILE%\.openclaw\skills\
• macOS/Linux
  ：~/.openclaw/skills/

每个技能是一个独立文件夹，包含 SKILL.md（说明文档）和执行代码。

三、安装你的第一个技能

让我们从最简单的天气查询技能开始。

3.1 安装技能

前置要求：确保已安装 clawhub CLI 工具

npm install -g clawhub

安装天气技能：

clawhub install weather

安装成功标志：

✓ Installed weather@1.2.0
  Location: ~/.openclaw/skills/weather/

3.2 查看技能文档

每个技能都附带详细的使用说明。使用以下命令查看：

# 查看技能详细信息
openclaw skills info weather

或直接阅读技能目录下的 SKILL.md 文件：

• Windows
  ：%USERPROFILE%\.openclaw\skills\weather\SKILL.md
• macOS/Linux
  ：~/.openclaw/skills/weather/SKILL.md

文档内容包括：功能介绍、配置参数、使用示例、依赖要求

3.3 配置技能（如有需要）

部分技能需要配置 API Key 或其他参数。以天气技能为例，它使用免费的 wttr.in 服务，无需配置即可使用。

但如果需要更精准的商业天气数据（如 Open-Meteo），则需要编辑配置文件：

• Windows
  ：%USERPROFILE%\.openclaw\skills\weather\config.json
• macOS/Linux
  ：~/.openclaw/skills/weather/config.json

3.4 测试技能

现在，给你的 QQ 机器人发消息测试：

用户：北京今天天气怎么样？

AI 助手：北京今天天气晴朗，气温 8-18°C，空气质量良，适合外出。

🎉 恭喜你！第一个技能安装成功！

四、常用技能配置详解

接下来介绍几个高频使用的技能及其配置方法。

4.1 联网搜索技能（web-search）

功能：让 AI 助手能够实时搜索互联网信息，弥补大模型训练数据的时效性限制。

clawhub install web-search

配置（使用 Brave Search）：

1. 访问 https://brave.com/search/api/ 申请免费 API Key（每月 2000 次免费额度）
2. 编辑 ~/.openclaw/openclaw.json：

{
  "skills": {
    "web-search": {
      "apiKey": "BSAxxxxx",
      "defaultCount": 5,
      "language": "zh-CN"
    }
  }
}

4.2 GitHub 技能

功能：管理 GitHub Issues、Pull Requests、查看 CI 运行状态。

clawhub install github

配置：

1. 访问 https://github.com/settings/tokens 生成 Personal Access Token
2. 编辑配置：

{
  "skills": {
    "github": {
      "token": "ghp_xxxxxxxxxxxx",
      "defaultOwner": "your-username"
    }
  }
}

4.3 文档处理技能 trio

OpenClaw 提供了一套完整的文档处理技能，建议同时安装：

# 一次性安装三个文档技能
clawhub install pdf
clawhub install docx
clawhub install xlsx

PDF 技能

功能：提取 PDF 文本内容、解析表格数据、合并/拆分 PDF、OCR 文字识别

Word 技能（docx）

功能：生成格式化的 Word 文档、读取和编辑现有文档、插入表格、图片、页眉页脚

Excel 技能（xlsx）

功能：读取、编辑 Excel 文件、数据清洗和格式转换、生成图表、公式计算

五、技能组合与工作流

真正的威力在于技能组合——多个技能协同工作，完成复杂任务。

5.1 实战案例：竞品分析报告

场景：需要分析竞品网站的信息，生成一份 PDF 报告。

工作流：

1. browser
    - 抓取竞品网站信息
2. web-search
    - 补充行业背景数据
3. docx
    - 生成 Word 报告
4. pdf
    - 转换为 PDF 格式

5.2 实战案例：智能客服系统

场景：搭建一个能查询订单状态、生成报价单的客服机器人。

工作流：

1. xlsx
    - 读取订单数据库（Excel 格式）
2. docx
    - 生成标准报价单模板
3. 自定义技能
    - 查询企业内部 API

六、开发自定义技能

如果官方和社区技能无法满足需求，你可以开发自己的技能。

6.1 技能目录结构

my-skill/
├── SKILL.md          # 技能说明文档（必需）
├── package.json      # 依赖声明（Node.js 技能）
├── main.js           # 主入口文件
├── config.json       # 默认配置
└── README.md         # 详细说明（可选）

6.2 最小化技能示例

创建一个查询公司内网 API 的技能。

SKILL.md：

# 订单查询技能

查询公司内部订单系统。

## 使用方式

用户询问订单状态时，调用此技能。

## 配置

编辑 config.json：
{
  "apiEndpoint": "https://internal-api.company.com/orders",
  "apiKey": "your-api-key"
}

6.3 安装自定义技能

本地开发的技能无需通过 clawhub，直接复制到 skills 目录即可：

# 复制到 OpenClaw skills 目录
# Windows:
copy /Y my-skill %USERPROFILE%\.openclaw\skills\

# macOS/Linux:
cp -r my-skill ~/.openclaw/skills/

或者通过 clawhub 从 GitHub 安装（如果已发布）：

clawhub install username/my-skill

6.4 技能开发最佳实践

1. 文档先行
   ：先写 SKILL.md，明确功能边界
2. 配置外置
   ：敏感信息（API Key）放在配置文件，不要硬编码
3. 错误处理
   ：网络请求要有超时和重试机制
4. 日志记录
   ：使用 console.log 输出调试信息
5. 版本管理
   ：使用语义化版本号（semver）

七、技能调试与排错

7.1 查看技能日志

技能运行日志可以通过以下方式查看：

# 查看 OpenClaw 运行日志
openclaw logs

# 实时追踪日志
openclaw logs -f

7.2 技能失效排查清单

7.3 卸载技能

# 通过 clawhub 卸载
clawhub uninstall weather

或者直接删除技能目录：

# Windows:
rd /s /q %USERPROFILE%\.openclaw\skills\weather

# macOS/Linux:
rm -rf ~/.openclaw/skills/weather

7.4 更新技能

# 更新特定技能
clawhub update weather

# 更新所有技能
clawhub update --all

八、结语与预告

至此，你已经掌握了 OpenClaw 技能系统的全貌：

• ✅ 理解技能的概念和价值
• ✅ 学会从官方库安装和配置技能
• ✅ 掌握技能组合，构建复杂工作流
• ✅ 能够开发简单的自定义技能

你的 AI 助手已经不再是"只能聊天"的机器人，而是一个拥有专业技能的数字助手。

下一步预告

在下一篇文章中，我们将探讨：

《OpenClaw 知识库实战：搭建你的私有 RAG 系统》

• 上传企业文档，让 AI 助手学会你的专业知识
• 搭建客服知识库，实现精准问答
• 整合多数据源，构建智能检索系统

敬请期待！

附录：快速参考

技能管理命令（clawhub）

# 搜索技能
clawhub search "关键词"

# 安装技能
clawhub install <skill-name>

# 查看已安装技能
clawhub list

# 更新技能
clawhub update <skill-name>
clawhub update --all

# 卸载技能
clawhub uninstall <skill-name>

技能查看命令（openclaw）

# 列出可用技能
openclaw skills list

# 查看技能详情
openclaw skills info <skill-name>

# 检查技能状态
openclaw skills check

推荐技能组合（按场景）

本文基于 OpenClaw 官方文档整理，