Aller au contenu

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.

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’abordPuis lisez
Permettre à un agent d’agir avec des fonctionnalités existantesOutils intégrésCatégories d’outils
Contrôler ce qu’un agent peut appelerPolitique d’outilOutils et providers personnalisés
Enseigner un flux de travail à un agentSkillsSkills, Creating skills et Skill Workshop
Ajouter une nouvelle intégration ou une nouvelle interface d’exécutionPluginsPlugins et Build plugins
Exécuter du travail plus tard ou en arrière-planAutomationAutomation overview
Coordonner plusieurs agents ou harnaisSub-agentsACP agents et Agent send
Rechercher dans un vaste catalogue d’outils OpenClawTool SearchTool Search

Choisir des outils, des compétences ou des plugins

Section intitulée « Choisir des outils, des compétences ou des plugins »
  1. 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.

  2. Use a skill when the agent needs instructions

    Un skill est un SKILL.md pack 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.

    Skills | Skill Workshop | Creating skills | Skills config

  3. 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.

    Install and configure plugins | Build plugins | Plugin SDK

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égorieUtiliser lorsque l’agent a besoin de…Outils représentatifsÀ lire ensuite
RuntimeExécuter des commandes, gérer des processus ou utiliser l’analyse Python prise en charge par un fournisseurexec, process, code_executionExec, Exécution de code
FichiersLire et modifier les fichiers de l’espace de travailread, write, edit, apply_patchAppliquer le correctif
WebRechercher sur le web, rechercher des publications X ou récupérer le contenu lisible d’une pageweb_search, x_search, web_fetchOutils Web, Récupération Web
NavigateurGérer une session de navigateurbrowserNavigateur
Messagerie et channelsEnvoyer des réponses ou des actions de channelmessageEnvoi d’agent
Sessions et agentsInspecter les sessions, déléguer le travail, orienter une autre exécution ou signaler le statutsessions_*, subagents, agents_list, session_status, goalObjectif, Sous-agents, Outil de session
AutomatisationPlanifier le travail ou répondre aux événements en arrière-plancron, heartbeat_respondAutomatisation
Gateway et nœudsInspecter l’état du Gateway ou des appareils cibles jumelésgateway, nodesGateway configuration, Nodes
MédiasAnalyser, générer ou prononcer des médiasimage, image_generate, music_generate, video_generate, ttsAperçu des médias
Vastes catalogues OpenClawRechercher et appeler de nombreux outils éligibles sans envoyer chaque schéma au modeltool_search_code, tool_search, tool_describeRecherche de tool

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 exec et bash bruyants 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

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.

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.

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

  1. Vérifiez le profil actif, tools.allow, et tools.deny dans Tools and custom providers.
  2. 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.
  3. 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.
  4. Vérifiez si le plugin propriétaire est installé et activé dans Plugins.
  5. Pour les exécutions déléguées, vérifiez les restrictions par agent dans Per-agent sandbox and tool restrictions.
  6. Pour les grands catalogues OpenClaw, confirmez si l’exécution utilise une exposition directe des outils ou Tool Search.
  • 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