OpenClaw 作为开源AI交互框架，核心是「技能化调度」，而 Skill（技能）是其最小功能单元。很多新手入门时会混淆 Skill 与 Agent，本文用最简约的语言，讲清 Skill 的核心逻辑、作用、与 Agent 的区别，并附实操示例，快速上手无压力。

第一章：什么是 Skill

Skill（技能）是 OpenClaw 中「可复用、可调用的最小自动化功能模块」，本质是一段封装好的代码，遵循 OpenClaw 规范，实现单一、明确的具体任务。

核心特点（简约总结）：

• 单一职责：只做一件事，不冗余（如“整理文件”“网页搜索”）；

• 可配置：支持传入参数（如整理文件的目标路径）；

• 可复用：一次开发/导入，可多次通过 CLI、面板调用；

• 轻量无依赖（部分需简单依赖）：无需复杂配置，导入即可用。

简单说：Skill 就是 OpenClaw 的「工具」，像螺丝刀、扳手，每一个都对应一个具体操作。

第二章：Skill 有什么作用

Skill 是 OpenClaw 实现自动化、智能化的核心，作用围绕「简化操作、提升效率」，核心有3点：

1. 实现自动化操作，替代手动重复工作

无需手动点击、输入，通过调用 Skill，自动完成重复任务（如批量整理文件、批量生成报告），节省时间。

2. 扩展 OpenClaw 功能边界

OpenClaw 本体仅提供基础框架，通过导入不同 Skill，可实现多样化功能：文件操作、网页搜索、语音转文字、数据计算等，按需扩展，无需修改框架核心代码。

3. 降低使用门槛，无需懂代码也能调用

Skill 已封装好核心逻辑，用户无需编写代码，只需通过 OpenClaw 面板、CLI 传入简单参数，即可调用，新手也能快速上手。

第三章：Skill 与 Agent 的区别

很多新手会混淆两者，核心区别：Skill 是“工具”，Agent 是“使用者”，用简约表格对比更清晰：

对比维度	Skill（技能）	Agent（智能体）
核心定位	具体工具，执行单一任务	决策者，调度多个工具完成复杂任务
功能范围	单一、明确（如整理文件）	复杂、多步骤（如“查天气→生成报告→发送邮件”）
依赖关系	独立存在，可被 Agent 调用	依赖 Skill，无法直接执行具体操作，需调度 Skill
简单类比	螺丝刀、扳手（具体工具）	维修师傅（用工具完成维修任务）

总结：Agent 是“大脑”，负责规划任务；Skill 是“手脚”，负责执行具体操作，两者配合实现复杂自动化。

实操示例：桌面整理大师 Skill

结合前文，用一个极简的 OpenClaw Skill 示例，帮你直观理解——桌面整理大师（仅整理文件，不支持应用软件）。

1. 示例 Skill 核心功能

名称：FileOrganizer（桌面整理大师）

功能：自动扫描电脑桌面，按文件类型分类（文档、图片、视频、压缩包），移动到对应文件夹，支持回滚（恢复原位置）。

限制：仅整理文件（.txt、.pdf、.jpg、.zip 等），不支持移动、整理应用软件（如 .exe 文件、桌面快捷方式）。

2. 核心实现（简约代码，可直接复用）

Skill 目录结构（OpenClaw 标准格式）：

FileOrganizer/
├── skill.yaml  # 技能配置（元信息、入参）
├── main.py     # 核心逻辑（整理、回滚）
└── requirements.txt  # 依赖

（1）skill.yaml（核心配置）

name: FileOrganizer
version: 1.1.0
description: 桌面整理大师，按文件类型分类，不支持应用软件
triggers:
  - type: cli
    command: organize-files
  - type: dashboard
    display_name: 桌面整理大师
inputs:
  - name: target_path
    type: string
    default: ${USER_DESKTOP}
    description: 整理路径（默认桌面）
  - name: rollback
    type: boolean
    default: false
    description: 是否回滚（true=回滚）
outputs:
  - name: result
    type: string
  - name: file_count
    type: int
entry: main.py:organize_files
dependencies:
  - pathlib2>=2.3.7

（2）main.py（核心逻辑，简化版）

import os
import shutil
from pathlib import Path

# 文件类型映射（仅支持以下文件，不包含应用软件）
FILE_TYPE_MAP = {
    "docs": [".txt", ".docx", ".pdf", ".md", ".xlsx"],
    "images": [".jpg", ".png", ".gif", ".svg"],
    "videos": [".mp4", ".avi", ".mov"],
    "archives": [".zip", ".rar", ".7z"],
    "others": []
}

def organize_files(target_path=None, rollback=False):
    # 回滚逻辑（简化）
    if rollback:
        # 读取日志，反向移动文件（前文已实现，此处省略）
        return {"status": "success", "file_count": 0, "result": "回滚完成"}
    
    # 整理逻辑
    target_path = target_path or Path.home() / "Desktop"
    target_path = Path(target_path)
    
    # 创建分类文件夹
    for folder in FILE_TYPE_MAP.keys():
        (target_path / folder).mkdir(exist_ok=True)
    
    file_count = 0
    # 扫描桌面文件，跳过文件夹和应用软件（.exe等）
    for file in target_path.iterdir():
        if file.is_dir() or file.suffix in [".exe", ".lnk"]:
            continue
        # 分类移动文件
        file_suffix = file.suffix.lower()
        for folder, suffixes in FILE_TYPE_MAP.items():
            if file_suffix in suffixes:
                shutil.move(str(file), target_path / folder / file.name)
                file_count += 1
                break
    
    return {
        "status": "success",
        "file_count": file_count,
        "result": f"整理完成，共处理{file_count}个文件"
    }

if __name__ == "__main__":
    print(organize_files())

3. 调用方式（简约步骤）

1. 将 Skill 文件夹导入 OpenClaw（或通过 skills.yaml 手动注册）；

2. 启动 OpenClaw Gateway：openclaw gateway start；

3. CLI 调用整理桌面：openclaw gateway skills run FileOrganizer；

4. CLI 调用回滚：openclaw gateway skills run FileOrganizer --params '{"rollback": true}'。

总结

1. Skill 是 OpenClaw 的最小工具单元，单一职责、可复用；

2. 核心作用是实现自动化、扩展功能、降低使用门槛；

3. 与 Agent 区别：Skill 是“工具”，Agent 是“决策者”；

4. 桌面整理大师示例，直观体现 Skill 的核心逻辑，新手可直接复用、修改。

后续可基于此示例，扩展更多功能（如自定义分类、过滤指定文件），快速上手 OpenClaw Skill 开发与调用。