Langsung ke konten utama

​
Membuat Skills

Skills mengajarkan agen bagaimana dan kapan menggunakan tool. Setiap skill adalah direktori yang berisi file SKILL.md dengan frontmatter YAML dan instruksi markdown. Untuk cara Skills dimuat dan diprioritaskan, lihat Skills.

​
Buat skill pertama Anda

1

Buat direktori skill

Skills berada di workspace Anda. Buat folder baru:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

Tulis SKILL.md

Buat SKILL.md di dalam direktori tersebut. Frontmatter mendefinisikan metadata, dan body markdown berisi instruksi untuk agen.
---
name: hello_world
description: Skill sederhana yang menyapa.
---

# Hello World Skill

Saat pengguna meminta sapaan, gunakan tool `echo` untuk mengatakan
"Hello from your custom skill!".
3

Tambahkan tools (opsional)

Anda dapat mendefinisikan schema tool kustom di frontmatter atau menginstruksikan agen untuk menggunakan tool sistem yang sudah ada (seperti exec atau browser). Skills juga dapat dikirim di dalam plugin bersama tool yang mereka dokumentasikan.
4

Muat skill

Mulai sesi baru agar OpenClaw mengambil skill tersebut:
# Dari chat
/new

# Atau restart gateway
openclaw gateway restart
Verifikasi bahwa skill telah dimuat:
openclaw skills list
5

Uji

Kirim pesan yang seharusnya memicu skill:
openclaw agent --message "give me a greeting"
Atau cukup chat dengan agen dan minta sapaan.

​
Referensi metadata skill

Frontmatter YAML mendukung field berikut:
FieldWajibDeskripsi
nameYaPengenal unik (snake_case)
descriptionYaDeskripsi satu baris yang ditampilkan ke agen
metadata.openclaw.osTidakFilter OS (["darwin"], ["linux"], dll.)
metadata.openclaw.requires.binsTidakBiner yang diperlukan di PATH
metadata.openclaw.requires.configTidakKunci config yang diperlukan

​
Praktik terbaik

  • Ringkaslah — instruksikan model tentang apa yang harus dilakukan, bukan bagaimana menjadi AI
  • Utamakan keamanan — jika skill Anda menggunakan exec, pastikan prompt tidak memungkinkan injeksi perintah arbitrer dari input yang tidak tepercaya
  • Uji secara lokal — gunakan openclaw agent --message "..." untuk menguji sebelum membagikan
  • Gunakan ClawHub — telusuri dan kontribusikan Skills di ClawHub

​
Tempat Skills berada

LocationPrioritasCakupan
\<workspace\>/skills/TertinggiPer-agen
\<workspace\>/.agents/skills/TinggiAgen per-workspace
~/.agents/skills/SedangProfil agen bersama
~/.openclaw/skills/SedangBersama (semua agen)
Bundled (dikirim bersama OpenClaw)RendahGlobal
skills.load.extraDirsTerendahFolder bersama kustom

​
Terkait