Mulai di sini
Untuk sebagian besar agen, mulailah dengan kategori alat bawaan, lalu sesuaikan kebijakan hanya jika agen harus melihat lebih sedikit alat atau memerlukan akses host secara eksplisit.Pilih alat, Skills, atau plugin
1
Gunakan alat ketika agen perlu bertindak
Alat adalah fungsi bertipe yang dapat dipanggil agen, seperti
exec, browser,
web_search, message, atau image_generate. Gunakan alat ketika agen
perlu membaca data, mengubah berkas, mengirim pesan, memanggil penyedia, atau
mengoperasikan sistem lain. Alat yang terlihat dikirim ke model sebagai definisi
fungsi terstruktur.Model hanya melihat alat yang lolos dari profil aktif, kebijakan
izinkan/tolak, pembatasan penyedia, status sandbox, izin kanal, dan
ketersediaan plugin.2
Gunakan Skills ketika agen memerlukan instruksi
Skills adalah paket instruksi
SKILL.md yang dimuat ke dalam prompt agen. Gunakan
Skills ketika agen sudah memiliki alat yang dibutuhkan, tetapi memerlukan
alur kerja berulang, rubrik review, urutan perintah, atau batasan
operasional.Skills dapat berada di ruang kerja, direktori Skills bersama, root Skills
OpenClaw yang dikelola, atau paket plugin.Skills | Lokakarya Skills | Pembelajaran mandiri | Membuat Skills | Konfigurasi Skills3
Gunakan plugin ketika OpenClaw memerlukan kapabilitas baru
Plugin dapat menambahkan alat, Skills, kanal, penyedia model, ucapan,
suara waktu nyata, pembuatan media, pencarian web, pengambilan web, hook, dan
kapabilitas runtime lainnya. Gunakan plugin ketika kapabilitas tersebut memiliki kode,
kredensial, hook siklus hidup, metadata manifes, atau
pengemasan yang dapat diinstal. Plugin yang ada dapat diinstal dari ClawHub, npm, git,
direktori lokal, atau arsip.Instal dan konfigurasi plugin | Membangun plugin | SDK Plugin
Kategori alat bawaan
Tabel ini mencantumkan alat perwakilan agar Anda dapat mengenali permukaannya. Ini bukan referensi kebijakan lengkap. Untuk grup, default, dan semantik izinkan/tolak yang tepat, gunakan Alat dan penyedia kustom.Mode Kode dan Pencarian Alat adalah permukaan agen OpenClaw eksperimental. Eksekusi
harness Codex menggunakan mode kode native Codex, pencarian alat native, alat dinamis
tertunda, dan panggilan alat bersarang sebagai pengganti
tools.codeMode atau tools.toolSearch.Alat yang disediakan plugin
Plugin dapat mendaftarkan alat tambahan. Penulis plugin menghubungkan alat melaluiapi.registerTool(...) dan contracts.tools milik manifes; gunakan
SDK Plugin dan Manifes plugin
untuk detail kontrak.
Alat umum yang disediakan plugin meliputi:
- Diff untuk merender diff file dan Markdown
- Tampilkan widget untuk SVG dan HTML inline mandiri di klien chat yang didukung
- Layar untuk menata Control UI yang terhubung
- Tugas LLM untuk langkah alur kerja khusus JSON
- Lobster untuk alur kerja bertipe dengan persetujuan yang dapat dilanjutkan
- Tokenjuice untuk memadatkan output alat
execdanbashyang penuh derau - Pencarian Alat untuk menemukan dan memanggil katalog alat besar tanpa memasukkan setiap skema ke dalam prompt
- Canvas untuk kontrol Canvas node dan rendering A2UI
Konfigurasikan akses dan persetujuan
Kebijakan alat diterapkan sebelum pemanggilan model. Jika kebijakan menghapus suatu alat, model tidak menerima skema alat tersebut untuk giliran itu. Sebuah proses dapat kehilangan alat karena konfigurasi global, konfigurasi per agen, kebijakan kanal, pembatasan penyedia, aturan sandbox, kebijakan kanal/runtime, atau ketersediaan Plugin.- Alat dan penyedia kustom mendokumentasikan profil alat, daftar izin/tolak, pembatasan khusus penyedia, deteksi perulangan, dan pengaturan alat yang didukung penyedia.
- Persetujuan exec mendokumentasikan kebijakan persetujuan perintah host.
- Exec dengan hak istimewa mendokumentasikan eksekusi terkendali di luar sandbox.
- Sandbox vs kebijakan alat vs hak istimewa menjelaskan lapisan mana yang mengendalikan akses file dan proses.
- Pembatasan sandbox dan alat per agen mendokumentasikan pembatasan khusus agen untuk proses yang didelegasikan.
Perluas kemampuan
Pilih jalur ekstensi berdasarkan pekerjaan yang perlu dilakukan OpenClaw:- Instal atau kelola Plugin yang sudah ada dengan Plugin.
- Bangun integrasi, penyedia, kanal, alat, atau hook baru dengan Membangun Plugin.
- Tambahkan atau sesuaikan instruksi agen yang dapat digunakan kembali dengan Skills dan Membuat Skills.
- Gunakan SDK Plugin dan Manifes Plugin saat Anda memerlukan kontrak implementasi.
Atasi masalah alat yang hilang
Jika model tidak dapat melihat atau memanggil suatu alat, mulailah dengan kebijakan efektif untuk giliran saat ini:- Periksa profil aktif,
tools.allow, dantools.denydi Alat dan penyedia kustom. - Periksa pembatasan khusus penyedia di Alat dan penyedia kustom dan pastikan penyedia model yang dipilih mendukung bentuk alat tersebut.
- Periksa izin kanal, status sandbox, dan akses dengan hak istimewa melalui Sandbox vs kebijakan alat vs hak istimewa dan Exec dengan hak istimewa.
- Periksa apakah Plugin pemiliknya telah diinstal dan diaktifkan di Plugin.
- Untuk proses yang didelegasikan, periksa pembatasan per agen di Pembatasan sandbox dan alat per agen.
- Untuk katalog OpenClaw yang besar, pastikan apakah proses menggunakan pemaparan alat langsung, Mode Kode, atau Pencarian Alat.
Terkait
- Otomatisasi untuk Cron, tugas, Heartbeat, komitmen, hook, perintah tetap, dan Alur Tugas
- Agen untuk model agen, sesi, memori, dan koordinasi multiagen
- Alat dan penyedia kustom untuk referensi kebijakan alat kanonis
- Plugin untuk instalasi dan pengelolaan Plugin
- SDK Plugin untuk referensi pembuat Plugin
- Skills untuk urutan pemuatan, pembatasan, dan konfigurasi Skills
- Lokakarya Skills untuk pembuatan Skills yang dihasilkan dan ditinjau
- Pencarian Alat untuk penemuan katalog alat OpenClaw yang ringkas
- Mode Kode untuk alur kerja JavaScript atau TypeScript yang ringkas melalui katalog alat OpenClaw tersembunyi
- Swarm untuk fan-out terstruktur dan pengumpulan dari Mode Kode