English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Skills

Membuat Skills

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

  • Create the skill directory

    Skills berada di workspace Anda. Buat folder baru:

    bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world

  • Write SKILL.md

    Buat SKILL.md di dalam direktori tersebut. Frontmatter mendefinisikan metadata, dan isi markdown berisi instruksi untuk agen.

    markdown
    ---name: hello-worlddescription: 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.

  • 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.

  • Load the skill

    Mulai sesi baru agar OpenClaw mengambil skill tersebut:

    bash
    # From chat/new # Or restart the gatewayopenclaw gateway restart

    Verifikasi bahwa skill telah dimuat:

    bash
    openclaw skills list

  • Test it

    Kirim pesan yang seharusnya memicu skill:

    bash
    openclaw agent --message "give me a greeting"

    Atau cukup mengobrol dengan agen dan meminta 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 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

    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)
    Terbundel (dikirimkan bersama OpenClaw) Rendah Global
    skills.load.extraDirs Terendah Folder bersama kustom

    Terkait

    Was this useful?