Skills

• Tüm skill'lerin varsayılan olarak kısıtlanmadan kalması için agents.defaults.skills alanını belirtmeyin.
• agents.defaults.skills değerini devralmak için agents.list[].skills alanını belirtmeyin.
• İlgili ajana hiçbir skill göstermemek için agents.list[].skills: [] ayarlayın.
• Boş olmayan bir agents.list[].skills listesi nihai kümedir; varsayılanlarla birleştirilmez.
• Etkin izin listesi; istem oluşturma, eğik çizgi komutlarını keşfetme, sandbox eşitlemesi ve skill anlık görüntülerinin tamamında uygulanır.
• Bu, ana makine kabuğu için bir yetkilendirme sınırı değildir. Aynı ajan exec kullanabiliyorsa bu kabuğu ayrıca sandbox, işletim sistemi kullanıcısı yalıtımı, exec engelleme/izin listeleri ve kaynak başına kimlik bilgileriyle kısıtlayın.

openclaw skills install, varsayılan olarak etkin çalışma alanının skills/ dizinine yükleme yapar. Tüm yerel ajanların görebildiği paylaşılan ~/.openclaw/skills dizinine yüklemek için --global ekleyin; ajan izin listeleri bunu daraltabilir.

Git ve yerel yüklemeler, kaynak kökünde SKILL.md bulunmasını bekler. Geçerliyse kısa ad SKILL.md frontmatter içindeki name değerinden alınır; aksi hâlde dizin veya depo adı kullanılır. Geçersiz kılmak için --as <slug> kullanın. openclaw skills update yalnızca ClawHub yüklemelerini izler; Git veya yerel kaynakları yenilemek için yeniden yükleyin.

openclaw skills verify @owner/<slug>, ClawHub'dan skill'in clawhub.skill.verify.v1 güven sınırını ister. Yüklü ClawHub skill'leri, .clawhub/origin.json içinde kaydedilen sürüm ve kayıt defterine göre doğrulanır. Mevcut yüklü veya anlamı açık skill'ler için sahip belirtilmeyen kısa adlar kabul edilmeye devam eder; ancak sahip nitelemeli referanslar yayıncı belirsizliğini önler.

ClawHub skill sayfaları, yükleme öncesinde en son güvenlik taraması durumunu ve VirusTotal, ClawScan ile statik analiz ayrıntı sayfalarını gösterir. ClawHub doğrulamayı başarısız olarak işaretlediğinde komut sıfırdan farklı bir kodla çıkar. Yayıncılar yanlış pozitifleri ClawHub panosu veya clawhub skill rescan @owner/<slug> aracılığıyla giderebilir.

ClawHub dışı dağıtıma ihtiyaç duyan Gateway istemcileri, skills.upload.begin, skills.upload.chunk ve skills.upload.commit ile bir zip skill arşivini hazırlayıp ardından skills.install({ source: "upload", ... }) ile yükleyebilir. Bu yol varsayılan olarak kapalıdır ve openclaw.json içinde skills.install.allowUploadedArchives: true ayarını gerektirir. Normal ClawHub yüklemelerinde bu ayara hiçbir zaman gerek yoktur.

Çalışma alanı, proje ajanı ve ek dizin skill keşfi, skills.load.allowSymlinkTargets bir hedef köke açıkça güvenmediği sürece yalnızca çözümlenmiş gerçek yolu yapılandırılmış kökün içinde kalan skill köklerini kabul eder. Skill Atölyesi, bu güvenilen hedefler üzerinden yalnızca skills.workshop.allowSymlinkTargetWrites etkinleştirildiğinde yazar. Yönetilen ~/.openclaw/skills ve kişisel ~/.agents/skills, sembolik bağlantılı skill klasörleri içerebilir; ancak her SKILL.md gerçek yolu yine de çözümlenmiş skill dizininin içinde kalmalıdır.

Skill yüklemeleri devam etmeden önce güvenilen bir yerel politika komutu çalıştırmak için security.installPolicy yapılandırın. Politika, meta verileri ve hazırlanmış kaynak yolunu alır; ClawHub, karşıya yüklenen, Git, yerel, güncelleme ve bağımlılık yükleyici yollarına uygulanır ve komut geçerli bir karar döndüremezse güvenli biçimde işlemi reddeder.

skills.entries.*.env ve skills.entries.*.apiKey, gizli bilgileri yalnızca ilgili ajan dönüşü için ana makine işlemine ekler; sandbox içine eklemez. Gizli bilgileri istemlerden ve günlüklerden uzak tutun.

• Birden fazla yükleyici listelendiğinde Gateway tercih edilen bir seçeneği seçer (kullanılabiliyorsa brew, aksi takdirde node).
• Tüm yükleyiciler download ise OpenClaw, kullanılabilir tüm yapıtları görebilmeniz için her girdiyi listeler.
• Tanımlar, platforma göre filtreleme yapmak için os: ["darwin"|"linux"|"win32"] içerebilir.
• Node yüklemeleri, openclaw.json içindeki skills.install.nodeManager ayarını dikkate alır (varsayılan: npm; seçenekler: npm / pnpm / yarn / bun). Bu yalnızca Skills yüklemelerini etkiler; Gateway çalışma zamanı yine Node olmalıdır.
• Gateway yükleyici tercihi: Homebrew → uv → yapılandırılmış node yöneticisi → go → download.

• Homebrew: OpenClaw, Homebrew'ü otomatik olarak yüklemez veya brew formüllerini sistem paketi komutlarına dönüştürmez. brew bulunmayan Linux kapsayıcılarında yalnızca brew kullanan yükleyiciler gizlenir; özel bir imaj kullanın veya bağımlılığı elle yükleyin.
• Go: OpenClaw, otomatik Skills yüklemeleri için Go 1.21 veya daha yeni bir sürüm gerektirir. go eksikse ve Homebrew kullanılabiliyorsa OpenClaw önce Homebrew aracılığıyla Go'yu yükler; Homebrew bulunmayan Linux'ta ise yenilenmiş golang-go adayı asgari sürümü karşılıyorsa bunun yerine root olarak veya parolasız sudo üzerinden apt-get kullanabilir. Bağımlılık için gerçek go install, yapılandırılmış GOBIN yerine her zaman OpenClaw tarafından yönetilen özel bir ikili dosya dizinini (yeni bir yüklemede Homebrew'ün bin dizini, aksi takdirde ~/.local/bin) hedefler — kendi GOBIN, GOPATH ve GOTOOLCHAIN ortam değişkenleriniz okunur ancak asla üzerlerine yazılmaz.
• İndirme: url (zorunlu), archive (tar.gz | tar.bz2 | zip), extract (varsayılan: arşiv algılandığında otomatik), stripComponents, targetDir (varsayılan: ~/.openclaw/tools/<skillKey>).

requires.bins, Skills yükleme sırasında ana makinede denetlenir. Bir ajan korumalı alanda çalışıyorsa ikili dosyanın kapsayıcının içinde de bulunması gerekir. Dosyayı agents.defaults.sandbox.docker.setupCommand veya özel bir imaj aracılığıyla yükleyin. setupCommand, kapsayıcı oluşturulduktan sonra bir kez çalışır ve korumalı alanda ağ çıkışı, yazılabilir bir kök dosya sistemi ve root kullanıcı gerektirir.

OpenClaw varsayılan olarak Skills klasörlerini izler ve SKILL.md dosyaları değiştiğinde anlık görüntü sürümünü artırır. skills.load altında yapılandırın:

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // default      watchDebounceMs: 250, // default    },  },}

Skills kökü sembolik bağlantısının yapılandırılmış kökün dışına işaret ettiği kasıtlı sembolik bağlantı düzenlerinde allowSymlinkTargets kullanın; örneğin <workspace>/skills/manager -> ~/Projects/manager/skills. skills.workshop.allowSymlinkTargetWrites ayarını yalnızca Skill Workshop'un bu güvenilir sembolik bağlantılı yollar üzerinden önerileri de uygulaması gerektiğinde etkinleştirin.

Gateway Linux'ta çalışıyor ancak system.run izni bulunan bir macOS node bağlıysa OpenClaw, gerekli ikili dosyalar bu node üzerinde bulunduğunda yalnızca macOS'a özgü Skills öğelerini uygun kabul edebilir. Ajan bu Skills öğelerini host=node ile exec aracını kullanarak çalıştırmalıdır.

Çevrimdışı node'lar yalnızca uzakta kullanılabilen Skills öğelerini görünür kılmaz. Bir node ikili dosya yoklamalarına yanıt vermeyi bırakırsa OpenClaw, önbelleğe alınmış ikili dosya eşleşmelerini temizler.