Wyszukiwanie narzędzi

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...",
});

​

Jak przebiega tura

1. Ustala aktywną politykę narzędzi dla agenta, profilu, piaskownicy i sesji.
2. Wyświetla listę kwalifikujących się narzędzi OpenClaw i pluginów.
3. Wyświetla listę kwalifikujących się narzędzi MCP za pośrednictwem środowiska wykonawczego MCP sesji.
4. Dodaje kwalifikujące się narzędzia klienta dostarczone dla bieżącego przebiegu.
5. Pozostawia narzędzia dostępne wyłącznie bezpośrednio jako widoczne dla modelu i indeksuje kompaktowe deskryptory pozostałych narzędzi kwalifikujących się do katalogu.
6. Udostępnia most kodowy OpenClaw, ustrukturyzowane narzędzia awaryjne lub kompaktowy interfejs katalogowy obok narzędzi dostępnych wyłącznie bezpośrednio.

​

Tryby

• code: udostępnia tool_search_code, domyślny kompaktowy most JavaScript, obok narzędzi dostępnych wyłącznie bezpośrednio.
• tools: udostępnia tool_search, tool_describe i tool_call jako zwykłe ustrukturyzowane narzędzia awaryjne dla dostawców, którzy nie powinni otrzymywać kodu, obok narzędzi dostępnych wyłącznie bezpośrednio.
• directory: udostępnia tool_search, tool_describe i tool_call oraz ograniczony katalog w monicie, zawierający nazwy i opisy dostępnych narzędzi, dla dostawców, którzy powinni widzieć nazwy narzędzi bez wszystkich pełnych schematów. OpenClaw może również bezpośrednio udostępnić niewielki, ograniczony zestaw prawdopodobnych lub wymaganych schematów narzędzi dla bieżącej tury. Narzędzia dostępne wyłącznie bezpośrednio pozostają widoczne również w tym trybie.

​

Dlaczego ta funkcja istnieje

• narzędzia bezpośrednie: model widzi każdy wybrany schemat przed pierwszym tokenem
• tryb kodu Tool Search: model widzi jedno kompaktowe narzędzie kodowe, krótki kontrakt API oraz wszystkie narzędzia dostępne wyłącznie bezpośrednio
• tryb narzędzi Tool Search: model widzi trzy kompaktowe, ustrukturyzowane narzędzia awaryjne oraz wszystkie narzędzia dostępne wyłącznie bezpośrednio
• tryb katalogu Tool Search: model widzi ograniczony katalog wraz z mechanizmami wyszukiwania/opisywania/wywoływania i niewielkim, ograniczonym zestawem prawdopodobnych lub wymaganych schematów oraz wszystkimi narzędziami dostępnymi wyłącznie bezpośrednio
• podczas tury: model może w razie potrzeby ładować pozostałe schematy

​

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

​

Granica środowiska wykonawczego

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

• polityki zezwalania na narzędzia i ich blokowania
• ograniczenia narzędzi dotyczące poszczególnych agentów i piaskownic
• polityka narzędzi kanału/środowiska wykonawczego
• punkty zaczepienia zatwierdzania
• punkty zaczepienia pluginu before_tool_call
• tożsamość sesji, dzienniki i telemetria

​

Konfiguracja

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,
  },
}

​

Monit i telemetria

• łączna liczba bajtów zserializowanych narzędzi i monitu wysłanych do uprzęży
• rozmiar katalogu i podział według źródeł
• liczba operacji wyszukiwania, opisywania i wywoływania
• końcowe wywołania narzędzi wykonane za pośrednictwem OpenClaw
• identyfikatory i źródła wybranych narzędzi

• ile schematów narzędzi model zobaczył z góry
• ile operacji wyszukiwania i opisywania wykonał
• które narzędzie końcowe zostało wywołane
• czy wynik pochodził z OpenClaw, MCP czy narzędzia klienta

​

Walidacja E2E

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

1. Tryb bezpośredni może wywołać narzędzie fikcyjnego pluginu.
2. Tool Search może wywołać to samo narzędzie fikcyjnego pluginu.
3. Tryb bezpośredni udostępnia schematy narzędzi fikcyjnego pluginu bezpośrednio dostawcy.
4. Tool Search udostępnia tylko kompaktowy most oraz wszystkie narzędzia dostępne wyłącznie bezpośrednio.
5. Ładunek żądania Tool Search jest mniejszy w przypadku dużego fikcyjnego katalogu.
6. Dzienniki sesji pokazują oczekiwaną liczbę wywołań narzędzi i telemetrię wywołań przez most.

​

Zachowanie w przypadku błędów

• jeśli narzędzie nie jest objęte efektywną polityką, wyszukiwanie nie powinno go zwrócić
• jeśli wybrane narzędzie stanie się niedostępne, tool_call powinno zakończyć się błędem
• jeśli polityka lub zatwierdzanie blokuje wykonanie, wynik wywołania powinien zgłosić tę blokadę zamiast ją omijać
• jeśli most kodowy nie może utworzyć izolowanego środowiska wykonawczego, użyj mode: "tools" lub wyłącz Tool Search dla tego wdrożenia

​

Powiązane

• Narzędzia i pluginy
• Piaskownica i narzędzia dla wielu agentów
• Narzędzie Exec
• Konfiguracja agentów ACP
• Tworzenie pluginów