Konfigurasi Skills

Sebagian besar konfigurasi Skills berada di bawah skills dalam ~/.openclaw/openclaw.json. Visibilitas khusus agen berada di bawah agents.defaults.skills dan agents.list[].skills.

{  skills: {    allowBundled: ["gemini", "peekaboo"],    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true,      watchDebounceMs: 250,    },    install: {      preferBrew: true,      nodeManager: "npm",      allowUploadedArchives: false,    },    workshop: {      autonomous: { enabled: false },      allowSymlinkTargetWrites: false,      approvalPolicy: "auto",      maxPending: 50,      maxSkillBytes: 40000,    },    entries: {      "image-lab": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },      },      peekaboo: { enabled: true },      sag: { enabled: false },    },  },}

Pemuatan (skills.load)

Instalasi (skills.install)

Kebijakan Instalasi Operator (security.installPolicy)

Gunakan security.installPolicy ketika operator memerlukan perintah lokal tepercaya untuk menyetujui atau memblokir instalasi Skills dan Plugin dengan kebijakan khusus host. Kebijakan dijalankan setelah OpenClaw menempatkan materi sumber dan sebelum instalasi atau pembaruan dilanjutkan. Kebijakan ini berlaku untuk Skills ClawHub, Skills yang diunggah, Skills Git/lokal, penginstal dependensi Skills, serta sumber instalasi/pembaruan Plugin.

{  security: {    installPolicy: {      enabled: true,      // Hilangkan targets agar mencakup setiap target yang didukung.      targets: ["skill", "plugin"],      exec: {        source: "exec",        command: "/usr/local/bin/openclaw-install-policy",        args: ["--json"],        timeoutMs: 10000,        noOutputTimeoutMs: 10000,        maxOutputBytes: 1048576,        passEnv: ["OPENCLAW_STATE_DIR", "PATH"],        env: { POLICY_MODE: "strict" },        trustedDirs: ["/usr/local/bin"],      },    },  },}

Kebijakan menerima satu objek JSON melalui stdin dengan protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, source terstruktur yang opsional, origin terstruktur, dan request. Kebijakan harus menulis satu objek JSON ke stdout: { "protocolVersion": 1, "decision": "allow" } atau { "protocolVersion": 1, "decision": "block", "reason": "..." }. Kode keluar bukan nol, batas waktu, JSON cacat, kolom yang hilang, atau versi protokol yang tidak didukung akan ditolak secara tertutup.

OpenClaw tidak menjalankan kebijakan instalasi selama startup Gateway normal. Instalasi dan pembaruan ditolak secara tertutup ketika kebijakan diaktifkan tetapi tidak tersedia. openclaw doctor melakukan validasi statis; openclaw doctor --deep menjalankan probe instalasi sintetis terhadap perintah yang dikonfigurasi.

Pembaruan massal menerapkan kebijakan per target: pembaruan Skills atau Plugin yang diblokir akan menggagalkan target tersebut tanpa menonaktifkan kebijakan atau melewati target berikutnya dalam batch.

Contoh stdin:

{  "protocolVersion": 1,  "openclawVersion": "2026.6.1",  "targetType": "skill",  "targetName": "weather",  "sourcePath": "/var/folders/.../openclaw-skill-clawhub/root",  "sourcePathKind": "directory",  "source": {    "kind": "clawhub",    "authority": "openclaw",    "mutable": false,    "network": true  },  "origin": {    "type": "clawhub",    "registry": "https://clawhub.openclaw.ai",    "slug": "weather",    "version": "1.0.0"  },  "request": {    "kind": "skill-install",    "mode": "install",    "requestedSpecifier": "clawhub:weather@1.0.0"  },  "skill": {    "installId": "clawhub"  }}

Perintah kebijakan minimal:

#!/usr/bin/env node let input = "";process.stdin.setEncoding("utf8");process.stdin.on("data", (chunk) => {  input += chunk;});process.stdin.on("end", () => {  const request = JSON.parse(input);  if (request.targetType === "plugin" && request.source?.kind === "local-path") {    process.stdout.write(      JSON.stringify({        protocolVersion: 1,        decision: "block",        reason: "path Plugin lokal tidak disetujui pada host ini",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Daftar izin Skills bawaan

Entri per Skills (skills.entries)

Secara default, kunci di bawah entries cocok dengan name Skills. Jika sebuah Skills mendefinisikan metadata.openclaw.skillKey, gunakan kunci tersebut sebagai gantinya. Beri tanda kutip pada nama yang mengandung tanda hubung (JSON5 mengizinkan kunci bertanda kutip).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false menonaktifkan Skills meskipun merupakan bawaan atau telah diinstal. Skills bawaan coding-agent bersifat pilihan — tetapkan ke true dan pastikan salah satu dari claude, codex, opencode, atau CLI lain yang didukung telah diinstal dan diautentikasi.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> Kolom praktis untuk Skills yang mendeklarasikan metadata.openclaw.primaryEnv. Mendukung string teks biasa atau SecretRef: { source: "env", provider: "default", id: "VAR_NAME" }.

Daftar izin agen (agents)

Gunakan konfigurasi agen ketika menginginkan root Skills mesin/ruang kerja yang sama tetapi kumpulan Skills yang terlihat berbeda untuk setiap agen.

{  agents: {    defaults: {      skills: ["github", "weather"], // baseline bersama    },    list: [      { id: "writer" }, // mewarisi github, weather      { id: "docs", skills: ["docs-search"] }, // menggantikan default sepenuhnya      { id: "locked-down", skills: [] }, // tanpa Skills    ],  },}

Workshop (skills.workshop)

Lihat Pembelajaran mandiri untuk kelayakan, privasi, biaya, izin khusus proposal, dan pemecahan masalah.

Lihat Skill Workshop untuk siklus hidup proposal, perintah CLI, parameter alat agen, dan metode Gateway yang dikendalikan konfigurasi ini.

Akar skill dengan symlink

Secara default, akar skill ruang kerja, agen proyek, direktori tambahan, dan bawaan merupakan batas penampungan. Folder skill dengan symlink di bawah <workspace>/skills yang mengarah ke luar akar akan dilewati dengan pesan log.

Untuk mengizinkan tata letak symlink yang disengaja, nyatakan target tepercaya:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Dengan konfigurasi ini, <workspace>/skills/manager -> ~/Projects/manager/skills diterima setelah resolusi realpath. extraDirs memindai repositori saudara secara langsung; allowSymlinkTargets mempertahankan jalur dengan symlink untuk tata letak yang sudah ada.

Penerapan Skill Workshop tidak menulis melalui symlink tersebut secara default. Untuk mengizinkan penerapan Workshop mengubah skill di bawah target symlink yang sudah dipercaya, aktifkan secara terpisah:

{  skills: {    load: {      allowSymlinkTargets: ["~/Projects/manager/skills"],    },    workshop: {      allowSymlinkTargetWrites: true,    },  },}

Direktori ~/.openclaw/skills terkelola dan ~/.agents/skills pribadi sudah menerima symlink direktori skill tanpa syarat (penampungan SKILL.md per skill tetap berlaku) — allowSymlinkTargets hanya diperlukan untuk akar ruang kerja, direktori tambahan, dan agen proyek (<workspace>/.agents/skills).

Skill dalam sandbox dan variabel lingkungan

Teruskan rahasia ke sandbox Docker dengan:

{  agents: {    defaults: {      sandbox: {        docker: {          env: { GEMINI_API_KEY: "your-key-here" },        },      },    },  },}

Pengingat urutan pemuatan

workspace/skills      (tertinggi)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsskill bawaanskills.load.extraDirs (terendah)

Perubahan pada skill dan konfigurasi berlaku pada sesi baru berikutnya saat pemantau diaktifkan, atau pada giliran agen berikutnya saat pemantau mendeteksi perubahan.

Terkait