Araç Arama

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

​

Bir turun çalışma şekli

1. Ajan, profil, korumalı alan ve oturum için etkin araç politikasını çözümleyin.
2. Uygun OpenClaw ve plugin araçlarını listeleyin.
3. Oturum MCP çalışma zamanı üzerinden uygun MCP araçlarını listeleyin.
4. Geçerli çalıştırma için sağlanan uygun istemci araçlarını ekleyin.
5. Yalnızca doğrudan araçları model tarafından görünür tutun ve kataloğa uygun kalan araçların kompakt tanımlayıcılarını dizine ekleyin.
6. OpenClaw kod köprüsünü, yapılandırılmış geri dönüş araçlarını veya kompakt dizin yüzeyini bu yalnızca doğrudan araçların yanında sunun.

​

Modlar

• code: yalnızca doğrudan araçların yanında varsayılan kompakt JavaScript köprüsü olan tool_search_code öğesini sunar.
• tools: kod almaması gereken sağlayıcılar için yalnızca doğrudan araçların yanında tool_search, tool_describe ve tool_call öğelerini düz yapılandırılmış araçlar olarak sunar.
• directory: her tam şemayı görmeden araç adlarını görmesi gereken sağlayıcılar için tool_search, tool_describe ve tool_call öğelerinin yanı sıra kullanılabilir araç adları ve açıklamalarından oluşan sınırlı bir istem dizini sunar. OpenClaw ayrıca geçerli tur için muhtemel veya gerekli araç şemalarından oluşan küçük, sınırlı bir kümeyi doğrudan sunabilir. Yalnızca doğrudan araçlar bu modda da görünür kalır.

​

Neden var?

• doğrudan araçlar: model, ilk token’dan önce seçilen her şemayı görür
• Araç Arama kod modu: model tek bir kompakt kod aracını, kısa bir API sözleşmesini ve tüm yalnızca doğrudan araçları görür
• Araç Arama araç modu: model üç kompakt yapılandırılmış geri dönüş aracını ve tüm yalnızca doğrudan araçları görür
• Araç Arama dizin modu: model sınırlı bir dizini, arama/açıklama/çağrı denetimlerini, muhtemel veya gerekli şemalardan oluşan küçük ve sınırlı bir kümeyi ve tüm yalnızca doğrudan araçları görür
• tur sırasında: model kalan şemaları gerektiğinde yükleyebilir

​

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

​

Çalışma zamanı sınırı

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

• araç izin ve reddetme politikaları
• ajan ve korumalı alan başına araç kısıtlamaları
• kanal/çalışma zamanı araç politikası
• onay kancaları
• plugin before_tool_call kancaları
• oturum kimliği, günlükler ve telemetri

​

Yapılandırma

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

​

İstem ve telemetri

• çalıştırma altyapısına gönderilen toplam serileştirilmiş araç ve istem baytı
• katalog boyutu ve kaynak dağılımı
• arama, açıklama ve çağrı sayıları
• OpenClaw üzerinden yürütülen nihai araç çağrıları
• seçilen araç kimlikleri ve kaynakları

• modelin başlangıçta kaç araç şeması gördüğü
• kaç arama ve açıklama işlemi gerçekleştirdiği
• hangi nihai aracın çağrıldığı
• sonucun OpenClaw, MCP veya bir istemci aracından gelip gelmediği

​

E2E doğrulaması

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

1. Doğrudan mod, sahte plugin aracını çağırabilir.
2. Araç Arama, aynı sahte plugin aracını çağırabilir.
3. Doğrudan mod, sahte plugin aracı şemalarını doğrudan sağlayıcıya sunar.
4. Araç Arama, yalnızca kompakt köprüyü ve doğrudan moda özel araçları sunar.
5. Araç Arama isteği yükü, büyük sahte katalog için daha küçüktür.
6. Oturum günlükleri, beklenen araç çağrısı sayılarını ve köprülenen çağrı telemetrisini gösterir.

​

Hata davranışı

• bir araç etkin politikada yer almıyorsa arama bu aracı döndürmemelidir
• seçilen bir araç kullanılamaz hâle gelirse tool_call başarısız olmalıdır
• politika veya onay yürütmeyi engelliyorsa çağrı sonucu, engeli atlamak yerine bu engeli bildirmelidir
• kod köprüsü yalıtılmış bir çalışma zamanı oluşturamıyorsa mode: "tools" kullanın veya bu dağıtım için Araç Arama’yı devre dışı bırakın

​

İlgili

• Araçlar ve pluginler
• Çok aracılı korumalı alan ve araçlar
• Exec aracı
• ACP aracılarını ayarlama
• Plugin geliştirme