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 d’aperçu et de routage. Pour une stratégie d’outil exhaustive, les valeurs par défaut, l’appartenance aux groupes, les restrictions de provider et les champs de configuration, utilisez Outils et providers personnalisés.

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	Stratégie d’outil	Outils et providers personnalisés
Enseigner un flux de travail à un agent	Compétences	Compétences et Création de compétences
Ajouter une nouvelle intégration ou une nouvelle interface d’exécution	Plugins	Plugins et Créer des plugins
Exécuter du travail plus tard ou en arrière-plan	Automatisation	Aperçu de l’automatisation
Coordonner plusieurs agents ou harnais	Sous-agents	Agents ACP et Envoi d’agent
Rechercher dans un grand catalogue d’outils PI	Recherche d’outils	Recherche d’outils

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, ou image_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.
Utilisez une compétence lorsque l'agent a besoin d'instructions
Une compétence est un pack d’instructions SKILL.md chargé dans le prompt de l’agent. Utilisez une compétence lorsque l’agent possède déjà les outils dont il a besoin, 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 compétences peuvent résider dans un espace de travail, un répertoire de compétences partagé, la racine de compétences gérée par OpenClaw, ou un package de plugin.

Compétences | Création de compétences | Configuration des compétences
Utilisez un plugin lorsque OpenClaw a besoin d'une nouvelle capacité
Un plugin peut ajouter des outils, des compétences, des channels, des providers de model, de la parole, de la voix en temps réel, de la génération de média, 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é possède du code, des identifiants, 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.

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

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, consultez 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 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	Gérer une session de navigateur	`browser`	Navigateur
Messagerie et channels	Envoyer des réponses ou des actions de channel	`message`	Envoi par l’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`	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`	Configuration du Gateway, Nœuds
Médias	Analyser, générer ou prononcer des médias	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Aperçu des médias
Grands catalogues PI	Rechercher et appeler de nombreux outils éligibles sans envoyer chaque schéma au model	`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 connectent les outils 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 différences de fichiers et de markdown
Tâche LLM pour les étapes de workflow JSON uniquement
Lobster pour les workflows typés avec des approbations repriseables
Tokenjuice pour compacter la sortie bruyante des outils exec et bash
Recherche d’outils pour découvrir et appeler de vastes catalogues d’outils sans mettre 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 stratégie d’outil est appliquée avant l’appel du model. Si la stratégie supprime un outil, le model ne reçoit pas le schéma de cet outil pour le tour. Une exécution peut perdre des outils 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, du filtrage propriétaire uniquement, ou de la disponibilité des plugins.

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

É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 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.
Empaquetez du matériel de workflow réutilisable avec Skill workshop lorsque le workflow appartient à un bundle de skills distribué par plugin.
Utilisez Plugin SDK et Plugin manifest 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 stratégie effective pour le tour actuel :

Vérifiez le profil actif, tools.allow, et tools.deny dans Outils et providers personnalisés.
Vérifiez les restrictions spécifiques aux providers dans Outils et providers personnalisés et confirmez que le model provider sélectionné prend en charge la forme de l’outil.
Vérifiez les permissions du channel, l’état du sandbox et l’accès élevé avec Sandbox vs politique d’outil 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 Restrictions de bac à sable et d’outils par agent.
Pour les catalogues PI volumineux, confirmez si l’exécution utilise une exposition directe des outils ou Recherche d’outils.

Connexes

Automatisation pour cron, tâches, heartbeat, engagements, hooks, ordres permanents 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 la stratégie d’outils
Plugins pour l’installation et la gestion des plugins
Plugin SDK pour la référence de l’auteur de plugin
Skills pour l’ordre de chargement, le filtrage et la configuration des compétences
Recherche d’outils pour la découverte compacte du catalogue d’outils PI