如何构建自定义 OpenClaw Skill — 逐步指南

简介

OpenClaw skills 是将工具暴露给代理的 MCP (Model Context Protocol) 服务器。构建 skill 时，您正在为代理提供新的功能——从访问 API 到控制硬件到处理文件。Skills 是使 OpenClaw 代理执行超出对话范围的操作的主要方式。

先决条件

已安装 Node.js 18+ 或 Python 3.10+
基本编程知识（推荐 TypeScript 或 Python）
一个具有用于测试的活跃代理的 KiwiClaw 帐户
熟悉 OpenClaw 架构

逐步说明

步骤 1：了解 Skill 格式

OpenClaw skill 是一个暴露一个或多个工具的 MCP 服务器。每个工具都有一个名称、描述、输入模式和一个处理函数。代理发现可用的工具并根据对话上下文决定何时调用它们。

步骤 2：设置您的开发环境

创建一个新的项目目录。如果使用 TypeScript，请使用 npm init 初始化并安装 MCP SDK。如果使用 Python，请设置一个虚拟环境并安装 MCP Python 包。

步骤 3：创建 Skill 清单

定义 skill 的元数据：名称、版本、描述、作者以及它提供的工具列表。此清单告诉 OpenClaw 您的 skill 可以做什么。

步骤 4：编写您的工具处理程序

为每个工具实现函数。工具处理程序接收输入参数并返回结果。例如，天气 skill 可能会接受城市名称并通过调用天气 API 返回当前天气预报。

步骤 5：在本地进行测试

在本地运行您的 skill 并针对您的 KiwiClaw 代理对其进行测试。通过指向您的本地服务器，使用仪表板的 Skills 页面安装 skill。验证每个工具是否正常工作。

步骤 6：发布到市场

当您的 skill 准备就绪时，将其提交到 KiwiClaw Skills Marketplace。我们的团队会审查提交内容的安全性和质量。获得批准后，其他用户可以安装您的 skill。您可以将其设置为免费或付费。

专业提示

从 Skill Creator 开始 -- 这个元 skill 可以帮助您的代理构建其他 skill，为您生成样板代码。
保持工具专注 -- 每个工具都应该做好一件事。多个小型工具比一个复杂工具更好。
优雅地处理错误 -- 返回信息丰富的错误消息，以便代理可以向用户解释出了什么问题。
添加好的描述 -- 代理使用工具描述来决定何时调用它们。清晰、具体的描述可以带来更好的工具选择。

常见问题解答

What programming language can I use for OpenClaw skills?

OpenClaw skills are MCP servers, so you can use any language that supports the MCP protocol. Most skills are written in TypeScript or Python, but Go, Rust, and other languages work too.

Can I monetize my OpenClaw skill?

Yes. Publish your skill to the KiwiClaw marketplace and set a price. KiwiClaw handles payments, distribution, and reviews. You earn revenue every time someone installs your paid skill. See our publishing guide for details.

How are skills reviewed for security?

All marketplace submissions go through KiwiClaw's vetting process. We review the source code, check for malicious behavior, verify permissions, and test functionality before approving a skill for the marketplace.

简介