Pencarian Alat

const hits = await openclaw.tools.search("buat issue GitHub");
const tool = await openclaw.tools.describe(hits[0].id);
return await openclaw.tools.call(tool.id, {
  title: "Crash saat mulai",
  body: "Langkah-langkah untuk mereproduksi...",
});

​

Cara giliran dijalankan

1. Selesaikan kebijakan alat aktif untuk agen, profil, sandbox, dan sesi.
2. Cantumkan alat OpenClaw dan plugin yang memenuhi syarat.
3. Cantumkan alat MCP yang memenuhi syarat melalui runtime MCP sesi.
4. Tambahkan alat klien yang memenuhi syarat dan disediakan untuk proses saat ini.
5. Pertahankan alat khusus-langsung agar terlihat oleh model dan indekskan deskriptor ringkas untuk alat tersisa yang memenuhi syarat katalog.
6. Ekspos jembatan kode OpenClaw, alat fallback terstruktur, atau permukaan direktori ringkas bersama alat khusus-langsung tersebut.

​

Mode

• code: mengekspos tool_search_code, jembatan JavaScript ringkas default, bersama alat khusus-langsung.
• tools: mengekspos tool_search, tool_describe, dan tool_call sebagai alat terstruktur biasa untuk penyedia yang tidak boleh menerima kode, bersama alat khusus-langsung.
• directory: mengekspos tool_search, tool_describe, dan tool_call ditambah direktori prompt terbatas berisi nama dan deskripsi alat yang tersedia untuk penyedia yang harus melihat nama alat tanpa setiap skema lengkap. OpenClaw juga dapat mengekspos secara langsung sekumpulan kecil terbatas skema alat yang mungkin diperlukan atau diwajibkan untuk giliran saat ini. Alat khusus-langsung juga tetap terlihat dalam mode ini.

​

Alasan fitur ini ada

• alat langsung: model melihat setiap skema yang dipilih sebelum token pertama
• mode kode Tool Search: model melihat satu alat kode ringkas, kontrak API singkat, dan alat khusus-langsung apa pun
• mode alat Tool Search: model melihat tiga alat fallback terstruktur ringkas ditambah alat khusus-langsung apa pun
• mode direktori Tool Search: model melihat direktori terbatas ditambah kontrol pencarian/deskripsi/panggilan dan sekumpulan kecil terbatas skema yang mungkin diperlukan atau diwajibkan, ditambah alat khusus-langsung apa pun
• selama giliran: model dapat memuat skema tersisa sesuai kebutuhan

​

API

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

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

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

• tool_search
• tool_describe
• tool_call

• tool_search
• tool_describe
• tool_call

​

Batas runtime

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

• kebijakan mengizinkan dan menolak alat
• pembatasan alat per agen dan per sandbox
• kebijakan alat kanal/runtime
• hook persetujuan
• hook before_tool_call plugin
• identitas sesi, log, dan telemetri

​

Konfigurasi

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 dan telemetri

• total byte alat dan prompt terserialisasi yang dikirim ke harness
• ukuran katalog dan perincian sumber
• jumlah pencarian, deskripsi, dan panggilan
• panggilan alat akhir yang dieksekusi melalui OpenClaw
• id dan sumber alat yang dipilih

• berapa banyak skema alat yang dilihat model sejak awal
• berapa banyak operasi pencarian dan deskripsi yang dilakukan
• alat akhir mana yang dipanggil
• apakah hasil berasal dari OpenClaw, MCP, atau alat klien

​

Validasi E2E

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

1. Mode langsung dapat memanggil alat plugin palsu.
2. Tool Search dapat memanggil alat plugin palsu yang sama.
3. Mode langsung mengekspos skema alat plugin palsu secara langsung kepada penyedia.
4. Tool Search hanya mengekspos jembatan ringkas beserta alat apa pun yang hanya tersedia secara langsung.
5. Payload permintaan Tool Search lebih kecil untuk katalog palsu yang besar.
6. Log sesi menunjukkan jumlah panggilan alat yang diharapkan dan telemetri panggilan yang dijembatani.

​

Perilaku kegagalan

• jika alat tidak tercakup dalam kebijakan efektif, pencarian tidak boleh mengembalikannya
• jika alat yang dipilih menjadi tidak tersedia, tool_call harus gagal
• jika kebijakan atau persetujuan memblokir eksekusi, hasil panggilan harus melaporkan pemblokiran tersebut alih-alih melewatinya
• jika jembatan kode tidak dapat membuat runtime terisolasi, gunakan mode: "tools" atau nonaktifkan Tool Search untuk deployment tersebut

​

Terkait

• Alat dan plugin
• Sandbox dan alat multiagen
• Alat Exec
• Penyiapan agen ACP
• Membangun plugin