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 apa pun kepada agen tersebut.
• Daftar agents.list[].skills yang tidak kosong merupakan kumpulan akhir — daftar ini tidak digabungkan dengan nilai bawaan.
• Daftar izin efektif berlaku pada pembuatan prompt, penemuan perintah garis miring, sinkronisasi sandbox, dan rekam jepret skill.
• Ini bukan batas otorisasi shell hos. Jika agen yang sama dapat menggunakan exec, batasi shell tersebut secara terpisah dengan sandbox, isolasi pengguna OS, daftar tolak/izin eksekusi, dan kredensial per sumber daya.

openclaw skills install menginstal ke direktori skills/ ruang kerja aktif secara default. Tambahkan --global untuk menginstal ke direktori bersama ~/.openclaw/skills, yang terlihat oleh semua agen lokal kecuali dibatasi oleh daftar izin agen.

Instalasi Git dan lokal mengharapkan SKILL.md di akar sumber. Slug berasal dari frontmatter name di SKILL.md jika valid, lalu menggunakan nama direktori atau repositori sebagai alternatif. Gunakan --as <slug> untuk menggantinya. openclaw skills update hanya melacak instalasi ClawHub — instal ulang sumber Git atau lokal untuk memperbaruinya.

openclaw skills verify @owner/<slug> meminta lingkup kepercayaan clawhub.skill.verify.v1 milik skill kepada ClawHub. Skill ClawHub yang terinstal diverifikasi berdasarkan versi dan registri yang tercatat dalam .clawhub/origin.json. Slug tanpa pemilik tetap diterima untuk skill terinstal yang sudah ada atau tidak ambigu, tetapi referensi dengan pemilik mencegah ambiguitas penerbit.

Halaman skill ClawHub menampilkan status pemindaian keamanan terbaru sebelum instalasi, dengan halaman detail untuk VirusTotal, ClawScan, dan analisis statis. Perintah keluar dengan kode bukan nol ketika ClawHub menandai verifikasi sebagai gagal. Penerbit dapat memulihkan hasil positif palsu melalui dasbor ClawHub atau clawhub skill rescan @owner/<slug>.

Klien Gateway yang memerlukan pengiriman non-ClawHub dapat menyiapkan arsip skill zip dengan skills.upload.begin, skills.upload.chunk, dan skills.upload.commit, lalu menginstalnya dengan skills.install({ source: "upload", ... }). Jalur ini dinonaktifkan secara default dan memerlukan skills.install.allowUploadedArchives: true dalam openclaw.json. Instalasi ClawHub biasa tidak pernah memerlukan pengaturan tersebut.

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

Konfigurasikan security.installPolicy untuk menjalankan perintah kebijakan lokal tepercaya sebelum instalasi skill dilanjutkan. Kebijakan menerima metadata dan jalur sumber yang telah disiapkan, berlaku untuk jalur ClawHub, unggahan, Git, lokal, pembaruan, dan penginstal dependensi, serta gagal secara tertutup ketika perintah tidak dapat mengembalikan keputusan yang valid.

skills.entries.*.env dan skills.entries.*.apiKey menyuntikkan rahasia ke dalam proses hos hanya untuk giliran agen tersebut — bukan ke dalam sandbox. Jangan sertakan rahasia dalam prompt dan log.

• Jika beberapa penginstal dicantumkan, Gateway memilih satu opsi yang diutamakan (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 (bawaan: npm; opsi: npm / pnpm / yarn / bun). Ini hanya memengaruhi instalasi skill; runtime Gateway harus tetap menggunakan Node.
• Urutan preferensi penginstal Gateway: Homebrew → uv → pengelola node yang dikonfigurasi → go → unduhan.

• Homebrew: OpenClaw tidak menginstal Homebrew secara otomatis atau menerjemahkan formula brew menjadi perintah paket sistem. Dalam kontainer Linux tanpa brew, penginstal yang hanya mendukung brew disembunyikan; gunakan image khusus atau instal dependensinya secara manual.
• Go: OpenClaw memerlukan Go 1.21 atau yang lebih baru untuk instalasi skill otomatis. Jika go tidak tersedia dan Homebrew tersedia, OpenClaw menginstal Go melalui Homebrew terlebih dahulu; pada Linux tanpa Homebrew, OpenClaw dapat menggunakan apt-get sebagai root atau melalui sudo tanpa kata sandi jika kandidat golang-go yang telah diperbarui memenuhi versi minimum. Perintah go install sebenarnya untuk dependensi selalu menargetkan direktori bin khusus yang dikelola OpenClaw (bin milik Homebrew pada instalasi baru, jika tidak ~/.local/bin), bukan GOBIN yang Anda konfigurasikan — variabel lingkungan GOBIN, GOPATH, dan GOTOOLCHAIN milik Anda dibaca tetapi tidak pernah ditimpa.
• Unduhan: url (wajib), archive (tar.gz | tar.bz2 | zip), extract (bawaan: otomatis ketika arsip terdeteksi), stripComponents, targetDir (bawaan: ~/.openclaw/tools/<skillKey>).

requires.bins diperiksa pada host saat skill dimuat. Jika agen berjalan dalam sandbox, berkas biner juga harus tersedia di dalam kontainer. Instal melalui agents.defaults.sandbox.docker.setupCommand atau image khusus. setupCommand dijalankan sekali setelah kontainer dibuat dan memerlukan akses jaringan keluar, sistem berkas root yang dapat ditulisi, serta pengguna root di sandbox.

Secara bawaan, OpenClaw memantau folder skill dan memperbarui snapshot ketika berkas SKILL.md berubah. Konfigurasikan di bawah skills.load:

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

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 jika Skill Workshop juga harus menerapkan usulan melalui jalur symlink tepercaya tersebut.

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

Node luring tidak membuat skill khusus jarak jauh terlihat. Jika Node berhenti merespons pemeriksaan berkas biner, OpenClaw menghapus kecocokan berkas biner yang tersimpan dalam cache.