Overview
Gambaran Umum
Gunakan halaman ini untuk memilih permukaan Kapabilitas yang tepat. Alat adalah tindakan yang dapat dipanggil, Skills mengajarkan agen cara bekerja, dan Plugin menambahkan kapabilitas runtime seperti alat, penyedia, kanal, hook, dan Skills yang dikemas.
Ini adalah halaman ikhtisar dan perutean. Untuk kebijakan alat, nilai bawaan, keanggotaan grup, pembatasan penyedia, dan bidang konfigurasi secara lengkap, gunakan Alat dan penyedia kustom.
Mulai di sini
Untuk sebagian besar agen, mulailah dengan kategori alat bawaan, lalu sesuaikan kebijakan hanya jika agen seharusnya melihat lebih sedikit alat atau memerlukan akses host secara eksplisit.
| Jika Anda perlu... | Gunakan ini terlebih dahulu | Lalu baca |
|---|---|---|
| Memungkinkan agen bertindak dengan kapabilitas 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 atau permukaan runtime baru | Plugin | Plugin dan Membangun Plugin |
| Menjalankan pekerjaan nanti atau di latar belakang | Otomatisasi | Ikhtisar otomatisasi |
| Mengoordinasikan beberapa agen atau harness | Subagen | Agen ACP dan Pengiriman agen |
| Mencari katalog alat OpenClaw yang besar | Pencarian Alat | Pencarian Alat |
Memilih alat, Skills, atau Plugin
Gunakan alat saat agen perlu bertindak
Alat adalah fungsi bertipe yang dapat dipanggil agen, seperti exec, browser,
web_search, message, atau image_generate. Gunakan alat saat 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.
Gunakan Skills saat agen memerlukan instruksi
Skill adalah paket instruksi SKILL.md yang dimuat ke dalam prompt agen. Gunakan
Skill saat agen sudah memiliki alat yang diperlukan, tetapi membutuhkan
alur kerja yang dapat diulang, rubrik peninjauan, urutan perintah, atau batasan
operasional.
Skills dapat berada di ruang kerja, direktori Skill bersama, root Skill OpenClaw terkelola, atau paket Plugin.
Skills | Lokakarya Skill | Membuat Skills | Konfigurasi Skills
Gunakan Plugin saat OpenClaw memerlukan kapabilitas baru
Plugin dapat menambahkan alat, Skills, kanal, penyedia model, suara, suara waktu nyata, pembuatan media, pencarian web, pengambilan web, hook, dan kapabilitas runtime lainnya. Gunakan Plugin saat kapabilitas memiliki kode, kredensial, hook siklus hidup, metadata manifes, atau kemasan yang dapat diinstal. Plugin yang ada dapat diinstal dari ClawHub, npm, git, direktori lokal, atau arsip.
Menginstal dan mengonfigurasi 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, nilai bawaan, dan semantik izinkan/tolak yang tepat, gunakan Alat dan penyedia kustom.
| Kategori | Gunakan saat agen perlu... | Alat representatif | Bacaan selanjutnya |
|---|---|---|---|
| Runtime | Menjalankan perintah, mengelola proses, atau menggunakan analisis Python berbasis penyedia | exec, process, code_execution |
Exec, Eksekusi kode |
| Berkas | Membaca dan mengubah berkas ruang kerja | read, write, edit, apply_patch |
Menerapkan patch |
| Web | Mencari di web, mencari postingan X, atau mengambil konten halaman yang dapat dibaca | web_search, x_search, web_fetch |
Alat web, Pengambilan web |
| Peramban | Mengoperasikan sesi peramban | browser |
Peramban |
| Perpesanan dan kanal | Mengirim balasan atau tindakan kanal | message |
Pengiriman agen |
| Sesi dan agen | Memeriksa sesi, mendelegasikan pekerjaan, mengarahkan proses lain, atau melaporkan status | sessions_*, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
Sasaran, Subagen, Alat sesi |
| Otomatisasi | Menjadwalkan pekerjaan atau merespons peristiwa latar belakang | cron, heartbeat_respond |
Otomatisasi |
| Gateway dan node | Memeriksa status Gateway atau perangkat target yang dipasangkan | gateway, nodes |
Konfigurasi Gateway, Node |
| Media | Menganalisis, menghasilkan, atau menyuarakan media | image, image_generate, music_generate, video_generate, tts |
Ikhtisar media |
| Katalog besar OpenClaw | 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. Pembuat Plugin menghubungkan alat melalui
api.registerTool(...) dan contracts.tools milik manifes; gunakan
SDK Plugin dan Manifes Plugin
untuk detail kontrak.
Alat yang umum disediakan Plugin meliputi:
- Diff untuk merender diff berkas dan markdown
- Tampilkan widget untuk SVG dan HTML mandiri sebaris dalam obrolan web
- Tugas LLM untuk langkah alur kerja khusus JSON
- Lobster untuk alur kerja bertipe dengan persetujuan yang dapat dilanjutkan
- Tokenjuice untuk memadatkan keluaran 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 perenderan A2UI
Mengonfigurasi akses dan persetujuan
Kebijakan alat diberlakukan sebelum pemanggilan model. Jika kebijakan menghapus suatu alat, model tidak menerima skema alat tersebut untuk giliran itu. Suatu 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 izinkan/tolak, pembatasan khusus penyedia, deteksi perulangan, dan pengaturan alat berbasis 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 mengontrol akses berkas dan proses.
- Pembatasan sandbox dan alat per agen mendokumentasikan pembatasan khusus agen untuk proses yang didelegasikan.
Memperluas kapabilitas
Pilih jalur ekstensi berdasarkan pekerjaan yang perlu dilakukan OpenClaw:
- Instal atau kelola Plugin yang 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.
Memecahkan 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 pemilik telah diinstal dan diaktifkan di Plugin.
- Untuk proses yang didelegasikan, periksa pembatasan per agen di Pembatasan sandbox dan alat per agen.
- Untuk katalog besar OpenClaw, pastikan apakah proses menggunakan pemaparan alat langsung atau Pencarian Alat.
Terkait
- Otomatisasi untuk cron, tugas, heartbeat, komitmen, hook, perintah tetap, dan Task Flow
- Agen untuk model agen, sesi, memori, dan koordinasi multiagen
- Alat dan penyedia khusus untuk referensi kebijakan alat kanonis
- Plugin untuk instalasi dan pengelolaan plugin
- SDK Plugin untuk referensi pembuat plugin
- Skills untuk urutan pemuatan, pembatasan, dan konfigurasi skill
- Lokakarya Skill untuk pembuatan skill yang dihasilkan dan ditinjau
- Pencarian Alat untuk penemuan katalog alat OpenClaw yang ringkas
