Langsung ke konten utama
Skills mengajarkan agen bagaimana dan kapan menggunakan alat. Setiap skill adalah direktori yang berisi file SKILL.md dengan YAML frontmatter dan instruksi markdown. OpenClaw memuat Skills dari beberapa root dalam urutan prioritas yang ditentukan.

​
Buat skill pertama Anda

1

Create the skill directory

Skills berada di folder skills/ workspace Anda. Buat direktori untuk skill baru Anda:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Anda dapat mengelompokkan Skills dalam subfolder untuk pengorganisasian — skill tetap diberi nama oleh frontmatter SKILL.md, bukan path folder:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

Write SKILL.md

Buat SKILL.md di dalam direktori. Frontmatter mendefinisikan metadata; body memberikan instruksi kepada agen.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


Aturan penamaan:
- Gunakan huruf kecil, digit, dan tanda hubung untuk `name`.
- Selaraskan nama direktori dan `name` frontmatter.
- `description` ditampilkan kepada agen dan dalam penemuan slash-command —
  pertahankan satu baris dan kurang dari 160 karakter.

</Step>

<Step title="Verify the skill loaded">
```bash
openclaw skills list
OpenClaw memantau file SKILL.md di bawah root Skills secara default. Jika pemantau dinonaktifkan atau Anda melanjutkan sesi yang sudah ada, mulai sesi baru agar agen menerima daftar yang diperbarui:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

Test it

Kirim pesan yang seharusnya memicu skill:
openclaw agent --message "give me a greeting"
Atau buka chat dan minta langsung kepada agen. Gunakan /skill hello-world untuk memanggilnya secara eksplisit berdasarkan nama.

​
Referensi SKILL.md

​
Kolom wajib

KolomDeskripsi
nameSlug unik yang menggunakan huruf kecil, digit, dan tanda hubung
descriptionDeskripsi satu baris yang ditampilkan kepada agen dan dalam output penemuan

​
Kunci frontmatter opsional

KolomDefaultDeskripsi
user-invocabletrueMengekspos skill sebagai slash command pengguna
disable-model-invocationfalseMenjaga skill agar tidak masuk ke prompt sistem agen (tetap berjalan melalui /skill)
command-dispatch—Atur ke tool untuk merutekan slash command langsung ke alat, melewati model
command-tool—Nama alat yang dipanggil saat command-dispatch: tool diatur
command-arg-moderawUntuk dispatch alat, meneruskan string arg mentah ke alat
homepage—URL yang ditampilkan sebagai “Situs Web” di UI Skills macOS
Untuk kolom gating (requires.bins, requires.env, dll.) lihat Skills — Gating.

​
Menggunakan {baseDir}

Gunakan {baseDir} dalam body skill untuk merujuk file di dalam direktori skill tanpa melakukan hardcode path: 
Run the helper script at `{baseDir}/scripts/run.sh`.

​
Menambahkan aktivasi kondisional

Gate skill Anda agar hanya dimuat ketika dependensinya tersedia: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
KunciDeskripsi
requires.binsSemua binary harus ada di PATH
requires.anyBinsSetidaknya satu binary harus ada di PATH
requires.envSetiap env var harus ada dalam proses atau config
requires.configSetiap path openclaw.json harus bernilai truthy
osFilter platform: ["darwin"], ["linux"], ["win32"]
alwaysAtur true untuk melewati semua gate dan selalu menyertakan skill
Referensi lengkap: Skills — Gating.
Hubungkan API key ke entri skill di openclaw.json:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
Kunci disuntikkan ke proses host hanya untuk giliran agen tersebut. Kunci tidak mencapai sandbox — lihat sandboxed env vars.

​
Ajukan melalui Skill Workshop

Untuk Skills yang disusun agen atau saat Anda menginginkan peninjauan operator sebelum skill aktif, gunakan proposal Skill Workshop alih-alih menulis SKILL.md secara langsung. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"
Gunakan --proposal-dir saat proposal menyertakan file pendukung: 
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/
Direktori harus berisi PROPOSAL.md. File pendukung dapat ditempatkan di assets/, examples/, references/, scripts/, atau templates/. Setelah peninjauan: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
Lihat Skill Workshop untuk siklus hidup proposal lengkap.

​
Menerbitkan ke ClawHub

1

Ensure your SKILL.md is complete

Pastikan name, description, dan kolom gating metadata.openclaw apa pun sudah diatur. Tambahkan URL homepage jika Anda memiliki halaman proyek.
2

Install the ClawHub skill

Skill ClawHub mendokumentasikan bentuk perintah publikasi saat ini dan metadata yang diperlukan:
openclaw skills install @openclaw/clawhub-publish
3

Publish

clawhub publish
Lihat ClawHub — Publishing untuk alur lengkap.

​
Praktik terbaik

  • Ringkas — instruksikan model tentang apa yang harus dilakukan, bukan bagaimana menjadi AI.
  • Keselamatan dahulu — jika skill Anda menggunakan exec, pastikan prompt tidak mengizinkan injeksi perintah sembarang dari input yang tidak tepercaya.
  • Uji secara lokal — gunakan openclaw agent --message "..." sebelum berbagi.
  • Gunakan ClawHub — jelajahi Skills komunitas di clawhub.ai sebelum membangun dari awal.

​
Terkait

Skills reference

Urutan pemuatan, gating, allowlist, dan format SKILL.md.

Skill Workshop

Antrean proposal untuk Skills yang disusun agen.

Skills config

Skema config skills.* lengkap.

ClawHub

Jelajahi dan terbitkan Skills di registry publik.

Building plugins

Plugin dapat mengirimkan Skills bersama alat yang didokumentasikannya.