Skills

• Hilangkan agents.defaults.skills agar semua skill tidak dibatasi secara default.
• Hilangkan agents.list[].skills untuk mewarisi agents.defaults.skills.
• Atur agents.list[].skills: [] agar tidak mengekspos skill untuk agen tersebut.
• Daftar agents.list[].skills yang tidak kosong adalah set final — daftar itu tidak digabung dengan default.
• Allowlist efektif berlaku di seluruh pembuatan prompt, penemuan slash-command, sinkronisasi sandbox, dan snapshot skill.
• Ini bukan batas otorisasi shell host. Jika agen yang sama dapat menggunakan exec, batasi shell tersebut secara terpisah dengan sandboxing, isolasi pengguna OS, deny/allowlist exec, dan kredensial per resource.

openclaw skills install secara default menginstal ke direktori skills/ workspace aktif. Tambahkan --global untuk menginstal ke direktori bersama ~/.openclaw/skills, terlihat oleh semua agen lokal kecuali allowlist agen mempersempitnya.

Instalasi Git dan lokal mengharapkan SKILL.md di root sumber. Slug berasal dari frontmatter SKILL.md name saat valid, lalu fallback ke nama direktori atau repositori. Gunakan --as <slug> untuk mengganti. openclaw skills update hanya melacak instalasi ClawHub — instal ulang sumber Git atau lokal untuk menyegarkannya.

openclaw skills verify @owner/<slug> meminta trust envelope clawhub.skill.verify.v1 skill kepada ClawHub. Skill ClawHub yang terinstal diverifikasi terhadap versi dan registry yang dicatat di .clawhub/origin.json. Slug polos tetap diterima untuk skill yang sudah terinstal atau tidak ambigu, tetapi ref berkualifikasi owner menghindari ambiguitas publisher.

Halaman skill ClawHub mengekspos status pemindaian keamanan terbaru sebelum instalasi, dengan halaman detail untuk VirusTotal, ClawScan, dan analisis statis. Perintah keluar non-zero ketika ClawHub menandai verifikasi sebagai gagal. Publisher memulihkan false positive melalui dasbor ClawHub atau clawhub skill rescan @owner/<slug>.

Klien Gateway yang membutuhkan pengiriman non-ClawHub dapat menyiapkan arsip skill zip dengan skills.upload.begin, skills.upload.chunk, dan skills.upload.commit, lalu menginstal dengan skills.install({ source: "upload", ... }). Path ini nonaktif secara default dan memerlukan skills.install.allowUploadedArchives: true di openclaw.json. Instalasi ClawHub normal tidak pernah memerlukan pengaturan tersebut.

Penemuan skill workspace, agen proyek, dan direktori tambahan hanya menerima root skill yang realpath terselesaikannya tetap berada di dalam root yang dikonfigurasi, kecuali skills.load.allowSymlinkTargets secara eksplisit memercayai root target. Skill Workshop menulis melalui target tepercaya tersebut hanya ketika skills.workshop.allowSymlinkTargetWrites diaktifkan. ~/.openclaw/skills terkelola dan ~/.agents/skills pribadi dapat berisi folder skill bersymlink, tetapi setiap realpath SKILL.md tetap harus berada di dalam direktori skill yang terselesaikan.

Konfigurasikan security.installPolicy untuk menjalankan perintah kebijakan lokal tepercaya sebelum instalasi skill berlanjut. Kebijakan menerima metadata dan path sumber yang telah disiapkan, berlaku untuk path ClawHub, uploaded, Git, local, update, dan dependency-installer, serta gagal tertutup ketika perintah tidak dapat mengembalikan keputusan yang valid.

skills.entries.*.env dan skills.entries.*.apiKey menyuntikkan secret ke proses host hanya untuk giliran agen tersebut — bukan ke sandbox. Jauhkan secret dari prompt dan log.

• Ketika beberapa penginstal dicantumkan, gateway memilih satu opsi pilihan (brew jika tersedia, jika tidak node).
• Jika semua penginstal adalah download, OpenClaw mencantumkan setiap entri agar Anda dapat melihat semua artefak yang tersedia.
• Spesifikasi dapat menyertakan os: ["darwin"|"linux"|"win32"] untuk memfilter berdasarkan platform.
• Instalasi Node mengikuti skills.install.nodeManager di openclaw.json (default: npm; opsi: npm / pnpm / yarn / bun). Ini hanya memengaruhi instalasi skill; runtime Gateway tetap harus Node.
• Preferensi penginstal Gateway: Homebrew → uv → manajer node yang dikonfigurasi → go → download.

• Homebrew: OpenClaw tidak menginstal Homebrew secara otomatis atau menerjemahkan formula brew menjadi perintah paket sistem. Di kontainer Linux tanpa brew, penginstal khusus brew disembunyikan; gunakan image kustom atau instal dependensi secara manual.
• Go: OpenClaw memerlukan Go 1.21 atau yang lebih baru untuk instalasi skill otomatis dan mempertahankan pengaturan GOBIN, GOPATH, dan GOTOOLCHAIN yang ada. Jika toolchain yang dikonfigurasi tidak dapat memenuhi versi Go yang diwajibkan modul, onboarding mengelompokkan skill dengan prasyarat Go manual setelah percobaan instalasi. Jika go tidak ada dan Homebrew tersedia, OpenClaw menginstal Go melalui Homebrew terlebih dahulu dan mengatur GOBIN ke bin milik Homebrew. Di Linux, OpenClaw dapat menggunakan apt-get sebagai root atau melalui sudo tanpa sandi ketika kandidat golang-go yang diperbarui memenuhi versi minimum.
• Download: url (wajib), archive (tar.gz | tar.bz2 | zip), extract (default: otomatis ketika arsip terdeteksi), stripComponents, targetDir (default: ~/.openclaw/tools/<skillKey>).

requires.bins diperiksa pada host saat skill dimuat. Jika agen berjalan di sandbox, biner juga harus ada di dalam kontainer. Instal melalui agents.defaults.sandbox.docker.setupCommand atau image kustom. setupCommand berjalan sekali setelah pembuatan kontainer dan memerlukan egress jaringan, root FS yang dapat ditulis, dan pengguna root di sandbox.

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

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },  },}

Gunakan allowSymlinkTargets untuk tata letak symlink yang disengaja ketika symlink root skill mengarah ke luar root yang dikonfigurasi, misalnya <workspace>/skills/manager -> ~/Projects/manager/skills. Aktifkan skills.workshop.allowSymlinkTargetWrites hanya ketika Skill Workshop juga harus menerapkan proposal melalui path symlink tepercaya tersebut.

Jika Gateway berjalan di Linux tetapi node macOS tersambung dengan system.run diizinkan, OpenClaw dapat menganggap skill khusus macOS memenuhi syarat ketika biner yang diperlukan ada pada node tersebut. Agen harus menjalankan skill tersebut melalui alat exec dengan host=node.

Node offline tidak membuat skill khusus remote terlihat. Jika sebuah node berhenti menjawab probe bin, OpenClaw menghapus kecocokan bin yang di-cache.