Aperçu
Utilisez cette page pour choisir la bonne interface de fonctionnalités. Les outils sont des actions appelables, les compétences enseignent aux agents comment travailler, et les plugins ajoutent des fonctionnalités d’exécution telles que des outils, des providers, des canaux, des hooks et des compétences empaquetées.
Il s’agit d’une page de présentation et d’orientation. Pour une politique d’outil exhaustive, les valeurs par défaut, l’appartenance au groupe, les restrictions de provider et les champs de configuration, utilisez Outils et providers personnalisés.
Commencer ici
Section intitulée « Commencer ici »Pour la plupart des agents, commencez par les catégories d’outils intégrés, puis ajustez la stratégie uniquement lorsque l’agent doit voir moins d’outils ou a besoin d’un accès explicite à l’hôte.
| Si vous devez… | Utilisez ceci d’abord | Puis lisez |
|---|---|---|
| Permettre à un agent d’agir avec des fonctionnalités existantes | Outils intégrés | Catégories d’outils |
| Contrôler ce qu’un agent peut appeler | Politique d’outil | Outils et providers personnalisés |
| Enseigner un flux de travail à un agent | Skills | Skills, Creating skills et Skill Workshop |
| Ajouter une nouvelle intégration ou une nouvelle interface d’exécution | Plugins | Plugins et Build plugins |
| Exécuter du travail plus tard ou en arrière-plan | Automation | Automation overview |
| Coordonner plusieurs agents ou harnais | Sub-agents | ACP agents et Agent send |
| Rechercher dans un vaste catalogue d’outils OpenClaw | Tool Search | Tool Search |
Choisir des outils, des compétences ou des plugins
Section intitulée « Choisir des outils, des compétences ou des plugins »Utilisez 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, ouimage_generate. Utilisez des outils lorsque l’agent doit lire des données, modifier des fichiers, envoyer des messages, appeler un provider, ou exploiter un autre système. Les outils visibles sont envoyés au model sous forme de définitions de fonctions structurées.Le model ne voit que les outils qui survivent au profil actif, à la politique d’autorisation/refus, aux restrictions du provider, à l’état du bac à sable, aux autorisations du channel, et à la disponibilité des plugins.
Use a skill when the agent needs instructions
Un skill est un
SKILL.mdpack d’instructions chargé dans le prompt de l’agent. Utilisez un skill lorsque l’agent dispose déjà des outils nécessaires, mais a besoin d’un workflow répétable, d’une grille d’évaluation, d’une séquence de commandes ou d’une contrainte opérationnelle.Les skills peuvent résider dans un espace de travail, un répertoire de skills partagé, une racine de skill OpenClaw gérée, ou un package de plugin.
Use a plugin when OpenClaw needs a new capability
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é a du code, des informations d’identification, des hooks de cycle de vie, des métadonnées de manifeste ou un conditionnement installable. Les plugins existants peuvent être installés depuis ClawHub, npm, git, des répertoires locaux ou des archives.
Catégories d’outils intégrés
Section intitulée « Catégories d’outils intégrés »Le tableau répertorie des outils représentatifs afin que vous puissiez reconnaître la surface. Il ne s’agit pas de la référence complète de la stratégie. 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 a besoin de… | Outils représentatifs | À lire ensuite |
|---|---|---|---|
| Runtime | Exécuter des commandes, gérer des processus ou utiliser l’analyse Python prise en charge par un fournisseur | exec, process, code_execution | Exec, Exécution de code |
| Fichiers | Lire et modifier les fichiers de l’espace de travail | read, write, edit, apply_patch | Appliquer le correctif |
| 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 | Gérer une session de navigateur | browser | Navigateur |
| Messagerie et channels | Envoyer des réponses ou des actions de channel | message | Envoi d’agent |
| Sessions et agents | Inspecter les sessions, déléguer le travail, orienter une autre exécution ou signaler le statut | sessions_*, subagents, agents_list, session_status, goal | Objectif, Sous-agents, Outil de session |
| Automatisation | Planifier le travail ou répondre aux événements en arrière-plan | cron, heartbeat_respond | Automatisation |
| Gateway et nœuds | Inspecter l’état du Gateway ou des appareils cibles jumelés | gateway, nodes | Gateway configuration, Nodes |
| Médias | Analyser, générer ou prononcer des médias | image, image_generate, music_generate, video_generate, tts | Aperçu des médias |
| Vastes catalogues OpenClaw | Rechercher et appeler de nombreux outils éligibles sans envoyer chaque schéma au model | tool_search_code, tool_search, tool_describe | Recherche de tool |
Outils fournis par des plugins
Section intitulée « Outils fournis par des plugins »Les plugins peuvent enregistrer des tools supplémentaires. Les auteurs de plugins connectent les tools via
api.registerTool(...) et le contracts.tools du manifeste ; utilisez
le Plugin SDK et le Plugin manifest
pour les détails du contrat.
Les outils courants fournis par des plugins incluent :
- Diffs pour le rendu des diffs de fichiers et de markdown
- Tâche LLM pour les étapes de workflow JSON uniquement
- Lobster pour les workflows typés avec des approbations reprises
- Tokenjuice pour compacter les outils
execetbashbruyants en sortie - Tool Search pour découvrir et appeler de vastes catalogues d’outils sans inclure chaque schéma dans l’invite
- Canvas pour le contrôle du Canvas de nœud et le rendu A2UI
Configurer l’accès et les approbations
Section intitulée « Configurer l’accès et les approbations »La stratégie relative aux tools est appliquée avant l’appel au modèle. Si la stratégie supprime un tool, le modèle ne reçoit pas le schéma de ce tool pour ce tour. Une exécution peut perdre des tools en raison de la configuration globale, de la configuration par agent, de la stratégie de channel, des restrictions de provider, des règles de sandbox, de la stratégie de channel/runtime, ou de la disponibilité des plugins.
- Tools and custom providers documente les profils d’outils, les listes d’autorisation/refus, les restrictions spécifiques au provider, la détection de boucles et les paramètres d’outils soutenus par le provider.
- Exec approvals documents la stratégie d’approbation des commandes de l’hôte.
- Elevated exec documents l’exécution contrôlée en dehors du sandbox.
- Sandbox vs tool policy vs elevated explique quelle couche contrôle l’accès aux fichiers et aux processus.
- Per-agent sandbox and tool restrictions documente les restrictions spécifiques aux agents pour les exécutions déléguées.
Étendre les capacités
Section intitulée « Étendre les capacités »Choisissez le chemin d’extension en fonction de la tâche que vous devez faire accomplir à OpenClaw :
- Installez ou gérez un plugin existant avec Plugins.
- Créez une nouvelle intégration, un provider, un channel, un tool ou un hook avec Build plugins.
- Ajoutez ou ajustez des instructions d’agent réutilisables avec Skills et Creating skills.
- Utilisez Plugin SDK et Plugin manifest lorsque vous avez besoin de contrats d’implémentation.
Dépanner les outils manquants
Section intitulée « Dépanner les outils manquants »Si le modèle ne peut pas voir ou appeler un outil, commencez par la stratégie effective pour le tour actuel :
- Vérifiez le profil actif,
tools.allow, ettools.denydans Tools and custom providers. - Vérifiez les restrictions spécifiques au provider dans Tools and custom providers et confirmez que le model provider sélectionné prend en charge la forme du tool.
- Vérifiez les autorisations du channel, l’état du sandbox et l’accès élevé avec Sandbox vs tool policy vs elevated et Elevated exec.
- 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 Per-agent sandbox and tool restrictions.
- Pour les grands catalogues OpenClaw, confirmez si l’exécution utilise une exposition directe des outils ou Tool Search.
Connexes
Section intitulée « Connexes »- Automation pour cron, tâches, heartbeat, engagements, hooks, ordres permanents et Task Flow
- Agents pour le model d’agent, les sessions, la mémoire et la coordination multi-agent
- Outils et fournisseurs personnalisés pour la référence de stratégie tool canonique
- Plugins pour l’installation et la gestion des plugins
- Plugin SDK pour la référence de création de plugins
- Skills pour l’ordre de chargement, la restriction et la configuration des skills
- Skill Workshop pour la création de skills générée et vérifiée
- Tool Search pour la découverte compacte du catalogue tool OpenClaw