Recherche d’outils

const hits = await openclaw.tools.search("create a GitHub issue");
const tool = await openclaw.tools.describe(hits[0].id);
return await openclaw.tools.call(tool.id, {
  title: "Crash on startup",
  body: "Steps to reproduce...",
});

​

Déroulement d’un tour

1. Résoudre la politique d’outils active pour l’agent, le profil, le bac à sable et la session.
2. Répertorier les outils OpenClaw et de Plugin admissibles.
3. Répertorier les outils MCP admissibles par l’intermédiaire de l’environnement d’exécution MCP de la session.
4. Ajouter les outils client admissibles fournis pour l’exécution en cours.
5. Garder les outils exclusivement directs visibles par le modèle et indexer les descripteurs compacts des autres outils admissibles au catalogue.
6. Exposer le pont de code OpenClaw, les outils structurés de repli ou la surface d’annuaire compacte avec ces outils exclusivement directs.

​

Modes

• code : expose tool_search_code, le pont JavaScript compact par défaut, avec les outils exclusivement directs.
• tools : expose tool_search, tool_describe et tool_call sous forme d’outils structurés simples pour les fournisseurs qui ne doivent pas recevoir de code, avec les outils exclusivement directs.
• directory : expose tool_search, tool_describe et tool_call, ainsi qu’un annuaire borné dans le prompt contenant les noms et descriptions des outils disponibles, pour les fournisseurs qui doivent voir les noms des outils sans recevoir tous leurs schémas complets. OpenClaw peut également exposer directement un petit ensemble borné de schémas d’outils probables ou requis pour le tour en cours. Les outils exclusivement directs restent également visibles dans ce mode.

​

Raison d’être

• outils directs : le modèle voit chaque schéma sélectionné avant le premier jeton
• mode code de la recherche d’outils : le modèle voit un outil de code compact, un court contrat d’API et tous les outils exclusivement directs
• mode outils de la recherche d’outils : le modèle voit trois outils structurés compacts de repli, ainsi que tous les outils exclusivement directs
• mode annuaire de la recherche d’outils : le modèle voit un annuaire borné, des contrôles de recherche, de description et d’appel, ainsi qu’un petit ensemble borné de schémas probables ou requis, en plus de tous les outils exclusivement directs
• pendant le tour : le modèle peut charger les schémas restants selon ses besoins

​

API

const hits = await openclaw.tools.search("calendar event", { limit: 5 });

const calendarCreate = await openclaw.tools.describe("mcp:calendar:create_event");

await openclaw.tools.call(calendarCreate.id, {
  summary: "Planning",
  start: "2026-05-09T14:00:00Z",
});

• tool_search
• tool_describe
• tool_call

• tool_search
• tool_describe
• tool_call

​

Limite de l’environnement d’exécution

• console.log, console.warn et console.error
• openclaw.tools.search
• openclaw.tools.describe
• openclaw.tools.call

• politiques d’autorisation et de refus des outils
• restrictions d’outils propres à chaque agent et à chaque bac à sable
• politique d’outils du canal et de l’environnement d’exécution
• hooks d’approbation
• hooks before_tool_call des Plugins
• identité de session, journaux et télémétrie

​

Configuration

openclaw config set tools.toolSearch true

{
  tools: {
    toolSearch: true,
  },
}

{
  tools: {
    toolSearch: {
      mode: "tools",
    },
  },
}

{
  tools: {
    toolSearch: {
      mode: "directory",
    },
  },
}

{
  tools: {
    toolSearch: {
      mode: "code",
      codeTimeoutMs: 10000,
      searchDefaultLimit: 8,
      maxSearchLimit: 20,
    },
  },
}

{
  tools: {
    toolSearch: false,
  },
}

​

Prompt et télémétrie

• nombre total d’octets sérialisés des outils et du prompt envoyés au harnais
• taille du catalogue et répartition par source
• nombre de recherches, de descriptions et d’appels
• appels d’outils finaux exécutés par l’intermédiaire d’OpenClaw
• identifiants et sources des outils sélectionnés

• combien de schémas d’outils le modèle a vus initialement
• combien d’opérations de recherche et de description il a effectuées
• quel outil final a été appelé
• si le résultat provenait d’OpenClaw, de MCP ou d’un outil client

​

Validation E2E

pnpm openclaw qa suite --provider-mode mock-openai --scenario tool-search-gateway-e2e

1. Le mode direct peut appeler l’outil du faux Plugin.
2. La recherche d’outils peut appeler le même outil du faux Plugin.
3. Le mode direct expose directement les schémas des outils du faux Plugin au fournisseur.
4. La recherche d’outils expose uniquement le pont compact et tous les outils exclusivement directs.
5. La charge utile de la requête de recherche d’outils est plus petite pour le vaste faux catalogue.
6. Les journaux de session présentent le nombre attendu d’appels d’outils et les données de télémétrie des appels passant par le pont.

​

Comportement en cas d’échec

• si un outil ne fait pas partie de la politique effective, la recherche ne doit pas le renvoyer
• si un outil sélectionné devient indisponible, tool_call doit échouer
• si une politique ou une approbation bloque l’exécution, le résultat de l’appel doit signaler ce blocage au lieu de le contourner
• si le pont de code ne peut pas créer un environnement d’exécution isolé, utilisez mode: "tools" ou désactivez la recherche d’outils pour ce déploiement

​

Pages connexes

• Outils et Plugins
• Bac à sable multi-agent et outils
• Outil d’exécution
• Configuration des agents ACP
• Création de Plugins