OpenClaw, ajana araçları nasıl kullanacağını öğretmek için AgentSkills uyumlu beceri klasörleri kullanır. Her beceri, YAML frontmatter ve talimatlar içeren birDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md dosyasına sahip bir dizindir. OpenClaw, paketle gelen becerileri ve isteğe bağlı
yerel geçersiz kılmaları yükler ve bunları yükleme zamanında ortama, yapılandırmaya ve
ikili dosya varlığına göre filtreler.
Konumlar ve öncelik
OpenClaw becerileri şu kaynaklardan yükler, en yüksek öncelik önce:| # | Kaynak | Yol |
|---|---|---|
| 1 | Çalışma alanı becerileri | <workspace>/skills |
| 2 | Proje ajan becerileri | <workspace>/.agents/skills |
| 3 | Kişisel ajan becerileri | ~/.agents/skills |
| 4 | Yönetilen/yerel beceriler | ~/.openclaw/skills |
| 5 | Paketle gelen beceriler | kurulumla birlikte gelir |
| 6 | Ek beceri klasörleri | skills.load.extraDirs (yapılandırma) |
$CODEX_HOME/skills dizini bu OpenClaw beceri köklerinden
biri değildir. Codex harness modunda, yerel uygulama sunucusu başlatmaları yalıtılmış
ajan başına Codex ana dizinleri kullanır, bu nedenle kişisel Codex CLI becerileri örtük olarak yüklenmez.
Bunların envanterini çıkarmak için openclaw migrate codex --dry-run komutunu ve
geçerli OpenClaw ajan çalışma alanına kopyalamadan önce etkileşimli
onay kutusu istemiyle beceri dizinlerini seçmek için openclaw migrate codex komutunu kullanın.
Etkileşimsiz çalıştırmalar için, kopyalanacak tam beceriler için --skill <name> seçeneğini tekrarlayın.
Ajan başına ve paylaşılan beceriler
Çok ajanlı kurulumlarda her ajanın kendi çalışma alanı vardır:| Kapsam | Yol | Görünür olduğu yer |
|---|---|---|
| Ajan başına | <workspace>/skills | Yalnızca o ajan |
| Proje ajanı | <workspace>/.agents/skills | Yalnızca o çalışma alanının ajanı |
| Kişisel ajan | ~/.agents/skills | O makinedeki tüm ajanlar |
| Paylaşılan yönetilen/yerel | ~/.openclaw/skills | O makinedeki tüm ajanlar |
| Paylaşılan ek dizinler | skills.load.extraDirs (en düşük öncelik) | O makinedeki tüm ajanlar |
Ajan beceri izin listeleri
Beceri konumu ve beceri görünürlüğü ayrı denetimlerdir. Konum/öncelik, aynı adlı bir becerinin hangi kopyasının kazanacağını belirler; ajan izin listeleri ise bir ajanın gerçekte hangi becerileri kullanabileceğini belirler.Allowlist rules
Allowlist rules
- Varsayılan olarak sınırsız beceriler için
agents.defaults.skillsöğesini atlayın. agents.defaults.skillsdeğerini devralmak içinagents.list[].skillsöğesini atlayın.- Beceri olmaması için
agents.list[].skills: []ayarlayın. - Boş olmayan bir
agents.list[].skillslistesi, o ajan için nihai kümedir - varsayılanlarla birleştirilmez. - Etkili izin listesi istem oluşturma, beceri eğik çizgi komutu keşfi, sandbox eşitlemesi ve beceri anlık görüntüleri genelinde uygulanır.
Plugin’ler ve beceriler
Plugin’ler,openclaw.plugin.json içinde skills dizinlerini listeleyerek
kendi becerilerini gönderebilir (yollar Plugin köküne görelidir). Plugin becerileri,
Plugin etkin olduğunda yüklenir. Bu, araç açıklaması için çok uzun olan ancak
Plugin kurulu olduğunda kullanılabilir olması gereken araca özel kullanım kılavuzları için
doğru yerdir - örneğin tarayıcı Plugin’i, çok adımlı tarayıcı denetimi için
bir browser-automation becerisi gönderir.
Plugin beceri dizinleri, skills.load.extraDirs ile aynı düşük öncelikli yolda
birleştirilir, bu nedenle aynı adlı paketle gelen, yönetilen, ajan veya
çalışma alanı becerisi bunları geçersiz kılar. Bunları Plugin’in yapılandırma girdisindeki
metadata.openclaw.requires.config üzerinden koşullandırabilirsiniz.
Keşif/yapılandırma için Plugin’ler ve bu becerilerin öğrettiği
araç yüzeyi için Araçlar bölümüne bakın.
Beceri Atölyesi
İsteğe bağlı, deneysel Beceri Atölyesi Plugin’i, ajan çalışması sırasında gözlemlenen yeniden kullanılabilir prosedürlerden çalışma alanı becerileri oluşturabilir veya güncelleyebilir. Varsayılan olarak devre dışıdır veplugins.entries.skill-workshop üzerinden
açıkça etkinleştirilmelidir.
Beceri Atölyesi yalnızca <workspace>/skills içine yazar, oluşturulan
içeriği tarar, bekleyen onayı veya otomatik güvenli yazmaları destekler, güvenli olmayan
önerileri karantinaya alır ve başarılı yazmalardan sonra beceri anlık görüntüsünü yeniler;
böylece yeni beceriler Gateway yeniden başlatması olmadan kullanılabilir hale gelir.
Bunu “bir dahaki sefere, GIF atfını doğrula” gibi düzeltmeler veya
medya QA kontrol listeleri gibi emekle edinilmiş iş akışları için kullanın. Bekleyen
onayla başlayın; otomatik yazmaları yalnızca önerilerini inceledikten sonra güvenilen
çalışma alanlarında kullanın. Tam kılavuz: Beceri Atölyesi Plugin’i.
ClawHub (kurulum ve eşitleme)
ClawHub, OpenClaw için herkese açık beceri kayıt defteridir. Keşfetme/kurma/güncelleme için yerelopenclaw skills komutlarını veya
yayınlama/eşitleme iş akışları için ayrı clawhub CLI’sini kullanın. Tam kılavuz:
ClawHub.
| Eylem | Komut |
|---|---|
| Çalışma alanına bir beceri kur | openclaw skills install <skill-slug> |
| Kurulu tüm becerileri güncelle | openclaw skills update --all |
| Eşitle (tara + güncellemeleri yayınla) | clawhub sync --all |
openclaw skills install, etkin çalışma alanındaki skills/ dizinine kurar.
Ayrı clawhub CLI de geçerli çalışma dizininizin altındaki ./skills içine kurar
(veya yapılandırılmış OpenClaw çalışma alanına geri döner). OpenClaw, sonraki oturumda
bunu <workspace>/skills olarak alır.
Yapılandırılmış beceri kökleri ayrıca skills/<group>/<skill>/SKILL.md gibi
tek bir gruplama düzeyini destekler; böylece ilgili üçüncü taraf beceriler,
geniş özyinelemeli tarama olmadan paylaşılan bir klasör altında tutulabilir.
Özel, ClawHub dışı teslimata ihtiyaç duyan Gateway istemcileri, skills.upload.begin,
skills.upload.chunk ve skills.upload.commit ile bir zip beceri arşivini hazırlayabilir,
ardından tamamlanan yüklemeyi skills.install({ source: "upload", uploadId, slug, force?, sha256? })
ile kurabilir. Bu, güvenilir istemciler için açık bir yönetici yükleme yoludur; normal
openclaw skills install <slug> veya ClawHub kurulum akışı değildir. Varsayılan olarak kapalıdır
ve yalnızca openclaw.json içinde skills.install.allowUploadedArchives: true ayarlandığında çalışır.
Yükleme modu yine de varsayılan ajan çalışma alanındaki skills/<slug> dizinine kurar;
arşivin iç klasör adı nihai kurulum hedefi için yok sayılır.
ClawHub beceri sayfaları, kurulumdan önce en son güvenlik taraması durumunu,
VirusTotal, ClawScan ve statik analiz için tarayıcı ayrıntı sayfalarıyla birlikte gösterir.
openclaw skills install <slug> yalnızca kurulum yolu olarak kalır; yayıncılar
yanlış pozitifleri ClawHub panosu veya clawhub skill rescan <slug> üzerinden giderir.
Güvenlik
- Çalışma alanı ve ek dizin beceri keşfi, yalnızca çözümlenen gerçek yolu yapılandırılmış kökün içinde kalan beceri köklerini ve
SKILL.mddosyalarını kabul eder. - Gateway özel arşiv kurulumları varsayılan olarak kapalıdır. Açıkça etkinleştirildiğinde,
SKILL.mdiçeren tamamlanmış bir zip yüklemesi gerektirir ve ClawHub beceri kurulumlarıyla aynı arşiv çıkarma, yol geçişi, sembolik bağlantı, zorlama ve geri alma korumalarını yeniden kullanır. Bunlarskills.install.allowUploadedArchivesile koşullandırılır; normal ClawHub kurulumları bu ayarı gerektirmez. - Gateway destekli beceri bağımlılığı kurulumları (
skills.install, onboarding ve Skills ayarları kullanıcı arayüzü), kurulum aracı metadata’sını yürütmeden önce yerleşik tehlikeli kod tarayıcısını çalıştırır.criticalbulguları, çağıran açıkça tehlikeli geçersiz kılmayı ayarlamadıkça varsayılan olarak engeller; şüpheli bulgular yine yalnızca uyarır. openclaw skills install <slug>farklıdır - bir ClawHub beceri klasörünü çalışma alanına indirir ve yukarıdaki kurulum aracı metadata yolunu kullanmaz.skills.entries.*.envveskills.entries.*.apiKey, o ajan dönüşü için gizli bilgileri ana makine sürecine enjekte eder (sandbox’a değil). Gizli bilgileri istemlerden ve günlüklerden uzak tutun.
SKILL.md biçimi
SKILL.md en az şunları içermelidir:
metadata bir tek satırlı JSON nesnesi olmalıdır. Talimatlarda beceri klasörü yoluna
başvurmak için {baseDir} kullanın.
İsteğe bağlı frontmatter anahtarları
macOS Skills kullanıcı arayüzünde “Web Sitesi” olarak gösterilen URL.
metadata.openclaw.homepage üzerinden de desteklenir.true olduğunda beceri, kullanıcı eğik çizgi komutu olarak gösterilir.true olduğunda OpenClaw, becerinin talimatlarını ajanın normal isteminin dışında tutar.
Beceri yine kurulu kalır ve user-invocable da true olduğunda açıkça
eğik çizgi komutu olarak çalıştırılabilir.tool olarak ayarlandığında eğik çizgi komutu modeli atlar ve doğrudan bir araca gönderilir.command-dispatch: tool ayarlandığında çağrılacak araç adı.Araç gönderimi için ham argümanlar dizesini araca iletir (çekirdek ayrıştırma yok). Araç
{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" } ile çağrılır.Koşullandırma (yükleme zamanı filtreleri)
OpenClaw,metadata (tek satırlı JSON) kullanarak becerileri yükleme zamanında filtreler:
metadata.openclaw altındaki alanlar:
true olduğunda, beceriyi her zaman dahil et (diğer kapıları atla).macOS Skills kullanıcı arayüzü tarafından kullanılan isteğe bağlı emoji.
macOS Skills kullanıcı arayüzünde “Web sitesi” olarak gösterilen isteğe bağlı URL.
İsteğe bağlı platform listesi. Ayarlanırsa, beceri yalnızca bu işletim sistemlerinde uygun olur.
Her biri
PATH üzerinde mevcut olmalıdır.En az biri
PATH üzerinde mevcut olmalıdır.Ortam değişkeni mevcut olmalı veya yapılandırmada sağlanmalıdır.
Truthy olması gereken
openclaw.json yollarının listesi.skills.entries.<name>.apiKey ile ilişkilendirilmiş ortam değişkeni adı.macOS Skills kullanıcı arayüzü tarafından kullanılan isteğe bağlı yükleyici belirtimleri (brew/node/go/uv/download).
metadata.openclaw yoksa, beceri her zaman uygundur (yapılandırmada
devre dışı bırakılmadığı veya paketli beceriler için skills.allowBundled tarafından engellenmediği sürece).
Eski
metadata.clawdbot blokları, metadata.openclaw yokken hâlâ kabul edilir;
böylece daha eski yüklü beceriler bağımlılık kapılarını ve yükleyici ipuçlarını korur.
Yeni ve güncellenmiş beceriler metadata.openclaw kullanmalıdır.Korumalı alan notları
requires.bins, beceri yükleme zamanında ana makinede denetlenir.- Bir agent korumalı alandaysa, ikili dosya konteynerin içinde de mevcut olmalıdır. Bunu
agents.defaults.sandbox.docker.setupCommand(veya özel bir imaj) üzerinden yükleyin.setupCommand, konteyner oluşturulduktan sonra bir kez çalışır. Paket yüklemeleri ayrıca ağ çıkışı, yazılabilir bir kök dosya sistemi ve korumalı alanda root kullanıcı gerektirir. - Örnek:
summarizebecerisinin (skills/summarize/SKILL.md) orada çalışabilmesi için korumalı alan konteynerindesummarizeCLI gerekir.
Yükleyici belirtimleri
Yükleyici seçim kuralları
Yükleyici seçim kuralları
- Birden fazla yükleyici listelenirse, gateway tek bir tercih edilen seçenek seçer (mevcutsa brew, aksi halde node).
- Tüm yükleyiciler
downloadise, OpenClaw mevcut artefaktları görebilmeniz için her girdiyi listeler. - Yükleyici belirtimleri, seçenekleri platforma göre filtrelemek için
os: ["darwin"|"linux"|"win32"]içerebilir. - Node yüklemeleri,
openclaw.jsoniçindekiskills.install.nodeManagerayarına uyar (varsayılan: npm; seçenekler: npm/pnpm/yarn/bun). Bu yalnızca beceri yüklemelerini etkiler; Gateway çalışma zamanı yine Node olmalıdır - Bun, WhatsApp/Telegram için önerilmez. - Gateway destekli yükleyici seçimi tercihe dayalıdır: yükleme belirtimleri farklı türleri karıştırdığında,
skills.install.preferBrewetkinse vebrewmevcutsa OpenClaw Homebrew’ı tercih eder, ardındanuv, ardından yapılandırılmış node yöneticisi, ardındangoveyadownloadgibi diğer yedekler gelir. - Her yükleme belirtimi
downloadise, OpenClaw tek bir tercih edilen yükleyiciye indirgemek yerine tüm indirme seçeneklerini gösterir.
Yükleyici başına ayrıntılar
Yükleyici başına ayrıntılar
- Go yüklemeleri:
goeksikse vebrewmevcutsa, gateway önce Homebrew üzerinden Go yükler ve mümkün olduğundaGOBINdeğerini Homebrew’ınbindizinine ayarlar. - İndirme yüklemeleri:
url(zorunlu),archive(tar.gz|tar.bz2|zip),extract(varsayılan: arşiv algılandığında otomatik),stripComponents,targetDir(varsayılan:~/.openclaw/tools/<skillKey>).
Yapılandırma geçersiz kılmaları
Paketli ve yönetilen beceriler açılıp kapatılabilir ve ortam değerleri~/.openclaw/openclaw.json içindeki skills.entries altında sağlanabilir:
false, paketli veya yüklü olsa bile beceriyi devre dışı bırakır.
Paketli coding-agent becerisi isteğe bağlıdır: agent’lara göstermeden önce
skills.entries.coding-agent.enabled: true ayarını yapın,
ardından claude, codex, opencode veya pi öğelerinden birinin yüklü ve
kendi CLI için kimliği doğrulanmış olduğundan emin olun.metadata.openclaw.primaryEnv bildiren beceriler için kolaylık sağlar. Düz metni veya SecretRef’i destekler.Yalnızca değişken süreçte zaten ayarlı değilse enjekte edilir.
Özel beceri başına alanlar için isteğe bağlı torba. Özel anahtarlar burada bulunmalıdır.
Yalnızca paketli beceriler için isteğe bağlı izin listesi. Ayarlanırsa, yalnızca listedeki paketli beceriler uygun olur (yönetilen/çalışma alanı becerileri etkilenmez).
metadata.openclaw.skillKey tanımlıyorsa, skills.entries altında bu anahtarı kullanın.
OpenClaw içinde stok görüntü oluşturma/düzenleme için paketli beceri yerine
agents.defaults.imageGenerationModel ile çekirdek image_generate aracını kullanın.
Buradaki beceri örnekleri özel veya üçüncü taraf iş akışları içindir.
Yerel görüntü analizi için agents.defaults.imageModel ile image aracını kullanın.
openai/*, google/*, fal/* veya başka bir sağlayıcıya özgü görüntü modeli seçerseniz,
o sağlayıcının kimlik doğrulama/API anahtarını da ekleyin.Ortam enjeksiyonu
Bir agent çalışması başladığında, OpenClaw:- Beceri meta verilerini okur.
skills.entries.<key>.envveskills.entries.<key>.apiKeydeğerleriniprocess.envüzerine uygular.- Sistem istemini uygun becerilerle oluşturur.
- Çalışma sona erdikten sonra özgün ortamı geri yükler.
claude-cli arka ucu için OpenClaw ayrıca aynı uygun anlık görüntüyü
geçici bir Claude Code Plugin olarak materyalize eder ve bunu --plugin-dir ile geçirir.
Claude Code daha sonra yerel beceri çözümleyicisini kullanabilir; OpenClaw ise
önceliği, agent başına izin listelerini, kapıları ve
skills.entries.* ortam/API anahtarı enjeksiyonunu yönetmeye devam eder. Diğer CLI arka uçları yalnızca
istem kataloğunu kullanır.
Anlık görüntüler ve yenileme
OpenClaw, uygun becerilerin anlık görüntüsünü bir oturum başladığında alır ve aynı oturumdaki sonraki dönüşlerde bu listeyi yeniden kullanır. Becerilerdeki veya yapılandırmadaki değişiklikler bir sonraki yeni oturumda etkili olur. Beceriler iki durumda oturum ortasında yenilenebilir:- Skills izleyicisi etkindir.
- Yeni bir uygun uzak düğüm görünür.
Skills izleyicisi
Varsayılan olarak OpenClaw, beceri klasörlerini izler veSKILL.md dosyaları
değiştiğinde beceriler anlık görüntüsünü artırır. skills.load altında yapılandırın:
allowSymlinkTargets kullanın; örneğin
~/.agents/skills/manager -> ~/Projects/manager/skills. Hedef listesi,
realpath çözümlemesinden sonra eşleştirilir ve dar tutulmalıdır.
Uzak macOS düğümleri (Linux gateway)
Gateway Linux üzerinde çalışıyorsa ancaksystem.run izni olan
(deny olarak ayarlanmamış Exec onayları güvenliği) bir macOS düğümü bağlıysa,
gerekli ikililer o düğümde mevcut olduğunda OpenClaw macOS’a özgü becerileri uygun kabul edebilir.
Agent, bu becerileri host=node ile exec aracı üzerinden yürütmelidir.
Bu, düğümün komut desteğini bildirmesine ve system.which veya system.run
üzerinden yapılan bir ikili dosya yoklamasına dayanır. Çevrimdışı düğümler
yalnızca uzak becerileri görünür yapmaz. Bağlı bir düğüm ikili dosya
yoklamalarına yanıt vermeyi durdurursa, OpenClaw önbelleğe alınmış ikili dosya
eşleşmelerini temizler; böylece agent’lar şu anda orada çalışamayan becerileri artık görmez.
Token etkisi
Beceriler uygun olduğunda, OpenClaw sistem istemine mevcut becerilerin kompakt bir XML listesini enjekte eder (pi-coding-agent içindeki
formatSkillsForPrompt üzerinden). Maliyet deterministiktir:
- Temel ek yük (yalnızca ≥1 beceri olduğunda): 195 karakter.
- Beceri başına: 97 karakter + XML kaçışlı
<name>,<description>ve<location>değerlerinin uzunluğu.
& < > " ' karakterlerini varlıklara (&, <, vb.)
genişleterek uzunluğu artırır. Token sayıları model tokenizer’ına göre değişir. Kabaca
OpenAI tarzı bir tahmin ~4 karakter/token olduğundan, beceri başına 97 karakter ≈ 24 token
artı gerçek alan uzunluklarınız gerekir.
Yönetilen beceriler yaşam döngüsü
OpenClaw, kurulumla (npm paketi veya OpenClaw.app) birlikte bir temel beceri kümesini paketli beceriler olarak gönderir.~/.openclaw/skills, yerel geçersiz kılmalar için vardır;
örneğin paketli kopyayı değiştirmeden bir beceriyi sabitlemek veya yamalamak.
Çalışma alanı becerileri kullanıcıya aittir ve ad çakışmalarında her ikisinin de üzerine yazar.
Daha fazla beceri mi arıyorsunuz?
https://clawhub.ai adresine göz atın. Tam yapılandırma şeması: Skills yapılandırması.İlgili
- ClawHub - herkese açık beceri kayıt defteri
- Beceri oluşturma - özel beceriler oluşturma
- Plugins - Plugin sistemi genel bakışı
- Skill Workshop Plugin - agent çalışmasından beceriler üretme
- Skills yapılandırması - beceri yapılandırması başvurusu
- Slash komutları - mevcut tüm slash komutları