Поиск инструментов

const hits = await openclaw.tools.search("создать задачу в GitHub");
const tool = await openclaw.tools.describe(hits[0].id);
return await openclaw.tools.call(tool.id, {
  title: "Сбой при запуске",
  body: "Шаги для воспроизведения...",
});

​

Как выполняется ход

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("событие календаря", { limit: 5 });

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

await openclaw.tools.call(calendarCreate.id, {
  summary: "Планирование",
  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
• Создание плагинов