Skills

OpenClaw menggunakan folder skill yang kompatibel dengan AgentSkills untuk mengajarkan agen cara menggunakan alat. Setiap skill adalah direktori yang berisi SKILL.md dengan frontmatter YAML dan instruksi. OpenClaw memuat skill bawaan beserta override lokal opsional, lalu memfilternya pada waktu pemuatan berdasarkan lingkungan, konfigurasi, dan keberadaan biner.

# Lokasi dan prioritas

OpenClaw memuat skill dari sumber berikut, prioritas tertinggi terlebih dahulu:

#	Sumber	Path
1	Skill workspace	<workspace>/skills
2	Skill agen proyek	<workspace>/.agents/skills
3	Skill agen personal	~/.agents/skills
4	Skill terkelola/lokal	~/.openclaw/skills
5	Skill bawaan	dikirim bersama instalasi
6	Folder skill tambahan	skills.load.extraDirs (konfig)

Jika nama skill bertabrakan, sumber tertinggi menang.

Direktori native Codex CLI $CODEX_HOME/skills bukan salah satu root skill OpenClaw ini. Dalam mode harness Codex, peluncuran app-server lokal menggunakan home Codex per agen yang terisolasi, sehingga skill personal Codex CLI tidak dimuat secara implisit. Gunakan openclaw migrate codex --dry-run untuk menginventarisasinya dan openclaw migrate codex untuk memilih direktori skill dengan prompt checkbox interaktif sebelum menyalinnya ke workspace agen OpenClaw saat ini. Untuk eksekusi non-interaktif, ulangi --skill <name> untuk skill persis yang akan disalin.

# Skill per agen vs bersama

Dalam setup multi-agen, setiap agen memiliki workspace sendiri:

Cakupan	Path	Terlihat oleh
Per agen	<workspace>/skills	Hanya agen tersebut
Agen proyek	<workspace>/.agents/skills	Hanya agen workspace tersebut
Agen personal	~/.agents/skills	Semua agen di mesin tersebut
Terkelola/lokal bersama	~/.openclaw/skills	Semua agen di mesin tersebut
Direktori tambahan bersama	skills.load.extraDirs (prioritas terendah)	Semua agen di mesin tersebut

Nama yang sama di beberapa tempat → sumber tertinggi menang. Workspace mengalahkan agen proyek, mengalahkan agen personal, mengalahkan terkelola/lokal, mengalahkan bawaan, mengalahkan direktori tambahan.

# Allowlist skill agen

Lokasi skill dan visibilitas skill adalah kontrol terpisah. Lokasi/prioritas menentukan salinan mana dari skill bernama sama yang menang; allowlist agen menentukan skill mana yang benar-benar dapat digunakan agen.

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

# Plugin dan skill

Plugin dapat membawa skill sendiri dengan mencantumkan direktori skills di openclaw.plugin.json (path relatif terhadap root plugin). Skill plugin dimuat saat plugin diaktifkan. Ini adalah tempat yang tepat untuk panduan pengoperasian khusus alat yang terlalu panjang untuk deskripsi alat, tetapi harus tersedia setiap kali plugin terinstal - misalnya, plugin browser membawa skill browser-automation untuk kontrol browser multi-langkah.

Direktori skill plugin digabungkan ke path berprioritas rendah yang sama seperti skills.load.extraDirs, sehingga skill bawaan, terkelola, agen, atau workspace dengan nama yang sama akan mengesampingkannya. Anda dapat membatasinya melalui metadata.openclaw.requires.config pada entri konfigurasi plugin.

Lihat Plugin untuk penemuan/konfigurasi dan Alat untuk permukaan alat yang diajarkan skill tersebut.

# Skill Workshop

Plugin Skill Workshop yang opsional dan eksperimental dapat membuat atau memperbarui skill workspace dari prosedur pakai ulang yang diamati selama kerja agen. Plugin ini dinonaktifkan secara default dan harus diaktifkan secara eksplisit melalui plugins.entries.skill-workshop.

Skill Workshop hanya menulis ke <workspace>/skills, memindai konten yang dihasilkan, mendukung persetujuan tertunda atau penulisan aman otomatis, mengarantina proposal yang tidak aman, dan menyegarkan snapshot skill setelah penulisan berhasil sehingga skill baru tersedia tanpa restart Gateway.

Gunakan untuk koreksi seperti "lain kali, verifikasi atribusi GIF" atau alur kerja yang didapat dengan susah payah seperti checklist QA media. Mulai dengan persetujuan tertunda; gunakan penulisan otomatis hanya di workspace tepercaya setelah meninjau proposalnya. Panduan lengkap: Plugin Skill Workshop.

# ClawHub (instal dan sinkronisasi)

ClawHub adalah registry skill publik untuk OpenClaw. Gunakan perintah native openclaw skills untuk menemukan/menginstal/memperbarui, atau CLI clawhub terpisah untuk alur kerja publikasi/sinkronisasi. Panduan lengkap: ClawHub.

Tindakan	Perintah
Instal skill ke workspace	openclaw skills install <skill-slug>
Perbarui semua skill terinstal	openclaw skills update --all
Sinkronkan (pindai + publikasikan pembaruan)	clawhub sync --all

Native openclaw skills install menginstal ke direktori skills/ workspace aktif. CLI clawhub terpisah juga menginstal ke ./skills di bawah direktori kerja saat ini (atau fallback ke workspace OpenClaw yang dikonfigurasi). OpenClaw mengambilnya sebagai <workspace>/skills pada sesi berikutnya. Root skill yang dikonfigurasi juga mendukung satu tingkat pengelompokan, seperti skills/<group>/<skill>/SKILL.md, sehingga skill pihak ketiga terkait dapat disimpan di bawah folder bersama tanpa pemindaian rekursif luas.

Halaman skill ClawHub menampilkan status pemindaian keamanan terbaru sebelum instalasi, dengan halaman detail pemindai untuk VirusTotal, ClawScan, dan analisis statis. openclaw skills install <slug> tetap hanya merupakan path instalasi; penerbit memulihkan positif palsu melalui dasbor ClawHub atau clawhub skill rescan <slug>.

# Keamanan

• Penemuan skill workspace dan direktori tambahan hanya menerima root skill dan file SKILL.md yang realpath hasil resolusinya tetap berada di dalam root yang dikonfigurasi.
• Instalasi dependensi skill berbasis Gateway (skills.install, onboarding, dan UI pengaturan Skills) menjalankan pemindai kode berbahaya bawaan sebelum mengeksekusi metadata penginstal. Temuan critical memblokir secara default kecuali pemanggil secara eksplisit menetapkan override berbahaya; temuan mencurigakan tetap hanya memberi peringatan.
• openclaw skills install <slug> berbeda - perintah ini mengunduh folder skill ClawHub ke workspace dan tidak menggunakan path metadata penginstal di atas.
• skills.entries.*.env dan skills.entries.*.apiKey menyuntikkan rahasia ke proses host untuk giliran agen tersebut (bukan sandbox). Jauhkan rahasia dari prompt dan log.

Untuk model ancaman dan checklist yang lebih luas, lihat Keamanan.

# Format SKILL.md

SKILL.md harus menyertakan setidaknya:

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

OpenClaw mengikuti spesifikasi AgentSkills untuk tata letak/intent. Parser yang digunakan oleh agen tertanam hanya mendukung key frontmatter satu baris; metadata harus berupa objek JSON satu baris. Gunakan {baseDir} dalam instruksi untuk mereferensikan path folder skill.

# Key frontmatter opsional

homepagestring

URL yang ditampilkan sebagai "Situs web" di UI Skills macOS. Juga didukung melalui metadata.openclaw.homepage.

user-invocableboolean

Saat true, skill diekspos sebagai slash command pengguna.

disable-model-invocationboolean

Saat true, OpenClaw tidak memasukkan instruksi skill ke prompt normal agen. Skill tetap terinstal dan masih dapat dijalankan secara eksplisit sebagai slash command saat user-invocable juga true.

command-dispatch"tool"

Saat disetel ke tool, slash command melewati model dan mengirim langsung ke alat.

command-toolstring

Nama alat yang akan dipanggil saat command-dispatch: tool disetel.

command-arg-mode"raw"

Untuk dispatch alat, meneruskan string arg mentah ke alat (tanpa parsing inti). Alat dipanggil dengan { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }.

# Gating (filter waktu pemuatan)

OpenClaw memfilter skill pada waktu pemuatan menggunakan metadata (JSON satu baris):

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

Field di bawah metadata.openclaw:

alwaysboolean

Saat true, selalu sertakan skill (lewati gate lain).

emojistring

Emoji opsional yang digunakan oleh UI Skills macOS.

homepagestring

URL opsional yang ditampilkan sebagai "Situs web" di UI Skills macOS.

os"darwin" | "linux" | "win32"

Daftar platform opsional. Jika disetel, skill hanya memenuhi syarat pada OS tersebut.

requires.binsstring[]

Masing-masing harus ada di PATH.

requires.anyBinsstring[]

Setidaknya satu harus ada di PATH.

requires.envstring[]

Env var harus ada atau disediakan dalam konfigurasi.

requires.configstring[]

Daftar path openclaw.json yang harus bernilai truthy.

primaryEnvstring

Nama env var yang terkait dengan skills.entries.<name>.apiKey.

installobject[]

Spesifikasi penginstal opsional yang digunakan oleh UI Skills macOS (brew/node/go/uv/download).

Jika tidak ada metadata.openclaw, skill selalu memenuhi syarat (kecuali dinonaktifkan dalam konfigurasi atau diblokir oleh skills.allowBundled untuk skill bawaan).

# Catatan sandboxing

• requires.bins diperiksa pada host saat waktu pemuatan skill.
• Jika agen disandbox, biner juga harus ada di dalam container. Instal melalui agents.defaults.sandbox.docker.setupCommand (atau image kustom). setupCommand berjalan sekali setelah container dibuat. Instalasi paket juga memerlukan egress jaringan, root FS yang dapat ditulis, dan pengguna root di sandbox.
• Contoh: skill summarize (skills/summarize/SKILL.md) membutuhkan CLI summarize di container sandbox agar dapat berjalan di sana.

# Spesifikasi penginstal

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

# Penimpaan konfigurasi

Skill bawaan dan terkelola dapat diaktifkan/nonaktifkan dan diberi nilai env di bawah skills.entries dalam ~/.openclaw/openclaw.json:

{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

enabledboolean

false menonaktifkan skill meskipun skill tersebut dibundel atau diinstal. Skill bawaan coding-agent bersifat opt-in: tetapkan skills.entries.coding-agent.enabled: true sebelum mengeksposnya ke agen, lalu pastikan salah satu dari claude, codex, opencode, atau pi telah diinstal dan diautentikasi untuk CLI miliknya sendiri.

apiKeystring | { source, provider, id }

Kemudahan untuk skill yang mendeklarasikan metadata.openclaw.primaryEnv. Mendukung teks biasa atau SecretRef.

env"Record<string,

configobject

Kantong opsional untuk bidang kustom per skill. Kunci kustom harus berada di sini.

allowBundledstring[]

Allowlist opsional hanya untuk skill bawaan. Jika ditetapkan, hanya skill bawaan dalam daftar yang memenuhi syarat (skill terkelola/workspace tidak terpengaruh).

Jika nama skill berisi tanda hubung, beri tanda kutip pada kuncinya (JSON5 mengizinkan kunci yang diberi tanda kutip). Kunci konfigurasi cocok dengan nama skill secara default - jika sebuah skill mendefinisikan metadata.openclaw.skillKey, gunakan kunci tersebut di bawah skills.entries.

# Injeksi lingkungan

Ketika proses agen dimulai, OpenClaw:

1. Membaca metadata skill.
2. Menerapkan skills.entries.<key>.env dan skills.entries.<key>.apiKey ke process.env.
3. Membangun prompt sistem dengan skill yang memenuhi syarat.
4. Memulihkan lingkungan asli setelah proses berakhir.

Injeksi lingkungan terbatas pada proses agen, bukan lingkungan shell global.

Untuk backend bawaan claude-cli, OpenClaw juga mewujudkan snapshot memenuhi syarat yang sama sebagai Plugin Claude Code sementara dan meneruskannya dengan --plugin-dir. Claude Code kemudian dapat menggunakan resolver skill native-nya sementara OpenClaw tetap memiliki presedensi, allowlist per agen, gating, dan injeksi kunci env/API skills.entries.*. Backend CLI lain hanya menggunakan katalog prompt.

# Snapshot dan refresh

OpenClaw membuat snapshot skill yang memenuhi syarat ketika sesi dimulai dan menggunakan kembali daftar tersebut untuk giliran berikutnya dalam sesi yang sama. Perubahan pada skill atau konfigurasi berlaku pada sesi baru berikutnya.

Skill dapat di-refresh di tengah sesi dalam dua kasus:

• Watcher skill diaktifkan.
• Node remote baru yang memenuhi syarat muncul.

Anggap ini sebagai hot reload: daftar yang di-refresh digunakan pada giliran agen berikutnya. Jika allowlist skill agen efektif berubah untuk sesi tersebut, OpenClaw me-refresh snapshot agar skill yang terlihat tetap selaras dengan agen saat ini.

# Watcher Skills

Secara default, OpenClaw memantau folder skill dan menaikkan snapshot skill ketika file SKILL.md berubah. Konfigurasikan di bawah skills.load:

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

# Node macOS remote (Gateway Linux)

Jika Gateway berjalan di Linux tetapi node macOS terhubung dengan system.run diizinkan (keamanan persetujuan Exec tidak ditetapkan ke deny), OpenClaw dapat memperlakukan skill khusus macOS sebagai memenuhi syarat ketika biner yang diperlukan ada pada node tersebut. Agen harus menjalankan skill tersebut melalui alat exec dengan host=node.

Ini bergantung pada node yang melaporkan dukungan perintahnya dan pada probe bin melalui system.which atau system.run. Node offline tidak membuat skill khusus remote terlihat. Jika node yang terhubung berhenti menjawab probe bin, OpenClaw menghapus kecocokan bin yang di-cache sehingga agen tidak lagi melihat skill yang saat ini tidak dapat berjalan di sana.

# Dampak token

Ketika skill memenuhi syarat, OpenClaw menyuntikkan daftar XML ringkas berisi skill yang tersedia ke prompt sistem (melalui formatSkillsForPrompt di pi-coding-agent). Biayanya deterministik:

• Overhead dasar (hanya ketika ≥1 skill): 195 karakter.
• Per skill: 97 karakter + panjang nilai <name>, <description>, dan <location> yang di-escape XML.

Rumus (karakter):

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

Escape XML memperluas & < > " ' menjadi entitas (&, <, dll.), sehingga panjang bertambah. Jumlah token bervariasi menurut tokenizer model. Perkiraan kasar bergaya OpenAI adalah ~4 karakter/token, jadi 97 karakter ≈ 24 token per skill ditambah panjang bidang aktual Anda.

# Siklus hidup skill terkelola

OpenClaw mengirimkan set dasar skill sebagai skill bawaan bersama instalasi (paket npm atau OpenClaw.app). ~/.openclaw/skills tersedia untuk penimpaan lokal - misalnya, mem-pin atau menambal skill tanpa mengubah salinan bawaan. Skill workspace dimiliki pengguna dan menimpa keduanya pada konflik nama.

# Mencari skill lainnya?

Jelajahi https://clawhub.ai. Skema konfigurasi lengkap: Konfigurasi Skills.

# Terkait

• ClawHub - registri skill publik
• Membuat skill - membangun skill kustom
• Plugin - ringkasan sistem plugin
• Plugin Skill Workshop - menghasilkan skill dari pekerjaan agen
• Konfigurasi Skills - referensi konfigurasi skill
• Perintah slash - semua perintah slash yang tersedia