Konfigurasi skill OpenClaw

Sebagian besar hal yang menentukan skill mana yang dilihat agen OpenClaw dan bagaimana skill itu diinstal berada di bawah satu kunci di file konfigurasi, dengan visibilitas per agen di bawah entri agen. Halaman referensinya panjang karena skemanya mencakup pemuatan, instalasi, gating, Workshop, dan kebijakan instalasi milik host. Berikut seluruh permukaannya secara berurutan: pemuatan dan symlink, preferensi instalasi, kebijakan instalasi dan cara ia gagal secara tertutup, daftar izin skill bawaan dan entri per skill, daftar izin agen dan apa yang bukan fungsinya, pengaturan Workshop, dan jebakan sandbox.

Pemuatan dan instalasi

• Direktori tambahan dipindai dengan prioritas terendah, di bawah skill bawaan dan skill plugin, dengan ekspansi tilde; target symlink tepercaya adalah direktori nyata yang boleh menjadi tujuan resolve folder skill yang di-symlink meskipun tautannya berada di luar root yang dikonfigurasi, dan dokumentasi menyarankan agar daftar itu tetap sempit alih-alih diarahkan ke direktori home; watcher, yang aktif secara default, menyegarkan snapshot skill saat file skill berubah.
• Preferensi instalasi: utamakan penginstal Homebrew jika tersedia, pengelola paket Node di antara npm, pnpm, yarn, dan bun yang hanya memengaruhi instalasi skill, dan sakelar yang nonaktif secara default yang memungkinkan klien admin tepercaya menginstal arsip zip privat yang disiapkan melalui alur unggah.
• Kebijakan instalasi operator menjalankan perintah lokal tepercaya setelah OpenClaw menyiapkan sumbernya dan sebelum instalasi atau pembaruan dilanjutkan, untuk skill dari ClawHub, skill yang diunggah, skill dari Git, dan skill lokal, penginstal dependensi, serta sumber plugin; perintah itu menerima satu objek JSON yang menggambarkan target, sumber, dan asal, lalu menjawab allow, warn, atau block dengan alasan dan temuan opsional. Jika diaktifkan tanpa perintah yang valid, instalasi gagal secara tertutup, begitu pula jika ada block, exit non-zero, batas waktu habis, JSON tidak valid, atau alasan yang tidak ada.
• Peringatan menghentikan instalasi sebelum commit: perintah interaktif meminta operator mengetik nama target dan menjalankan ulang kebijakan, perintah non-interaktif dapat meneruskan flag pengakuan eksplisit, Control UI dapat meninjau peringatan instalasi plugin, instalasi lain yang didukung Gateway dan instalasi otomatis tetap diblokir, dan force tidak pernah menyetujui peringatan. Temuan dibatasi hingga seratus, pemberitahuan yang ditampilkan hingga 4.000 karakter, eksekusi doctor mendalam menjalankan probe instalasi sintetis, dan pembaruan massal menerapkan kebijakan per target.

Daftar izin skill agen adalah filter visibilitas dan pemuatan untuk penemuan skill OpenClaw, prompt, penemuan slash command, sinkronisasi sandbox, dan snapshot skill. Daftar ini bukan batas otorisasi pada saat shell berjalan.

Entri dan daftar izin

Daftar izin skill bawaan hanya membatasi skill bawaan; skill terkelola, tingkat agen, dan ruang kerja tidak terpengaruh. Entri per skill diberi kunci berdasarkan nama skill, atau berdasarkan kunci skill yang dideklarasikannya: flag enabled yang menonaktifkan skill meskipun skill itu bawaan atau sudah terinstal, dan itulah yang menyalakan skill coding-agent yang bersifat opt-in setelah CLI yang didukung terinstal dan login; kolom praktis untuk kunci API bagi skill yang mendeklarasikan variabel lingkungan utama, sebagai teks biasa atau referensi secret; variabel lingkungan yang disuntikkan untuk eksekusi agen hanya jika belum disetel di proses; dan wadah bebas untuk kolom kustom. Pembuatan gambar bawaan menggunakan pengaturan model media dan alat gambar inti, bukan sebuah entri. Daftar izin agen memberikan set skill terlihat yang berbeda per agen untuk root mesin dan ruang kerja yang sama: baseline bersama di bawah nilai default, yang diwarisi agen yang tidak memiliki daftarnya sendiri, dan daftar eksplisit yang sepenuhnya menggantikan nilai default, dengan daftar kosong yang tidak mengekspos skill apa pun. Peringatannya penting: jika agen dapat menjalankan exec di host, shell tersebut tetap dapat menjalankan klien eksternal dan membaca file host yang terlihat oleh pengguna eksekusi, termasuk registri klien MCP, jadi isolasi per agen memerlukan sandbox atau isolasi pengguna OS, exec yang ditolak atau daftar izin exec yang ketat, dan kredensial per agen di server MCP.

Workshop, symlink, sandbox

• Pengaturan Workshop: mode otonom off, propose, atau auto, di mana auto, yang merupakan default, menggunakan alat agen biasa untuk pemeliharaan langsung per giliran dan mingguan tanpa pemindaian proposal, sedangkan propose membuat proposal tertunda dari koreksi dan pekerjaan substansial yang sudah selesai; kebijakan persetujuan auto atau pending; maksimum lima puluh proposal tertunda dan dikarantina per agen dalam rentang satu hingga dua ratus; dan ukuran body proposal maksimum 40.000 byte dalam rentang sekitar 1.000 hingga 200.000, dengan deskripsi dibatasi keras pada 160 byte.
• Root skill ruang kerja, project-agent, extra-dir, dan bawaan adalah batas penahanan, jadi folder skill yang di-symlink dan di-resolve ke luar root-nya dilewati dengan satu baris log kecuali targetnya tepercaya; direktori skill terkelola dan pribadi menerima symlink direktori skill tanpa syarat, dan Workshop menggunakan direktori penahanan milik masing-masing agen, mengabaikan daftar target tepercaya, dan menolak symlink yang keluar darinya.
• Nilai env dan kunci API per skill hanya berlaku untuk eksekusi di host: di dalam sandbox, nilai tersebut tidak berpengaruh, jadi skill yang bergantung pada kunci akan gagal dengan error not-configured kecuali sandbox diberi variabel itu secara terpisah melalui env sandbox Docker, dan pengguna yang memiliki akses ke daemon Docker dapat membaca nilai tersebut melalui metadata container, jadi file secret yang di-mount atau image kustom adalah jawabannya jika paparan itu tidak dapat diterima.

Pembelajaran mandiri OpenClaw menjelaskan aturan kelayakan dan privasi di balik mode otonom, dan membuat skill OpenClaw menjelaskan file yang dipantau oleh loader.

Mengapa catatan tentang batas itu penting

Skema ini mencampur kontrol visibilitas dengan kontrol keamanan, dan dokumentasi berhati-hati menyebutkan mana yang mana: daftar izin membentuk apa yang ditawarkan kepada agen, kebijakan instalasi membentuk apa yang dapat diinstal, dan hanya sandboxing atau pemisahan pengguna OS yang membentuk apa yang dapat dijangkau shell. Penjelasan sandboxing OpenClaw adalah lapisan terakhir itu, dan plugin OpenClaw adalah permukaan instalasi saudaranya yang juga dicakup kebijakan tersebut.

Di Diali

Di Diali, hub skill di dasbor adalah antarmuka depan untuk file ini: menyalakan skill dan menempelkan kuncinya itulah yang menjadi entri pada asisten, dan tidak ada shell host untuk mengeditnya secara manual. OpenClaw yang di-hosting di Diali adalah asistennya dan keamanan Diali menjelaskan batas di sekeliling masing-masing asisten.

• Daftar izin menggantikan; tidak pernah menggabungkan.
• Kebijakan instalasi gagal secara tertutup untuk apa pun selain allow yang bersih.
• Variabel env skill berhenti di dinding sandbox.