~/.openclaw/openclaw.json içindeki
skills altında bulunur. Agent’a özgü görünürlük
agents.defaults.skills ve agents.entries.*.skills altında bulunur.
Yerleşik görüntü üretimi için
skills.entries yerine agents.defaults.mediaModels.image
ile temel image_generate aracını kullanın. Skills
girdileri yalnızca özel veya üçüncü taraf Skills iş akışları içindir.Yükleme (skills.load)
string[]
En düşük öncelikle (paketle gelen ve Plugin Skills öğelerinin altında)
taranacak ek Skills dizinleri. Yollar,
~ desteğiyle genişletilir.string[]
Sembolik bağlantılı Skills klasörlerinin, sembolik bağlantı yapılandırılmış
kökün dışında olsa bile çözümleyebileceği güvenilir gerçek hedef dizinler.
Bunu
<workspace>/skills/manager -> ~/Projects/manager/skills gibi bilinçli kardeş depo düzenleri için
kullanın. Bu listeyi dar tutun — ~ veya ~/Projects gibi
geniş kökleri göstermeyin.boolean
varsayılan:"true"
Skills klasörlerini izler ve
SKILL.md dosyaları değiştiğinde
Skills anlık görüntüsünü yeniler. Gruplandırılmış Skills köklerinin altındaki
iç içe dosyaları kapsar.Kurulum (skills.install)
boolean
varsayılan:"true"
brew kullanılabiliyorsa Homebrew yükleyicilerini tercih eder."npm" | "pnpm" | "yarn" | "bun"
varsayılan:"\"npm\""
Skills kurulumları için Node paket yöneticisi tercihi. Bu yalnızca Skills
kurulumlarını etkiler; standart durum deposu
node:sqlite kullandığından
OpenClaw CLI ve Gateway çalışma zamanı Node gerektirir. openclaw setup --node-manager ve
openclaw onboard --node-manager; npm, pnpm veya bun değerlerini
kabul eder. Yarn destekli Skills kurulumları için yapılandırmada
doğrudan "yarn" değerini ayarlayın.boolean
varsayılan:"false"
Güvenilir
operator.admin Gateway istemcilerinin skills.upload.* üzerinden
hazırlanan özel zip arşivlerini kurmasına izin verir. Normal ClawHub
kurulumları bu ayara ihtiyaç duymaz.Operatör Kurulum İlkesi (security.installPolicy)
Operatörlerin, Skills ve Plugin kurulumlarını ana makineye özgü bir ilkeyle
onaylamak veya engellemek için güvenilir bir yerel komuta ihtiyaç duyduğu
durumlarda security.installPolicy kullanın. İlke, OpenClaw kaynak materyali
hazırladıktan sonra ve kurulum ya da güncelleme devam etmeden önce çalışır.
ClawHub Skills öğeleri, yüklenen Skills öğeleri, Git/yerel Skills öğeleri,
Skills bağımlılık yükleyicileri ve Plugin kurulum/güncelleme kaynakları için
geçerlidir.
boolean
varsayılan:"false"
Operatöre ait kurulum ilkesini etkinleştirir. Geçerli bir
exec
komutu olmadan etkinleştirildiğinde kurulumlar güvenli biçimde başarısız olur.("skill" | "plugin")[]
İsteğe bağlı hedef filtresi. Atlandığında ilke, yeni kurulumların beklenmedik
şekilde açık kalmaması için desteklenen her hedefe uygulanır.
string
Güvenilir ilke yürütülebilir dosyasının mutlak yolu. OpenClaw bunu kabuk
kullanmadan çalıştırır ve kullanmadan önce yolu doğrular.
string[]
command sonrasında aktarılan statik bağımsız değişkenler.number
varsayılan:"10000"
Tek bir ilke kararı için azami gerçek zaman çalışma süresi.
number
varsayılan:"timeoutMs"
İlkenin güvenli biçimde başarısız olmasından önce stdout veya stderr çıktısı
olmadan geçebilecek azami süre.
number
varsayılan:"1048576"
İlke işleminden kabul edilen stdout ve stderr çıktılarının toplam azami bayt
sayısı.
Record<string, string>
İlke işlemine sağlanan sabit ortam değişkenleri.
string[]
OpenClaw işleminden ilke işlemine kopyalanan ortam değişkeni adları. Yalnızca
adı belirtilen değişkenler aktarılır.
string[]
İlke yürütülebilir dosyasını içerebilecek dizinlerin isteğe bağlı izin listesi.
boolean
varsayılan:"false"
Komut yolu sahipliği ve izin denetimlerini atlar. Yalnızca yol başka bir
mekanizmayla korunuyorsa kullanın.
boolean
varsayılan:"false"
Yapılandırılmış komut yolunun sembolik bağlantı olmasına izin verir.
Çözümlenen hedef yine de diğer yol denetimlerini karşılamalıdır. Yorumlayıcı
betik bağımsız değişkenleri sembolik bağlantı değil, doğrudan normal dosyalar
olmalıdır.
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 üzerine 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 güvenli biçimde başarısız olur.
OpenClaw, normal Gateway başlatma sırasında kurulum ilkesini yürütmez.
İlke etkin ancak kullanılamaz olduğunda kurulumlar ve güncellemeler güvenli
biçimde başarısız olur. openclaw doctor statik doğrulama gerçekleştirir;
openclaw doctor --deep ise yapılandırılmış komuta karşı yapay bir kurulum sınaması
yürütür.
Toplu güncellemeler ilkeyi hedef başına uygular: engellenmiş bir Skills veya
Plugin güncellemesi, ilkeyi devre dışı bırakmadan ya da gruptaki sonraki
hedefleri atlamadan ilgili hedef için başarısız olur.
Örnek stdin:
Paketle gelen Skills izin listesi
string[]
Yalnızca paketle gelen Skills öğeleri için isteğe bağlı izin listesi.
Ayarlandığında yalnızca listedeki paketle gelen Skills öğeleri uygun olur.
Yönetilen, Agent düzeyindeki ve çalışma alanındaki Skills öğeleri etkilenmez.
Skills başına girdiler (skills.entries)
entries altındaki anahtarlar varsayılan olarak Skills
name değeriyle eşleşir. Bir Skills öğesi metadata.openclaw.skillKey
tanımlıyorsa bunun yerine o anahtarı kullanın. Kısa çizgili adları tırnak içine
alın (JSON5, tırnaklı anahtarlara izin verir).
boolean
false, paketle gelmiş veya kurulmuş olsa bile Skills öğesini devre
dışı bırakır. Paketle gelen coding-agent Skills öğesi 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.string | { source, provider, id }
metadata.openclaw.primaryEnv bildiren Skills öğeleri için kolaylık alanı.
Düz metin dizesini veya SecretRef değerini destekler: { source: "env", provider: "default", id: "VAR_NAME" }.Record<string, string>
Agent çalıştırması için eklenen ortam değişkenleri. Yalnızca değişken işlemde
zaten ayarlanmamışsa eklenir.
object
Skills öğesine özgü özel yapılandırma alanları için isteğe bağlı bir alan.
Agent izin listeleri (agents)
Aynı makine/çalışma alanı Skills köklerini, ancak Agent başına farklı bir
görünür Skills kümesini istediğinizde Agent yapılandırmasını kullanın.
string[]
agents.entries.*.skills alanını atlayan Agent’ların devraldığı paylaşılan temel
izin listesi. Skills öğelerini varsayılan olarak kısıtlamamak için bu alanı
tamamen atlayın.string[]
İlgili Agent için açıkça belirtilmiş nihai Skills kümesi. Açık listeler,
devralınan varsayılanların yerini alır — bunlarla birleştirilmez.
İlgili Agent’a hiçbir Skills öğesi sunmamak için
[] olarak
ayarlayın.Workshop (skills.workshop)
boolean
varsayılan:"false"
true olduğunda OpenClaw, kalıcı düzeltmelerden bekleyen öneriler oluşturabilir
ve sistem boştayken başarıyla tamamlanmış önemli çalışmaları inceleyebilir.
Bu, uygun dönüşlerden sonra arka planda bir model çalıştırması ekleyebilir. Kullanıcı tarafından
istenen skill oluşturma ve /learn, ayar false olduğunda çalışmaya devam eder."pending" | "auto"
varsayılan:"\"auto\""
auto, ek bir onay istemi olmadan agent tarafından başlatılan uygulama,
reddetme veya karantinaya alma işlemlerine izin verir. pending operatör onayı gerektirir.boolean
varsayılan:"false"
Skill Workshop uygulamasının, gerçek hedefi
skills.load.allowSymlinkTargets tarafından zaten
güvenilir kabul edilen çalışma alanı skill sembolik bağlantıları üzerinden yazmasına izin verir.
Oluşturulan önerilerin uygulanması bu paylaşılan skill kökünü değiştirmeyecekse
bu ayarı devre dışı tutun.number
varsayılan:"50"
Çalışma alanı başına saklanan bekleyen ve karantinaya alınmış önerilerin
azami sayısı (izin verilen aralık: 1-200).
number
varsayılan:"40000"
Bayt cinsinden azami öneri gövdesi boyutu (izin verilen aralık: 1024-200000).
Öneri açıklamaları, keşif ve listeleme çıktısında göründükleri için ayrıca
kesin olarak 160 baytla sınırlandırılır.
Sembolik bağlantılı skill kökleri
Varsayılan olarak çalışma alanı, proje agent’ı, ek dizin ve paketlenmiş skill 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 skill klasörü, bir günlük mesajıyla atlanır.
Kasıtlı bir sembolik bağlantı düzenine izin vermek için güvenilir hedefi bildirin:
<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 uygulaması varsayılan olarak bu sembolik bağlantılar üzerinden
yazmaz. Workshop uygulamasının, zaten güvenilir olan sembolik bağlantı
hedefleri altındaki skill’leri değiştirmesine izin vermek için ayrıca etkinleştirin:
~/.openclaw/skills ve kişisel ~/.agents/skills dizinleri, skill
dizini sembolik bağlantılarını zaten koşulsuz olarak kabul eder (skill başına
SKILL.md kapsam denetimi yine uygulanır) — allowSymlinkTargets yalnızca
çalışma alanı, ek dizin ve proje agent’ı (<workspace>/.agents/skills) kökleri için gereklidir.
Korumalı alandaki skill’ler ve ortam değişkenleri
Gizli bilgileri bir Docker korumalı alanına şu şekilde aktarın:Docker daemon erişimi olan kullanıcılar,
sandbox.docker.env değerlerini
Docker meta verileri üzerinden inceleyebilir. Bu ifşa kabul edilebilir değilse
bağlanmış bir gizli bilgi dosyası, özel bir imaj veya başka bir aktarım yolu kullanın.Yükleme sırası hatırlatması
İlgili konular
Skills referansı
Skill’lerin ne olduğu, yükleme sırası, geçit denetimi ve SKILL.md biçimi.
Skill oluşturma
Özel çalışma alanı skill’leri yazma.
Skill Workshop
Agent tarafından taslak hâline getirilen skill’ler için öneri kuyruğu.
Kendi kendine öğrenme
Tamamlanan çalışmalardan oluşturulan temkinli ve isteğe bağlı öneriler.
Eğik çizgi komutları
Yerel eğik çizgi komutları kataloğu ve sohbet yönergeleri.