Overview
Ikhtisar
Gunakan halaman ini untuk memilih permukaan Capabilities yang tepat. Alat adalah tindakan yang dapat dipanggil, Skills mengajarkan agen cara bekerja, dan Plugin menambahkan kemampuan runtime seperti alat, penyedia, saluran, hook, dan Skills yang dikemas.
Ini adalah halaman ikhtisar dan perutean. Untuk kebijakan alat, default, keanggotaan grup, pembatasan penyedia, dan bidang konfigurasi yang lengkap, gunakan Alat dan penyedia kustom.
Mulai di sini
Untuk sebagian besar agen, mulai dengan kategori alat bawaan, lalu sesuaikan kebijakan hanya ketika agen harus melihat lebih sedikit alat atau membutuhkan akses host eksplisit.
| Jika Anda perlu... | Gunakan ini terlebih dahulu | Lalu baca |
|---|---|---|
| Membiarkan agen bertindak dengan kemampuan yang ada | Alat bawaan | Kategori alat |
| Mengontrol apa yang dapat dipanggil agen | Kebijakan alat | Alat dan penyedia kustom |
| Mengajarkan alur kerja kepada agen | Skills | Skills, Membuat Skills, dan Lokakarya Skill |
| Menambahkan integrasi baru atau permukaan runtime | Plugin | Plugin dan Membangun Plugin |
| Menjalankan pekerjaan nanti atau di latar belakang | Automasi | Ikhtisar automasi |
| Mengkoordinasikan beberapa agen atau harness | Sub-agen | Agen ACP dan Kirim agen |
| Mencari katalog alat OpenClaw yang besar | Pencarian Alat | Pencarian Alat |
Pilih alat, Skills, atau Plugin
Use a tool when the agent needs to act
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 file, 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 saluran, dan ketersediaan Plugin.
Use a skill when the agent needs instructions
Skill adalah paket instruksi SKILL.md yang dimuat ke dalam prompt agen. Gunakan
Skill ketika agen sudah memiliki alat yang dibutuhkan, tetapi membutuhkan
alur kerja berulang, rubrik tinjauan, urutan perintah, atau batasan operasional.
Skills dapat berada di workspace, direktori Skill bersama, root Skill OpenClaw terkelola, atau paket Plugin.
Skills | Lokakarya Skill | Membuat Skills | Konfigurasi Skills
Use a plugin when OpenClaw needs a new capability
Plugin dapat menambahkan alat, Skills, saluran, penyedia model, ucapan, suara realtime, pembuatan media, pencarian web, pengambilan web, hook, dan kemampuan runtime lainnya. Gunakan Plugin ketika kemampuan memiliki kode, kredensial, hook siklus hidup, metadata manifes, atau paket yang dapat diinstal. Plugin yang ada dapat diinstal dari ClawHub, npm, git, direktori lokal, atau arsip.
Instal dan konfigurasikan Plugin | Membangun Plugin | SDK Plugin
Kategori alat bawaan
Tabel ini mencantumkan alat representatif agar Anda dapat mengenali permukaannya. Ini bukan referensi kebijakan lengkap. Untuk grup, default, dan semantik izinkan/tolak yang tepat, gunakan Alat dan penyedia kustom.
| Kategori | Gunakan ketika agen perlu... | Alat representatif | Baca selanjutnya |
|---|---|---|---|
| Runtime | Menjalankan perintah, mengelola proses, atau menggunakan analisis Python yang didukung penyedia | exec, process, code_execution |
Exec, Eksekusi kode |
| File | Membaca dan mengubah file workspace | read, write, edit, apply_patch |
Terapkan patch |
| Web | Mencari di web, mencari posting X, atau mengambil konten halaman yang dapat dibaca | web_search, x_search, web_fetch |
Alat web, Pengambilan web |
| Browser | Mengoperasikan sesi browser | browser |
Browser |
| Pesan dan saluran | Mengirim balasan atau tindakan saluran | message |
Kirim agen |
| Sesi dan agen | Memeriksa sesi, mendelegasikan pekerjaan, mengarahkan run lain, atau melaporkan status | sessions_*, subagents, agents_list, session_status, goal |
Goal, Sub-agen, Alat sesi |
| Automasi | Menjadwalkan pekerjaan atau merespons event latar belakang | cron, heartbeat_respond |
Automasi |
| Gateway dan node | Memeriksa status Gateway atau perangkat target yang dipasangkan | gateway, nodes |
Konfigurasi Gateway, Node |
| Media | Menganalisis, membuat, atau mengucapkan media | image, image_generate, music_generate, video_generate, tts |
Ikhtisar media |
| Katalog OpenClaw besar | Mencari dan memanggil banyak alat yang memenuhi syarat tanpa mengirim setiap skema ke model | tool_search_code, tool_search, tool_describe |
Pencarian Alat |
Alat yang disediakan Plugin
Plugin dapat mendaftarkan alat tambahan. Penulis Plugin menghubungkan alat melalui
api.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
- Tugas LLM untuk langkah alur kerja khusus JSON
- Lobster untuk alur kerja bertipe dengan persetujuan yang dapat dilanjutkan
- Tokenjuice untuk memadatkan output alat
execdanbashyang berisik - 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 ditegakkan sebelum panggilan model. Jika kebijakan menghapus alat, model tidak menerima skema alat tersebut untuk giliran itu. Sebuah run dapat kehilangan alat karena konfigurasi global, konfigurasi per agen, kebijakan saluran, pembatasan penyedia, aturan sandbox, kebijakan saluran/runtime, atau ketersediaan Plugin.
- Alat dan penyedia kustom mendokumentasikan profil alat, daftar izinkan/tolak, pembatasan khusus penyedia, deteksi loop, dan pengaturan alat yang didukung penyedia.
- Persetujuan exec mendokumentasikan kebijakan persetujuan perintah host.
- Exec yang ditingkatkan mendokumentasikan eksekusi terkontrol di luar sandbox.
- Sandbox vs kebijakan alat vs ditingkatkan menjelaskan lapisan mana yang mengontrol akses file dan proses.
- Sandbox per agen dan pembatasan alat mendokumentasikan pembatasan khusus agen untuk run yang didelegasikan.
Perluas kemampuan
Pilih jalur ekstensi berdasarkan pekerjaan yang Anda butuhkan OpenClaw lakukan:
- Instal atau kelola Plugin yang ada dengan Plugin.
- Bangun integrasi, penyedia, saluran, alat, atau hook baru dengan Membangun Plugin.
- Tambahkan atau sesuaikan instruksi agen yang dapat digunakan ulang dengan Skills dan Membuat Skills.
- Gunakan SDK Plugin dan Manifes Plugin ketika Anda membutuhkan kontrak implementasi.
Pecahkan masalah alat yang hilang
Jika model tidak dapat melihat atau memanggil alat, mulai 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 saluran, status sandbox, dan akses yang ditingkatkan dengan Sandbox vs kebijakan alat vs ditingkatkan dan Exec yang ditingkatkan.
- Periksa apakah Plugin pemilik sudah diinstal dan diaktifkan di Plugin.
- Untuk run yang didelegasikan, periksa pembatasan per agen di Sandbox per agen dan pembatasan alat.
- Untuk katalog OpenClaw besar, konfirmasi apakah run menggunakan eksposur alat langsung atau Pencarian Alat.
Terkait
- Automasi untuk cron, tugas, Heartbeat, komitmen, hook, perintah tetap, dan Task Flow
- Agen untuk model agen, sesi, memori, dan koordinasi multi-agen
- Alat dan penyedia kustom untuk referensi kebijakan alat kanonis
- Plugin untuk instalasi dan pengelolaan Plugin
- SDK Plugin untuk referensi penulis Plugin
- Skills untuk urutan pemuatan Skill, gating, dan konfigurasi
- Lokakarya Skill untuk pembuatan Skill yang dihasilkan dan ditinjau
- Pencarian Alat untuk penemuan katalog alat OpenClaw yang ringkas
