Skills
Membuat Skills
Skills mengajari agen bagaimana dan kapan menggunakan alat. Setiap skill adalah sebuah direktori
yang berisi file SKILL.md dengan frontmatter YAML dan instruksi markdown.
Untuk cara skills dimuat dan diprioritaskan, lihat Skills.
Buat skill pertama Anda
Buat direktori skill
Skills berada di workspace Anda. Buat folder baru:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Tulis SKILL.md
Buat SKILL.md di dalam direktori tersebut. Frontmatter mendefinisikan metadata,
dan isi markdown memuat instruksi untuk agen.
---
name: hello-world
description: A simple skill that says hello.
---
# Hello World Skill
When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".
Gunakan hyphen-case dengan huruf kecil, digit, dan tanda hubung untuk name
skill. Jaga agar nama folder dan name frontmatter tetap selaras.
Tambahkan alat (opsional)
Anda dapat mendefinisikan skema alat khusus di frontmatter atau menginstruksikan agen
untuk menggunakan alat sistem yang sudah ada (seperti exec atau browser). Skills juga dapat
dikirim di dalam plugin bersama alat yang didokumentasikannya.
Muat skill
Mulai sesi baru agar OpenClaw mengambil skill tersebut:
# From chat
/new
# Or restart the gateway
openclaw gateway restart
Verifikasi bahwa skill telah dimuat:
openclaw skills list
Uji
Kirim pesan yang seharusnya memicu skill:
openclaw agent --message "give me a greeting"
Atau cukup mengobrol dengan agen dan minta sapaan.
Referensi metadata skill
Frontmatter YAML mendukung bidang berikut:
| Bidang | Wajib | Deskripsi |
|---|---|---|
name |
Ya | Pengidentifikasi unik menggunakan huruf kecil, digit, dan tanda hubung |
description |
Ya | Deskripsi satu baris yang ditampilkan kepada agen |
metadata.openclaw.os |
Tidak | Filter OS (["darwin"], ["linux"], dll.) |
metadata.openclaw.requires.bins |
Tidak | Biner wajib di PATH |
metadata.openclaw.requires.config |
Tidak | Kunci konfigurasi wajib |
Praktik terbaik
- Ringkas — instruksikan model tentang apa yang harus dilakukan, bukan bagaimana menjadi AI
- Utamakan keamanan — jika skill Anda menggunakan
exec, pastikan prompt tidak mengizinkan injeksi perintah arbitrer dari input yang tidak tepercaya - Uji secara lokal — gunakan
openclaw agent --message "..."untuk menguji sebelum membagikan - Gunakan ClawHub — jelajahi dan kontribusikan skills di ClawHub
Tempat skills berada
| Lokasi | Prioritas | Cakupan |
|---|---|---|
\<workspace\>/skills/ |
Tertinggi | Per agen |
\<workspace\>/.agents/skills/ |
Tinggi | Agen per workspace |
~/.agents/skills/ |
Sedang | Profil agen bersama |
~/.openclaw/skills/ |
Sedang | Bersama (semua agen) |
| Bundled (dikirim bersama OpenClaw) | Rendah | Global |
skills.load.extraDirs |
Terendah | Folder bersama khusus |
Terkait
- Referensi Skills — aturan pemuatan, prioritas, dan gating
- Konfigurasi Skills — skema konfigurasi
skills.* - ClawHub — registry skill publik
- Membangun Plugins — plugins dapat mengirim skills