Konfigurasi Skills

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

{
  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills", "~/Projects/oss/some-skill-pack/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
      watch: true,
      watchDebounceMs: 250,
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun (Gateway runtime still Node; bun not recommended)
      allowUploadedArchives: false,
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• Penyiapan native bergaya Nano Banana Pro: agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"
• Penyiapan native fal: agents.defaults.imageGenerationModel.primary: "fal/fal-ai/flux/dev"

​

Daftar izin skill agen

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

• agents.defaults.skills: daftar izin dasar bersama untuk agen yang menghilangkan agents.list[].skills.
• Hilangkan agents.defaults.skills agar skills tidak dibatasi secara default.
• agents.list[].skills: kumpulan skill final eksplisit untuk agen tersebut; ini tidak digabungkan dengan default.
• agents.list[].skills: []: jangan tampilkan skill apa pun untuk agen tersebut.

​

Bidang

• Root skill bawaan selalu mencakup ~/.openclaw/skills, ~/.agents/skills, <workspace>/.agents/skills, dan <workspace>/skills.
• allowBundled: daftar izin opsional hanya untuk skills terbundel. Jika disetel, hanya skills terbundel dalam daftar yang memenuhi syarat (skills terkelola, agen, dan workspace tidak terpengaruh).
• load.extraDirs: direktori skill tambahan untuk dipindai (presedensi terendah).
• load.allowSymlinkTargets: direktori target nyata tepercaya yang dapat menjadi hasil resolve folder skill bersymlink meskipun symlink berada di luar root target tersebut. Gunakan ini untuk tata letak sibling-repo yang disengaja seperti ~/.agents/skills/manager -> ~/Projects/manager/skills.
• load.watch: awasi folder skill dan segarkan snapshot skills (default: true).
• load.watchDebounceMs: debounce untuk peristiwa pengawas skill dalam milidetik (default: 250).
• install.preferBrew: utamakan penginstal brew jika tersedia (default: true).
• install.nodeManager: preferensi penginstal node (npm | pnpm | yarn | bun, default: npm). Ini hanya memengaruhi instalasi skill; runtime Gateway tetap harus berupa Node (Bun tidak disarankan untuk WhatsApp/Telegram).
  • openclaw setup --node-manager lebih sempit dan saat ini menerima npm, pnpm, atau bun. Setel skills.install.nodeManager: "yarn" secara manual jika Anda menginginkan instalasi skill berbasis Yarn.
• install.allowUploadedArchives: izinkan klien Gateway operator.admin tepercaya menginstal arsip zip privat yang disiapkan melalui skills.upload.* (default: false). Ini hanya mengaktifkan jalur arsip unggahan; instalasi ClawHub normal tidak memerlukannya.
• entries.<skillKey>: override per skill.
• agents.defaults.skills: daftar izin skill default opsional yang diwarisi oleh agen yang menghilangkan agents.list[].skills.
• agents.list[].skills: daftar izin skill final opsional per agen; daftar eksplisit menggantikan default yang diwarisi alih-alih menggabungkannya.

​

Repo saudara bersymlink

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

• enabled: setel false untuk menonaktifkan skill meskipun skill itu terbundel/terinstal.
• env: variabel lingkungan yang disuntikkan untuk run agen (hanya jika belum disetel).
• apiKey: kemudahan opsional untuk skills yang mendeklarasikan env var utama. Mendukung string teks biasa atau objek SecretRef ({ source, provider, id }).

​

Catatan

• Key di bawah entries dipetakan ke nama skill secara default. Jika sebuah skill mendefinisikan metadata.openclaw.skillKey, gunakan key tersebut sebagai gantinya.
• Presedensi pemuatan adalah <workspace>/skills → <workspace>/.agents/skills → ~/.agents/skills → ~/.openclaw/skills → skills terbundel → skills.load.extraDirs.
• Perubahan pada skills diambil pada giliran agen berikutnya saat pengawas diaktifkan.

​

Skills sandbox dan env var

• agents.defaults.sandbox.docker.env untuk backend Docker (atau per agen agents.list[].sandbox.docker.env).
• Bake env ke dalam image sandbox kustom atau lingkungan sandbox remote Anda.

​

Terkait