Пошук інструментів

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

​

Як виконується хід

1. Визначає активну політику інструментів для агента, профілю, пісочниці та сеансу.
2. Перелічує придатні інструменти OpenClaw і плагінів.
3. Перелічує придатні інструменти MCP через середовище виконання MCP сеансу.
4. Додає придатні клієнтські інструменти, надані для поточного виконання.
5. Залишає інструменти лише прямого доступу видимими для моделі та індексує компактні описи для решти придатних для каталогу інструментів.
6. Надає міст коду OpenClaw, структуровані резервні інструменти або компактну поверхню каталогу разом із цими інструментами лише прямого доступу.

​

Режими

• code: надає tool_search_code — стандартний компактний міст JavaScript — разом з інструментами лише прямого доступу.
• tools: надає tool_search, tool_describe і tool_call як звичайні структуровані інструменти для постачальників, які не повинні отримувати код, разом з інструментами лише прямого доступу.
• directory: надає tool_search, tool_describe і tool_call, а також обмежений каталог у запиті з назвами й описами доступних інструментів для постачальників, які повинні бачити назви інструментів, але не кожну повну схему. OpenClaw також може безпосередньо надавати невеликий обмежений набір імовірних або обов’язкових схем інструментів для поточного ходу. Інструменти лише прямого доступу також залишаються видимими в цьому режимі.

​

Навіщо це потрібно

• прямі інструменти: модель бачить кожну вибрану схему до першого токена
• режим коду Tool Search: модель бачить один компактний інструмент коду, короткий контракт API та всі інструменти лише прямого доступу
• режим інструментів Tool Search: модель бачить три компактні структуровані резервні інструменти та всі інструменти лише прямого доступу
• режим каталогу Tool Search: модель бачить обмежений каталог, а також елементи керування пошуком, описом і викликом та невеликий обмежений набір імовірних або обов’язкових схем разом з усіма інструментами лише прямого доступу
• під час ходу: модель може завантажувати решту схем за потреби

​

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

​

Межа середовища виконання

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

• політики дозволу й заборони інструментів
• обмеження інструментів для окремих агентів і пісочниць
• політика інструментів каналу та середовища виконання
• перехоплювачі схвалення
• перехоплювачі плагінів before_tool_call
• ідентичність сеансу, журнали й телеметрія

​

Конфігурація

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

​

Запит і телеметрія

• загальний розмір серіалізованих інструментів і запиту, надісланих середовищу, у байтах
• розмір каталогу та розподіл за джерелами
• кількість операцій пошуку, опису й виклику
• остаточні виклики інструментів, виконані через OpenClaw
• ідентифікатори й джерела вибраних інструментів

• скільки схем інструментів модель бачила наперед
• скільки операцій пошуку й опису вона виконала
• який остаточний інструмент було викликано
• чи надійшов результат від OpenClaw, MCP або клієнтського інструмента

​

Наскрізна перевірка

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

1. Прямий режим може викликати інструмент імітаційного плагіна.
2. Tool Search може викликати той самий інструмент імітаційного плагіна.
3. Прямий режим надає схеми інструментів імітаційного плагіна безпосередньо постачальнику.
4. Tool Search надає лише компактний міст і всі інструменти лише прямого доступу.
5. Корисне навантаження запиту Tool Search є меншим для великого імітаційного каталогу.
6. Журнали сеансу показують очікувану кількість викликів інструментів і телеметрію викликів через міст.

​

Поведінка в разі помилки

• якщо інструмент не входить до ефективної політики, пошук не повинен його повертати
• якщо вибраний інструмент стає недоступним, tool_call має завершитися помилкою
• якщо політика або схвалення блокує виконання, результат виклику має повідомляти про це блокування, а не обходити його
• якщо міст коду не може створити ізольоване середовище виконання, використовуйте mode: "tools" або вимкніть Tool Search для цього розгортання

​

Пов’язані матеріали

• Інструменти та плагіни
• Багатоагентна пісочниця та інструменти
• Інструмент Exec
• Налаштування агентів ACP
• Створення плагінів