Overview

Présentation

Utilisez cette page pour choisir la bonne surface de capacités. Les outils sont des actions appelables, les Skills apprennent aux agents comment travailler, et les plugins ajoutent des capacités d’exécution telles que des outils, des fournisseurs, des canaux, des hooks et des Skills empaquetées.

Il s’agit d’une page de vue d’ensemble et d’orientation. Pour la politique exhaustive des outils, les valeurs par défaut, l’appartenance aux groupes, les restrictions de fournisseurs et les champs de configuration, utilisez Outils et fournisseurs personnalisés.

Commencer ici

Pour la plupart des agents, commencez par les catégories d’outils intégrées, puis ajustez la politique uniquement lorsque l’agent doit voir moins d’outils ou a besoin d’un accès explicite à l’hôte.

Si vous devez...	Utilisez d’abord ceci	Puis lisez
Permettre à un agent d’agir avec les capacités existantes	Outils intégrés	Catégories d’outils
Contrôler ce qu’un agent peut appeler	Politique des outils	Outils et fournisseurs personnalisés
Enseigner un workflow à un agent	Skills	Skills, Créer des Skills, et Atelier Skill
Ajouter une nouvelle intégration ou surface d’exécution	Plugins	Plugins et Créer des plugins
Exécuter du travail plus tard ou en arrière-plan	Automatisation	Vue d’ensemble de l’automatisation
Coordonner plusieurs agents ou harnais	Sous-agents	Agents ACP et Envoi par agent
Rechercher dans un grand catalogue d’outils OpenClaw	Recherche d’outils	Recherche d’outils

Choisir des outils, des Skills ou des plugins

Utilisez un outil lorsque l’agent doit agir

Un outil est une fonction typée que l’agent peut appeler, comme exec, browser, web_search, message ou image_generate. Utilisez des outils lorsque l’agent doit lire des données, modifier des fichiers, envoyer des messages, appeler un fournisseur ou piloter un autre système. Les outils visibles sont envoyés au modèle sous forme de définitions de fonctions structurées.

Le modèle ne voit que les outils qui survivent au profil actif, à la politique d’autorisation/refus, aux restrictions de fournisseur, à l’état du sandbox, aux autorisations de canal et à la disponibilité des plugins.

Utilisez une Skill lorsque l’agent a besoin d’instructions

Une Skill est un pack d’instructions SKILL.md chargé dans le prompt de l’agent. Utilisez une Skill lorsque l’agent dispose déjà des outils nécessaires, mais a besoin d’un workflow répétable, d’une grille de revue, d’une séquence de commandes ou d’une contrainte opérationnelle.

Les Skills peuvent résider dans un workspace, un répertoire de Skills partagé, une racine de Skills OpenClaw gérée ou un package de plugin.

Skills | Atelier Skill | Créer des Skills | Configuration des Skills

Utilisez un plugin lorsqu’OpenClaw a besoin d’une nouvelle capacité

Un plugin peut ajouter des outils, des Skills, des canaux, des fournisseurs de modèles, de la parole, de la voix en temps réel, de la génération de médias, de la recherche web, de la récupération web, des hooks et d’autres capacités d’exécution. Utilisez un plugin lorsque la capacité implique du code, des identifiants, des hooks de cycle de vie, des métadonnées de manifeste ou un empaquetage installable. Les plugins existants peuvent être installés depuis ClawHub, npm, git, des répertoires locaux ou des archives.

Installer et configurer des plugins | Créer des plugins | SDK Plugin

Catégories d’outils intégrées

Le tableau liste des outils représentatifs afin que vous puissiez reconnaître la surface. Ce n’est pas la référence complète de politique. Pour les groupes exacts, les valeurs par défaut et la sémantique d’autorisation/refus, utilisez Outils et fournisseurs personnalisés.

Catégorie	À utiliser lorsque l’agent doit...	Outils représentatifs	Lire ensuite
Exécution	Exécuter des commandes, gérer des processus ou utiliser l’analyse Python adossée à un fournisseur	`exec`, `process`, `code_execution`	Exec, Exécution de code
Fichiers	Lire et modifier les fichiers du workspace	`read`, `write`, `edit`, `apply_patch`	Appliquer un patch
Web	Rechercher sur le web, rechercher des publications X ou récupérer le contenu lisible d’une page	`web_search`, `x_search`, `web_fetch`	Outils web, Récupération web
Navigateur	Piloter une session de navigateur	`browser`	Navigateur
Messagerie et canaux	Envoyer des réponses ou des actions de canal	`message`	Envoi par agent
Sessions et agents	Inspecter des sessions, déléguer du travail, orienter une autre exécution ou signaler l’état	`sessions_*`, `subagents`, `agents_list`, `session_status`, `goal`	Objectif, Sous-agents, Outil de session
Automatisation	Planifier du travail ou répondre à des événements d’arrière-plan	`cron`, `heartbeat_respond`	Automatisation
Gateway et nœuds	Inspecter l’état du Gateway ou des appareils cibles appairés	`gateway`, `nodes`	Configuration du Gateway, Nœuds
Médias	Analyser, générer ou énoncer des médias	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Vue d’ensemble des médias
Grands catalogues OpenClaw	Rechercher et appeler de nombreux outils éligibles sans envoyer chaque schéma au modèle	`tool_search_code`, `tool_search`, `tool_describe`	Recherche d’outils

Outils fournis par des plugins

Les plugins peuvent enregistrer des outils supplémentaires. Les auteurs de plugins câblent les outils via api.registerTool(...) et contracts.tools du manifeste ; utilisez le SDK Plugin et le Manifeste de plugin pour les détails de contrat.

Les outils couramment fournis par des plugins incluent :

Diffs pour afficher les diffs de fichiers et de markdown
Tâche LLM pour les étapes de workflow uniquement en JSON
Lobster pour les workflows typés avec approbations reprenables
Tokenjuice pour compacter la sortie bruyante des outils exec et bash
Recherche d’outils pour découvrir et appeler de grands catalogues d’outils sans placer chaque schéma dans le prompt
Canvas pour le contrôle de Canvas de nœud et le rendu A2UI

Configurer l’accès et les approbations

La politique des outils est appliquée avant l’appel au modèle. Si la politique retire un outil, le modèle ne reçoit pas le schéma de cet outil pour le tour. Une exécution peut perdre des outils à cause de la configuration globale, de la configuration par agent, de la politique de canal, des restrictions de fournisseur, des règles de sandbox, de la politique de canal/exécution ou de la disponibilité des plugins.

Outils et fournisseurs personnalisés documente les profils d’outils, les listes d’autorisation/refus, les restrictions propres aux fournisseurs, la détection de boucles et les paramètres d’outils adossés à un fournisseur.
Approbations exec documente la politique d’approbation des commandes hôte.
Exec élevé documente l’exécution contrôlée en dehors du sandbox.
Sandbox vs politique d’outils vs élevé explique quelle couche contrôle l’accès aux fichiers et aux processus.
Sandbox et restrictions d’outils par agent documente les restrictions propres aux agents pour les exécutions déléguées.

Étendre les capacités

Choisissez le chemin d’extension selon la tâche qu’OpenClaw doit accomplir :

Installez ou gérez un plugin existant avec Plugins.
Créez une nouvelle intégration, un fournisseur, un canal, un outil ou un hook avec Créer des plugins.
Ajoutez ou ajustez des instructions d’agent réutilisables avec Skills et Créer des Skills.
Utilisez le SDK Plugin et le Manifeste de plugin lorsque vous avez besoin de contrats d’implémentation.

Dépanner les outils manquants

Si le modèle ne peut pas voir ou appeler un outil, commencez par la politique effective pour le tour actuel :

Vérifiez le profil actif, tools.allow et tools.deny dans Outils et fournisseurs personnalisés.
Vérifiez les restrictions propres au fournisseur dans Outils et fournisseurs personnalisés et confirmez que le fournisseur de modèle sélectionné prend en charge la forme de l’outil.
Vérifiez les autorisations de canal, l’état du sandbox et l’accès élevé avec Sandbox vs politique d’outils vs élevé et Exec élevé.
Vérifiez si le plugin propriétaire est installé et activé dans Plugins.
Pour les exécutions déléguées, vérifiez les restrictions par agent dans Sandbox et restrictions d’outils par agent.
Pour les grands catalogues OpenClaw, confirmez si l’exécution utilise l’exposition directe des outils ou la Recherche d’outils.

Connexe

Automatisation pour cron, les tâches, Heartbeat, les engagements, les hooks, les consignes permanentes et Task Flow
Agents pour le modèle d’agent, les sessions, la mémoire et la coordination multi-agent
Outils et fournisseurs personnalisés pour la référence canonique de politique des outils
Plugins pour l’installation et la gestion des plugins
SDK Plugin pour la référence destinée aux auteurs de plugins
Skills pour l’ordre de chargement, le filtrage et la configuration des Skills
Atelier Skill pour la création de Skills générées et relues
Recherche d’outils pour la découverte compacte du catalogue d’outils OpenClaw

Was this useful?