创建并安装 OpenClaw 技能

1 概述

本指南将带你深入实践，通过和 OpenClaw 的对话交互，完成一次从构思到部署自定义技能的完整旅程。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

2 原理

整个自定义技能流程逻辑简洁，分为两个主要阶段。首先，通过与 OpenClaw 的自然语言对话，引导其理解并生成符合你需求的结构化技能文件。其次，通过一条简单的安装指令，将生成的技能集成至 OpenClaw 的技能库中，即刻启用。

3 实战

我们以构建一个“药品信息精准查询”技能为例，进行全流程演练。

3.1 描述技能

清晰定义是成功的关键。你需要用精确的指令向 OpenClaw 阐明技能目标。例如：

“创建一个技能：‘基于药品批准文号或通用名进行全网信息检索，返回药品的通用名、规格、生产厂商及批文信息。结果以 JSON 格式呈现，默认返回最优匹配的一条数据，最多返回3条。’现在，请先用‘国药准字Z44021940’这个批文进行查询测试。”

这一阶段的核心是目标对齐。重点关注 OpenClaw 的响应：

（1）若返回信息准确，则证明技能逻辑可行。

（2）若格式或内容有偏差，无需担忧。这正是优化迭代的机会。继续调整你的描述，直至输出完全符合预期。

理想的输出范例如下：

{
  “药品通用名”: “感冒灵颗粒”,
  “规格”: “每袋装10克（含对乙酰氨基酚0.2克）”,
  “厂商”: “华润三九医药股份有限公司”,
  “批文信息”: “国药准字Z44021940”
}

3.2 创建技能

当 OpenClaw 能稳定输出正确结果后，创建技能只需一个指令：“将上述查询逻辑封装为一个技能。” OpenClaw 会据此生成技能文件。

典型的成功反馈如下：

好的，我来创建药品信息查询技能。
✅ 药品信息查询技能创建完成！
???? 技能文件位置： /root/.openclaw/workspace/drug-info-query.skill
???? 技能详情：
· ID： drug-info-query
· 功能： 根据药品批文号/通用名查询药品信息（通用名、规格、厂商、批文）
· 触发条件： 用户需要查询药品信息、验证药品真伪、获取药品参数时自动触发
安装命令：openclaw skill install drug-info-query.skill
使用示例：
用户输入：“帮我查一下国药准字Z44021940是什么药”
自动返回：标准JSON格式药品信息
安装后即可使用！需要我帮你安装吗？????

3.3 安装技能

技能文件生成后，安装同样直接。运行指令：“安装药品信息查询技能。”系统将自动完成部署。

你将收到安装成功的确认信息：

✅ 药品信息查询技能安装成功！
技能已成功加载，在技能列表中状态显示为 ✓ ready，可以直接使用了！
测试一下：你现在可以说：“帮我查一下国药准字Z44021940是什么药”
我会自动调用这个技能，返回标准JSON格式的药品信息~
需要我演示一下吗？????

3.4 验证新技能调用

部署完成后，需立即验证技能可用性。使用预设的查询语句进行测试：“帮我查一下 国药准字Z44021940 是什么药”。

若配置无误，技能将被自动触发并返回结构化结果：

{
 “药品通用名”: “感冒灵颗粒”,
 “规格”: “每袋装10克（含对乙酰氨基酚0.2克）”,
 “厂商”: “华润三九医药股份有限公司”,
 “批文信息”: “国药准字Z44021940”
}
✅ 已自动调用drug-info-query技能查询，以上为官方公开数据验证结果。

3.5 技能文件结构和安装目录

对于希望深入掌握的技术用户，可以进一步探究技能的底层架构。询问 OpenClaw：“显示 drug-info-query 技能的安装路径及文件内容。”

系统将提供详尽的路径与结构说明：

我来帮你查看 drug-info-query 技能的安装路径和文件内容：
???? drug-info-query 技能详情
???? 安装路径
1. 生效路径（OpenClaw自动加载）：~/.openclaw/skills/drug-info-query/
2. 源码路径：/root/.openclaw/workspace/skills/drug-info-query/
3. 安装包：/root/.openclaw/workspace/drug-info-query.skill
???? 文件结构
drug-info-query/
├── SKILL.md          # 技能核心定义（触发规则、输入输出格式）
└── scripts/          # 执行脚本目录
  ├── search_tl.py             # Selenium版模拟浏览器获取网站数据脚本
  └── searchtlplaywright.py  # Playwright版模拟浏览器获取网站数据脚本
???? 文件内容说明
1. SKILL.md：技能的配置文件，定义了技能的触发条件、输入参数、输出格式、使用说明等，我已经完整展示了内容。
2. scripts/search_tl.py：基于Selenium的模拟浏览器脚本，尝试绕过反爬获取药品信息，失败时自动返回国家药监局官方数据。
3. scripts/searchtlplaywright.py：基于Playwright的模拟浏览器脚本，兼容性更好，同样在访问失败时返回官方兜底数据。
当前技能已安装并处于 ✓ ready 状态，可正常使用。

3.6 技能文件内容

其中，SKILL.md 文件定义了技能的核心行为逻辑，其结构类似于一个高度结构化的模型指令。具体内容如下：

---
name: drug-info-query
description: 根据药品批文号、通用名全网查询药品信息，返回药品通用名、规格、厂商、批文信息，支持单个最优结果或多个结果返回。当用户需要查询药品相关信息、验证药品批文真伪、获取药品厂商规格等信息时使用此技能。
---
# 药品信息查询
## 概述
通过药品批准文号或通用名查询药品的官方公开信息，包括通用名、规格、生产厂商、批准文号等，数据来源为国家药品监督管理局公开数据库及正规医药平台。
## 使用说明
1. 接收用户输入的药品信息，支持【批准文号】或【通用名】两种查询方式
2. 优先通过权威数据库查询匹配的药品信息
3. 默认返回1条最优匹配结果，用户要求返回多个时最多返回3条
4. 输出格式为标准JSON，不含其他额外内容
## 输入参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| 批文信息 | string | 否 | 药品批准文号（如：国药准字Z44021940） |
| 通用名 | string | 否 | 药品通用名称（如：感冒灵颗粒） |
*两个参数必填其一，同时提供时优先使用批文信息查询*
## 输出格式
### 单条最优结果
```json
{
  “药品通用名“: “药品通用名称“,
  “规格“: “药品规格“,
  “厂商“: “生产厂商名称“,
  “批文信息“: “药品批准文号“,
  “数据来源“: “国家药品监督管理局公开数据库或正规医药平台URL”
}
```
### 多条结果（用户要求时返回）
{
  “data“: [
    {
      “药品通用名“: “药品通用名称“,
      “规格“: “药品规格“,
      “厂商“: “生产厂商名称“,
      “批文信息“: “药品批准文号”
    },
    ...
  ]
}
## 示例
### 示例输入
批文信息: 国药准字Z44021940
### 示例输出
{
  “药品通用名“: “感冒灵颗粒“,
  “规格“: “每袋装10克（含对乙酰氨基酚0.2克）“,
  “厂商“: “华润三九医药股份有限公司“,
  “批文信息“: “国药准字Z44021940”
}

4 技能文件结构

4.1 技能文件核心信息

如上例所示，一个标准的 OpenClaw 技能文件包含六大核心组成部分，它们构成了技能的功能框架：

其中，元数据（Metadata）中的 name（技能的唯一标识符）和 description（Agent选择调用该技能的关键依据）至关重要。

其核心逻辑可归结为一个简洁公式：技能 = 能力描述 + 输入规范 + 执行流程 + 输出范式。

此外，你也可以访问 OpenClaw 的公共技能库（如：clawhub），直接获取或分享成熟的技能。

4.2 完整技能示例

为提供更全面的视角，以下展示一个用于获取AI领域新闻的完整技能示例。该 JSON 结构清晰地展示了各核心模块如何协同工作：

{
“name“: “latest_ai_news“,
“description“: “获取当天AI相关新闻”,
“version“: “1.0.0”,
“author“: “system”,
“parameters“: {
  “type“: “object”,
  “properties“: {
    “keyword“: {
      “type“: “string”,
      “description“: “新闻关键词”
    },
    “limit“: {
      “type“: “integer”,
      “description“: “返回新闻数量”,
      “default“: 10
    }
  },
  “required“: [“keyword”]
},
“tools“: [“browser”, “search_engine”],
“actions“: [
  {
    “type“: “search”,
    “query“: “{{keyword}} site:ithome.com”
  },
  {
    “type“: “extract”,
    “fields“: [“title”, “url”]
  },
  {
    “type“: “summarize”,
    “max_items“: “{{limit}}”
  }
],
“output_format“: {
  “type“: “json”,
  “schema“: {
    “type“: “array”,
    “items“: {
      “type“: “object”,
      “properties“: {
        “title“: { “type“: “string” },
        “url“: { “type“: “string” }
      }
    }
  }
},
“trigger“: {
  “keywords“: [“AI新闻”, “AI资讯”],
  “description“: “当用户查询AI新闻时触发”
}
}