Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Skills mengajarkan 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

1

Create the skill directory

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

Write SKILL.md

Buat SKILL.md di dalam direktori tersebut. Frontmatter mendefinisikan metadata, dan isi markdown berisi 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. Pastikan nama folder dan name frontmatter selaras.
3

Add tools (optional)

Anda dapat mendefinisikan skema alat kustom di frontmatter atau menginstruksikan agen untuk menggunakan alat sistem yang sudah ada (seperti exec atau browser). Skills juga dapat dikirimkan di dalam plugin bersama alat yang didokumentasikannya.
4

Load the 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
5

Test it

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

Referensi metadata skill

Frontmatter YAML mendukung bidang berikut:
BidangWajibDeskripsi
nameYaPengidentifikasi unik menggunakan huruf kecil, digit, dan tanda hubung
descriptionYaDeskripsi satu baris yang ditampilkan kepada agen
metadata.openclaw.osTidakFilter OS (["darwin"], ["linux"], dll.)
metadata.openclaw.requires.binsTidakBiner wajib di PATH
metadata.openclaw.requires.configTidakKunci konfigurasi wajib

Praktik terbaik

  • Ringkas — instruksikan model tentang apa yang harus dilakukan, bukan cara menjadi AI
  • Keselamatan terlebih dahulu — 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 berbagi
  • Gunakan ClawHub — jelajahi dan kontribusikan skills di ClawHub

Lokasi Skills

LokasiPrioritasCakupan
\<workspace\>/skills/TertinggiPer agen
\<workspace\>/.agents/skills/TinggiAgen per workspace
~/.agents/skills/SedangProfil agen bersama
~/.openclaw/skills/SedangBersama (semua agen)
Terbundel (dikirimkan bersama OpenClaw)RendahGlobal
skills.load.extraDirsTerendahFolder bersama kustom

Terkait