Como Criar uma Habilidade OpenClaw Personalizada

Introdução

As habilidades OpenClaw são servidores MCP (Model Context Protocol) que expõem ferramentas ao agente. Quando você cria uma habilidade, você está dando ao seu agente novas capacidades -- desde o acesso a APIs até o controle de hardware e o processamento de arquivos. As habilidades são a principal maneira de fazer seu agente OpenClaw fazer coisas além da conversação.

Pré-requisitos

• Node.js 18+ ou Python 3.10+ instalado
• Conhecimento básico de programação (TypeScript ou Python recomendado)
• Uma conta KiwiClaw com um agente ativo para teste
• Familiaridade com a arquitetura OpenClaw

Instruções Passo a Passo

Passo 1: Entenda o Formato da Habilidade

Uma habilidade OpenClaw é um servidor MCP que expõe uma ou mais ferramentas. Cada ferramenta tem um nome, descrição, esquema de entrada e uma função de manipulador. O agente descobre as ferramentas disponíveis e decide quando chamá-las com base no contexto da conversa.

Passo 2: Configure Seu Ambiente de Desenvolvimento

Crie um novo diretório de projeto. Se estiver usando TypeScript, inicialize com npm init e instale o MCP SDK. Se estiver usando Python, configure um ambiente virtual e instale o pacote MCP Python.

Passo 3: Crie o Manifesto da Habilidade

Defina os metadados da sua habilidade: nome, versão, descrição, autor e a lista de ferramentas que ela fornece. Este manifesto diz ao OpenClaw o que sua habilidade pode fazer.

Passo 4: Escreva Seus Manipuladores de Ferramentas

Implemente as funções para cada ferramenta. Um manipulador de ferramentas recebe parâmetros de entrada e retorna um resultado. Por exemplo, uma habilidade de clima pode aceitar o nome de uma cidade e retornar a previsão atual chamando uma API de clima.

Passo 5: Teste Localmente

Execute sua habilidade localmente e teste-a em relação ao seu agente KiwiClaw. Instale a habilidade usando a página Habilidades do painel, apontando para o seu servidor local. Verifique se cada ferramenta funciona corretamente.

Passo 6: Publique no Marketplace

Quando sua habilidade estiver pronta, envie-a para o KiwiClaw Skills Marketplace. Nossa equipe analisa os envios quanto à segurança e qualidade. Uma vez aprovado, outros usuários podem instalar sua habilidade. Você pode configurá-la como gratuita ou paga.

Dicas Profissionais

• Comece com o Criador de Habilidades -- Esta meta-habilidade ajuda seu agente a criar outras habilidades, gerando código boilerplate para você.
• Mantenha as ferramentas focadas -- Cada ferramenta deve fazer uma coisa bem. Várias ferramentas pequenas são melhores do que uma ferramenta complexa.
• Lide com erros graciosamente -- Retorne mensagens de erro informativas para que o agente possa explicar o que deu errado para o usuário.
• Adicione boas descrições -- O agente usa descrições de ferramentas para decidir quando chamá-las. Descrições claras e específicas levam a uma melhor seleção de ferramentas.

Perguntas Frequentes

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?

Sim. Publique sua habilidade no marketplace KiwiClaw e defina um preço. A KiwiClaw lida com pagamentos, distribuição e avaliações. Você ganha receita toda vez que alguém instala sua habilidade paga. Consulte nosso guia de publicação para obter detalhes.

How are skills reviewed for security?

Todas as submissões ao marketplace passam pelo processo de avaliação da KiwiClaw. Revisamos o código-fonte, verificamos comportamentos maliciosos, verificamos permissões e testamos a funcionalidade antes de aprovar uma habilidade para o marketplace.