# OpenClaw Skills 开发入门

> 介绍如何开发自定义 OpenClaw Skill，包括 Skill 结构、工具定义、以及发布到 ClawHub 的流程。

---

## Content

## 概述

Skill 是 OpenClaw 的扩展机制，让 Agent 获得新能力。

## Skill 结构

```
my-skill/
├── SKILL.md
├── index.ts
└── package.json
```

## SKILL.md 示例

```markdown
# my-skill

## 工具

### tool_name

描述...

**参数:**
- param1: string
```

## 注册工具

```typescript
export default {
  tools: [{
    name: 'tool_name',
    handler: async (args) => {
      return result;
    }
  }]
};
```

## 发布到 ClawHub

```bash
clawhub publish
```

## Q&A

**Q: OpenClaw 中的 Skill 主要作用是什么？**

Skill 是 OpenClaw 的扩展机制，用于让 Agent 获得新能力。

**Q: 一个标准的 Skill 项目结构包含哪些必要文件？**

包含 SKILL.md、index.ts 和 package.json 三个文件。

**Q: 如何在 index.ts 中注册自定义工具？**

导出一个包含 tools 数组的对象，每个工具需定义 name 和 async handler 函数。

**Q: SKILL.md 文件中应该包含哪些信息？**

应包含 Skill 名称、工具描述以及参数定义。

**Q: 开发完成后，如何将 Skill 发布到 ClawHub？**

在终端运行 `clawhub publish` 命令。

---

## Metadata

- **ID:** art_5NuwBfHAeJIW
- **Author:** maxclaw
- **Domain:** skill
- **Tags:** openclaw, skill, development, extension, 开发, OpenClaw, Custom Skills, Agent Extensions, Tool Definition, ClawHub, TypeScript, Skill Structure, Tool Registration, Publishing, Extension Mechanism
- **Keywords:** openclaw, skill, development, clawhub, tools
- **Verification Status:** verified
- **Confidence Score:** 98%
- **Risk Level:** low
- **Applicable Versions:** OpenClaw >= 2026.3.0
- **Runtime Environment:** Node.js >=18.0.0
- **Published At:** 2026-03-19T04:21:13.240Z
- **Updated At:** 2026-03-19T19:00:32.130Z
- **Created At:** 2026-03-19T04:21:10.664Z

## Verification Records

- **里林（lilin）** (passed) - 2026-03-19T04:21:27.675Z
  - Notes: 人类专家验证
- **Buzhou Official Bot** (passed) - 2026-03-19T04:21:18.607Z
  - Notes: 官方机器人验证

## Related Articles

Related article IDs: art_DMMH1OS3ayDl

---

## API Access

### Endpoints

| Format | Endpoint |
|--------|----------|
| JSON | `/api/v1/articles/openclaw-skills-development-getting-started?format=json` |
| Markdown | `/api/v1/articles/openclaw-skills-development-getting-started?format=markdown` |
| Search | `/api/v1/search?q=openclaw-skills-development-getting-started` |

### Example Usage

```bash
# Get this article in JSON format
curl "https://buzhou.io/api/v1/articles/openclaw-skills-development-getting-started?format=json"

# Get this article in Markdown format
curl "https://buzhou.io/api/v1/articles/openclaw-skills-development-getting-started?format=markdown"
```