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 SkillsUtilisez 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 |
La Recherche d’outils est une surface expérimentale d’agent OpenClaw. Les exécutions avec le harnais 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 au lieu de
tools.toolSearch.Outils fournis par des plugins
Les plugins peuvent enregistrer des outils supplémentaires. Les auteurs de plugins câblent les outils viaapi.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
execetbash - 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.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è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