Overview
Ikhtisar
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 terpaket.
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, mulailah dengan kategori alat bawaan, lalu sesuaikan kebijakan hanya jika agen harus melihat lebih sedikit alat atau memerlukan akses host secara eksplisit.
| Jika Anda perlu... | Gunakan ini terlebih dahulu | Kemudian baca |
|---|---|---|
| Memungkinkan agen bertindak dengan kapabilitas yang ada | Alat bawaan | Kategori alat |
| Mengendalikan apa yang dapat dipanggil agen | Kebijakan alat | Alat dan penyedia kustom |
| Mengajarkan alur kerja kepada agen | Skills | Skills, Membuat Skills, Lokakarya Skills, dan Pembelajaran mandiri |
| 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 |
| Mengorkestrasi agen serentak dari kode | Swarm | Mode Kode dan Subagen |
| Mencari katalog alat OpenClaw yang besar | Pencarian Alat | Pencarian Alat |
| Menggabungkan beberapa alat dalam satu program ringkas | Mode Kode | Mode Kode |
Pilih alat, Skills, atau plugin
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.
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 Skills
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.
| Kategori | Gunakan ketika agen perlu... | Alat perwakilan | Baca selanjutnya |
|---|---|---|---|
| Runtime | Menjalankan perintah, mengelola proses, atau menggunakan analisis Python yang didukung penyedia | exec, process, terminal, code_execution |
Exec, Terminal Control UI, Eksekusi kode |
| Berkas | Membaca dan mengubah berkas ruang kerja | read, write, edit, apply_patch |
Terapkan patch |
| Masukan manusia | Menjeda untuk keputusan terstruktur yang menjadi tanggung jawab pengguna | ask_user |
Tanya pengguna |
| Web | Mencari di web, mencari postingan X, atau mengambil konten halaman yang dapat dibaca | web_search, x_search, web_fetch |
Alat web, Pengambilan web |
| Browser | Mengoperasikan sesi browser | browser |
Browser |
| UI operator | Menata panel, bilah panel, dan navigasi Control UI yang terhubung | screen |
Layar |
| Pesan dan kanal | Mengirim balasan atau tindakan kanal | message |
Pengiriman agen |
| Sesi dan agen | Memeriksa sesi, mendelegasikan pekerjaan, mengorkestrasi pengumpul, mengarahkan eksekusi lain, atau melaporkan status | sessions_*, agents_wait, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
Sasaran, Swarm, 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, membuat, atau menyuarakan media | image, image_generate, music_generate, video_generate, tts |
Ikhtisar media |
| Katalog OpenClaw besar | Mencari, memanggil, dan menggabungkan banyak alat yang memenuhi syarat tanpa mengirim setiap skema ke model | exec, wait, tool_search_code, tool_search, tool_describe |
Mode Kode, 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
- 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