Skills yapılandırması

Skills yapılandırmasının büyük bölümü ~/.openclaw/openclaw.json içinde skills altında bulunur. Aracıya özgü görünürlük agents.defaults.skills ve agents.list[].skills altında bulunur.

{  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: "pending",      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 },    },  },}

Yükleme (skills.load)

Kurulum (skills.install)

Operatör Kurulum İlkesi (security.installPolicy)

Operatörlerin skill ve Plugin kurulumlarını ana makineye özgü ilkeyle onaylamak veya engellemek için güvenilir bir yerel komuta ihtiyacı olduğunda security.installPolicy kullanın. İlke, OpenClaw kaynak materyali hazırladıktan sonra ve kurulum veya güncelleme devam etmeden önce çalışır. ClawHub skills, yüklenen skills, Git/yerel skills, skill bağımlılık kurucuları ve Plugin kurulum/güncelleme kaynakları için geçerlidir.

{  security: {    installPolicy: {      enabled: true,      // Omit targets to cover every supported target.      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"],      },    },  },}

İlke stdin üzerinde protocolVersion: 1, openclawVersion, targetType, targetName, sourcePath, sourcePathKind, isteğe bağlı yapılandırılmış source, yapılandırılmış origin ve request içeren bir JSON nesnesi alır. stdout üzerinde tek bir JSON nesnesi yazmalıdır: { "protocolVersion": 1, "decision": "allow" } veya { "protocolVersion": 1, "decision": "block", "reason": "..." }. Sıfır olmayan çıkış, zaman aşımı, hatalı biçimlendirilmiş JSON, eksik alanlar veya desteklenmeyen protokol sürümleri kapalı başarısız olur.

OpenClaw, normal Gateway başlatma sırasında kurulum ilkesini çalıştırmaz. İlke etkin ancak kullanılamaz olduğunda kurulumlar ve güncellemeler kapalı başarısız olur. openclaw doctor statik doğrulama yapar ve openclaw doctor --deep yapılandırılmış komuta karşı yapay bir kurulum sondası yürütür.

Toplu güncellemeler ilkeyi hedef başına uygular: engellenen bir skill veya Plugin güncellemesi, ilkeyi devre dışı bırakmadan ya da gruptaki sonraki hedefleri atlamadan o hedef için başarısız olur.

Örnek 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"  }}

Asgari ilke komutu:

#!/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: "local plugin paths are not approved on this host",      }),    );    return;  }  process.stdout.write(JSON.stringify({ protocolVersion: 1, decision: "allow" }));});

Paketle gelen skill izin listesi

Skill başına girdiler (skills.entries)

entries altındaki anahtarlar varsayılan olarak skill name değeriyle eşleşir. Bir skill metadata.openclaw.skillKey tanımlıyorsa onun yerine bu anahtarı kullanın. Tireli adları tırnak içine alın (JSON5 tırnaklı anahtarlara izin verir).

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .enabled" type="boolean"> false, paketle gelmiş veya kurulmuş olsa bile skill'i devre dışı bırakır. Paketle gelen coding-agent skill'i isteğe bağlıdır — bunu true olarak ayarlayın ve claude, codex, opencode veya desteklenen başka bir CLI'ın kurulu ve kimliği doğrulanmış olduğundan emin olun.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InNraWxscy5lbnRyaWVzLjxrZXk .apiKey" type='string | { source, provider, id }'> metadata.openclaw.primaryEnv bildiren skills için kolaylık alanı. Düz metin dizesini veya bir SecretRef'i destekler: { source: "env", provider: "default", id: "VAR_NAME" }.

Aracı izin listeleri (agents)

Aynı makine/çalışma alanı skill köklerini ancak aracı başına farklı bir görünür skill kümesini istediğinizde aracı yapılandırmasını kullanın.

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

Workshop (skills.workshop)

Sembolik bağlantılı skill kökleri

Varsayılan olarak çalışma alanı, proje ajanı, ek dizin ve paketlenmiş skill kökleri kapsama sınırlarıdır. <workspace>/skills altında kökün dışına çözümlenen sembolik bağlantılı bir skill klasörü, bir günlük iletisiyle atlanır.

Bilinçli bir sembolik bağlantı düzenine izin vermek için güvenilen hedefi bildirin:

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

Bu yapılandırmayla, <workspace>/skills/manager -> ~/Projects/manager/skills realpath çözümlemesinden sonra kabul edilir. extraDirs kardeş depoyu doğrudan tarar; allowSymlinkTargets mevcut düzenler için sembolik bağlantılı yolu korur.

Skill Workshop apply varsayılan olarak bu sembolik bağlantılar üzerinden yazmaz. Workshop apply işleminin zaten güvenilen sembolik bağlantı hedefleri altındaki skills öğelerini değiştirmesine izin vermek için ayrıca etkinleştirin:

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

Yönetilen ~/.openclaw/skills ve kişisel ~/.agents/skills dizinleri zaten skill dizini sembolik bağlantılarını kabul eder (skill başına SKILL.md kapsaması yine de geçerlidir).

Korumalı alana alınmış skills ve env vars

Gizli değerleri bir Docker korumalı alanına şu şekilde geçirin:

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

Yükleme sırası hatırlatıcısı

workspace/skills      (highest)workspace/.agents/skills~/.agents/skills~/.openclaw/skillsbundled skillsskills.load.extraDirs (lowest)

Skills ve yapılandırma değişiklikleri, izleyici etkinleştirildiğinde bir sonraki yeni oturumda veya izleyici bir değişiklik algıladığında bir sonraki ajan turunda etkili olur.

İlgili