Comment créer une compétence OpenClaw personnalisée

Introduction

Les compétences OpenClaw sont des serveurs MCP (Model Context Protocol) qui exposent des outils à l'agent. Lorsque vous créez une compétence, vous donnez à votre agent de nouvelles capacités, allant de l'accès aux API au contrôle du matériel en passant par le traitement des fichiers. Les compétences sont le principal moyen de faire faire à votre agent OpenClaw des choses qui vont au-delà de la conversation.

Prérequis

• Node.js 18+ ou Python 3.10+ installé
• Connaissances de base en programmation (TypeScript ou Python recommandé)
• Un compte KiwiClaw avec un agent actif pour les tests
• Familiarité avec l'architecture OpenClaw

Instructions étape par étape

Étape 1 : Comprendre le format de la compétence

Une compétence OpenClaw est un serveur MCP qui expose un ou plusieurs outils. Chaque outil a un nom, une description, un schéma d'entrée et une fonction de gestion. L'agent découvre les outils disponibles et décide quand les appeler en fonction du contexte de la conversation.

Étape 2 : Configurer votre environnement de développement

Créez un nouveau répertoire de projet. Si vous utilisez TypeScript, initialisez avec npm init et installez le SDK MCP. Si vous utilisez Python, configurez un environnement virtuel et installez le package MCP Python.

Étape 3 : Créer le manifeste de la compétence

Définissez les métadonnées de votre compétence : nom, version, description, auteur et la liste des outils qu'elle fournit. Ce manifeste indique à OpenClaw ce que votre compétence peut faire.

Étape 4 : Écrire vos gestionnaires d'outils

Implémentez les fonctions pour chaque outil. Un gestionnaire d'outils reçoit des paramètres d'entrée et renvoie un résultat. Par exemple, une compétence météorologique peut accepter un nom de ville et renvoyer les prévisions actuelles en appelant une API météorologique.

Étape 5 : Tester localement

Exécutez votre compétence localement et testez-la par rapport à votre agent KiwiClaw. Installez la compétence en utilisant la page Compétences du tableau de bord en pointant vers votre serveur local. Vérifiez que chaque outil fonctionne correctement.

Étape 6 : Publier sur le marché

Lorsque votre compétence est prête, soumettez-la au marché des compétences KiwiClaw. Notre équipe examine les soumissions pour la sécurité et la qualité. Une fois approuvée, d'autres utilisateurs peuvent installer votre compétence. Vous pouvez la définir comme gratuite ou payante.

Conseils de pro

• Commencez avec le Créateur de compétences -- Cette méta-compétence aide votre agent à créer d'autres compétences, en générant du code passe-partout pour vous.
• Gardez les outils ciblés -- Chaque outil doit bien faire une chose. Plusieurs petits outils sont meilleurs qu'un outil complexe.
• Gérez les erreurs avec élégance -- Renvoyez des messages d'erreur informatifs afin que l'agent puisse expliquer ce qui s'est mal passé à l'utilisateur.
• Ajoutez de bonnes descriptions -- L'agent utilise les descriptions des outils pour décider quand les appeler. Des descriptions claires et spécifiques conduisent à une meilleure sélection des outils.

Questions fréquemment posées

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?

Oui. Publiez votre compétence sur le marché KiwiClaw et fixez un prix. KiwiClaw gère les paiements, la distribution et les évaluations. Vous gagnez des revenus chaque fois que quelqu'un installe votre compétence payante. Consultez notre guide de publication pour plus de détails.

How are skills reviewed for security?

Toutes les soumissions au marché passent par le processus de vérification de KiwiClaw. Nous examinons le code source, vérifions tout comportement malveillant, vérifions les autorisations et testons la fonctionnalité avant d'approuver une compétence pour le marché.