Commencer ici
Pour la plupart des agents, commencez par les catégories d’outils intégrées, puis ajustez les règles uniquement lorsque l’agent doit voir moins d’outils ou nécessite un accès explicite à l’hôte.Choisir des outils, des Skills ou des plugins
1
Utiliser un outil lorsque l’agent doit agir
Un outil est une fonction typée que l’agent peut appeler, telle que
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 sont conservés après l’application du profil actif, des règles d’autorisation et de refus,
des restrictions du fournisseur, de l’état du bac à sable, des autorisations du canal et
de la disponibilité des plugins.2
Utiliser une Skill lorsque l’agent a besoin d’instructions
Une Skill est un ensemble 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 reproductible, d’une grille d’évaluation, d’une séquence de commandes ou d’une contrainte
opérationnelle.Les Skills peuvent se trouver dans un espace de travail, un répertoire partagé de Skills, la racine gérée des
Skills OpenClaw ou le paquet d’un plugin.Skills | Atelier Skills | Création de Skills | Configuration des Skills3
Utiliser un plugin lorsqu’OpenClaw a besoin d’une nouvelle fonctionnalité
Un plugin peut ajouter des outils, des Skills, des canaux, des fournisseurs de modèles, de la synthèse vocale,
de la voix en temps réel, de la génération multimédia, de la recherche web, de la récupération web, des hooks et d’autres
fonctionnalités d’exécution. Utilisez un plugin lorsque la fonctionnalité comporte du code,
des identifiants, des hooks de cycle de vie, des métadonnées de manifeste ou un
paquet 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 de Plugin
Catégories d’outils intégrées
Le tableau répertorie des outils représentatifs afin de vous permettre d’identifier la surface concernée. Il ne constitue pas la référence complète des règles. Pour connaître précisément les groupes, les valeurs par défaut et la sémantique des autorisations et refus, utilisez Outils et fournisseurs personnalisés.La recherche d’outils est une surface expérimentale pour les agents OpenClaw. Les exécutions dans l’environnement Codex utilisent
le mode code natif de Codex, la recherche d’outils native, les outils dynamiques différés et
les appels d’outils imbriqués à la place de
tools.toolSearch.Outils fournis par des plugins
Les plugins peuvent enregistrer des outils supplémentaires. Les auteurs de plugins connectent les outils au moyen deapi.registerTool(...) et de contracts.tools dans le manifeste ; consultez le
SDK de Plugin et le manifeste de Plugin
pour en savoir plus sur les contrats.
Les outils couramment fournis par des plugins comprennent :
- Différences pour afficher les différences de fichiers et de Markdown
- Afficher un widget pour intégrer du SVG et du HTML autonomes dans le chat web
- Tâche LLM pour les étapes de workflow produisant uniquement du JSON
- Lobster pour les workflows typés avec des approbations pouvant être reprises
- Tokenjuice pour compacter les sorties bruyantes des outils
execetbash - Recherche d’outils pour découvrir et appeler de vastes catalogues d’outils sans inclure chaque schéma dans le prompt
- Canvas pour le contrôle de Canvas sur les nœuds et le rendu A2UI
Configurer les accès et les approbations
Les règles des outils sont appliquées avant l’appel au modèle. Si les règles suppriment un outil, le modèle ne reçoit pas le schéma de cet outil pour ce tour. Une exécution peut perdre des outils en raison de la configuration globale, de la configuration propre à l’agent, des règles du canal, des restrictions du fournisseur, des règles du bac à sable, des règles du canal ou de l’environnement d’exécution, ou de la disponibilité des plugins.- Outils et fournisseurs personnalisés décrit les profils d’outils, les listes d’autorisation et de refus, les restrictions propres aux fournisseurs, la détection des boucles et les paramètres des outils fournis par les fournisseurs.
- Approbations Exec décrit les règles d’approbation des commandes de l’hôte.
- Exec avec privilèges élevés décrit l’exécution contrôlée en dehors du bac à sable.
- Bac à sable, règles des outils et privilèges élevés explique quelle couche contrôle l’accès aux fichiers et aux processus.
- Bac à sable et restrictions d’outils propres à chaque agent décrit les restrictions propres aux agents pour les exécutions déléguées.
Étendre les fonctionnalités
Choisissez la voie d’extension selon la tâche que vous devez confier à OpenClaw :- 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 réutilisables pour les agents avec Skills et Création de Skills.
- Utilisez le SDK de Plugin et le manifeste de Plugin lorsque vous avez besoin de contrats d’implémentation.
Résoudre les problèmes d’outils manquants
Si le modèle ne peut pas voir ou appeler un outil, commencez par vérifier les règles effectives pour le tour actuel :- Vérifiez le profil actif,
tools.allowettools.denydans 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èles sélectionné prend en charge la structure de l’outil.
- Vérifiez les autorisations du canal, l’état du bac à sable et l’accès avec privilèges élevés à l’aide de Bac à sable, règles des outils et privilèges élevés et Exec avec privilèges élevés.
- 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 propres à chaque agent dans Bac à sable et restrictions d’outils propres à chaque agent.
- Pour les grands catalogues OpenClaw, vérifiez si l’exécution utilise l’exposition directe des outils ou la Recherche d’outils.
Pages connexes
- Automatisation pour Cron, les tâches, Heartbeat, les engagements, les hooks, les ordres permanents et TaskFlow
- Agents pour le modèle d’agent, les sessions, la mémoire et la coordination multi-agents
- Outils et fournisseurs personnalisés pour la référence canonique des politiques d’outils
- Plugins pour l’installation et la gestion des Plugins
- SDK des Plugins comme référence pour les auteurs de Plugins
- Skills pour l’ordre de chargement, le contrôle d’accès et la configuration des Skills
- Atelier de Skills pour créer des Skills générés et révisés
- Recherche d’outils pour parcourir de manière compacte le catalogue d’outils OpenClaw