Skills yapılandırması

Skills yapılandırmasının büyük bölümü ~/.openclaw/openclaw.json içindeki skills altında bulunur. Ajana ö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 Politikası (security.installPolicy)

Operatörlerin Skill ve Plugin kurulumlarını ana makineye özgü politikayla onaylamak veya engellemek için güvenilir bir yerel komuta ihtiyaç duyduğu durumlarda security.installPolicy kullanın. Politika, OpenClaw kaynak materyalini hazırladıktan sonra ve kurulum ya da 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"],      },    },  },}

Politika, stdin üzerinden 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 tek bir JSON nesnesi alır. stdout'a tek bir JSON nesnesi yazmalıdır: { "protocolVersion": 1, "decision": "allow" } veya { "protocolVersion": 1, "decision": "block", "reason": "..." }. Sıfır olmayan çıkış kodu, zaman aşımı, hatalı biçimlendirilmiş JSON, eksik alanlar veya desteklenmeyen protokol sürümleri güvenli biçimde reddedilir.

OpenClaw, normal Gateway başlatma sırasında kurulum politikasını yürütmez. Politika etkin ancak kullanılamaz olduğunda kurulumlar ve güncellemeler güvenli biçimde reddedilir. openclaw doctor statik doğrulama gerçekleştirir; openclaw doctor --deep, yapılandırılmış komuta karşı yapay bir kurulum sondası yürütür.

Toplu güncellemeler politikayı hedef başına uygular: engellenen bir Skill veya Plugin güncellemesi, politikayı devre dışı bırakmadan veya gruptaki sonraki hedefleri atlamadan ilgili 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 politika 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 Skills 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 bunun yerine o anahtarı kullanın. Kısa çizgi içeren 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 ya da 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" }.

Ajan izin listeleri (agents)

Aynı makine/çalışma alanı Skill köklerini ancak ajan başına farklı görünür Skill kümesini istediğinizde ajan 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)

Bu yapılandırmanın denetlediği öneri yaşam döngüsü, CLI komutları, aracı araç parametreleri ve Gateway yöntemleri için Skill Workshop sayfasına bakın.

Sembolik bağlantılı Skills kökleri

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

Kasıtlı bir sembolik bağlantı düzenine izin vermek için güvenilir hedefi bildirin:

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

Bu yapılandırmayla <workspace>/skills/manager -> ~/Projects/manager/skills, gerçek yol çö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 uygulaması varsayılan olarak bu sembolik bağlantılar üzerinden yazmaz. Workshop uygulamasının zaten güvenilir kabul edilen sembolik bağlantı hedefleri altındaki Skills'i 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, Skills dizini sembolik bağlantılarını zaten koşulsuz olarak kabul eder (Skills başına SKILL.md kapsaması yine geçerlidir) — allowSymlinkTargets yalnızca çalışma alanı, ek dizin ve proje aracısı (<workspace>/.agents/skills) kökleri için gereklidir.

Korumalı alandaki Skills ve ortam değişkenleri

Gizli bilgileri bir Docker korumalı alanına şu şekilde aktarın:

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

Yükleme sırası hatırlatması

workspace/skills      (en yüksek)workspace/.agents/skills~/.agents/skills~/.openclaw/skillspaketle gelen Skillsskills.load.extraDirs (en düşük)

İzleyici etkinleştirildiğinde Skills ve yapılandırma değişiklikleri bir sonraki yeni oturumda ya da izleyici bir değişiklik algıladığında bir sonraki aracı turunda geçerli olur.

İlgili