OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Skills

Skills oluşturma

Skills, ajana araçları nasıl ve ne zaman kullanacağını öğretir. Her skill, YAML frontmatter ve Markdown talimatları içeren bir SKILL.md dosyasına sahip bir dizindir. OpenClaw, skill'leri tanımlı bir öncelik sırasına göre çeşitli köklerden yükler.

İlk skill'inizi oluşturun

  • Skill dizinini oluşturun

    Skill'ler, çalışma alanınızdaki skills/ klasöründe bulunur:

    bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world

    Düzenleme amacıyla skill'leri alt klasörlerde gruplayabilirsiniz — skill yine de klasör yoluyla değil, SKILL.md frontmatter alanıyla adlandırılır:

    bash
    mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# skill adı hâlâ "hello-world" ve /hello-world olarak çağrılır

  • SKILL.md dosyasını yazın

    Frontmatter meta verileri tanımlar; gövde ise ajana talimatları verir.

    markdown
    ---name: hello-worlddescription: Selamlama yazdıran basit bir skill.--- # Merhaba Dünya Kullanıcı bir selamlama istediğinde şunu çalıştırmak için `exec` aracını kullanın: ```bashecho "Özel skill'inizden merhaba!"
    Code
     Adlandırma kuralları:- `name` için küçük harfler, rakamlar ve kısa çizgiler kullanın.- Dizin adıyla frontmatter içindeki `name` alanını uyumlu tutun.- `description`, ajana ve eğik çizgi komutu keşfinde gösterilir —  tek satırda ve 160 karakterden kısa tutun.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSJTa2lsbCdpbiB5w7xrbGVuZGnEn2luaSBkb8SfcnVsYXnEsW4i ```bashopenclaw skills list

    OpenClaw, varsayılan olarak skill kökleri altındaki SKILL.md dosyalarını izler. İzleyici devre dışıysa veya mevcut bir oturuma devam ediyorsanız ajanın yenilenmiş listeyi alması için yeni bir oturum başlatın:

    bash
    # Sohbetten — mevcut oturumu arşivleyip yeni bir oturum başlatın/new # Veya Gateway'i yeniden başlatınopenclaw gateway restart

  • Test edin

    bash
    openclaw agent --message "bana bir selamlama ver"

    Alternatif olarak bir sohbet açıp doğrudan ajana sorun. Ada göre açıkça çağırmak için /skill hello-world kullanın.

    • SKILL.md başvurusu

    Zorunlu alanlar

    Alan Açıklama
    name Küçük harfler, rakamlar ve kısa çizgiler kullanan benzersiz kısa ad
    description Ajana ve keşif çıktısında gösterilen tek satırlık açıklama

    İsteğe bağlı frontmatter anahtarları

    Alan Varsayılan Açıklama
    user-invocable true Skill'i kullanıcı eğik çizgi komutu olarak sunar
    disable-model-invocation false Skill'i ajanın sistem isteminin dışında tutar (yine de /skill aracılığıyla çalışır)
    command-dispatch — Eğik çizgi komutunu modeli atlayarak doğrudan bir araca yönlendirmek için tool olarak ayarlayın
    command-tool — command-dispatch: tool ayarlandığında çağrılacak aracın adı
    command-arg-mode raw Araç yönlendirmesinde ham bağımsız değişkenler dizesini araca iletir
    homepage — macOS Skills kullanıcı arayüzünde "Website" olarak gösterilen URL

    Erişim denetimi alanları (requires.bins, requires.env vb.) için Skills — Erişim denetimi bölümüne bakın.

    {baseDir} kullanımı

    Skill dizini içindeki dosyalara yolları sabit kodlamadan başvurun — ajan {baseDir} değerini skill'in kendi dizinine göre çözümler:

    markdown
    `{baseDir}/scripts/run.sh` konumundaki yardımcı betiği çalıştırın.

    Koşullu etkinleştirme ekleme

    Skill'inizin yalnızca bağımlılıkları kullanılabilir olduğunda yüklenmesi için erişim denetimi uygulayın:

    markdown
    ---name: gemini-searchdescription: Gemini CLI kullanarak arama yapın.metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---
    Erişim denetimi seçenekleri
    Anahtar Açıklama
    requires.bins Tüm ikili dosyalar PATH üzerinde bulunmalıdır
    requires.anyBins En az bir ikili dosya PATH üzerinde bulunmalıdır
    requires.env Her ortam değişkeni süreçte veya yapılandırmada bulunmalıdır
    requires.config Her openclaw.json yolu doğru değerli olmalıdır
    os Platform filtresi: ["darwin"], ["linux"], ["win32"]
    always Tüm erişim denetimlerini atlamak ve skill'i her zaman dahil etmek için true olarak ayarlayın

    Tam başvuru: Skills — Erişim denetimi.

    Ortam ve API anahtarları

    Bir API anahtarını openclaw.json içindeki bir skill girdisine bağlayın:

    json5
    {  skills: {    entries: {      "gemini-search": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },      },    },  },}

    Anahtar, yalnızca söz konusu ajan dönüşü için ana sürece enjekte edilir. Korumalı alana ulaşmaz — bkz. korumalı alan ortam değişkenleri.

    Skill Workshop aracılığıyla önerin

    Ajan tarafından taslak hâline getirilen skill'ler için veya bir skill kullanıma girmeden önce operatör incelemesi istiyorsanız doğrudan SKILL.md yazmak yerine Skill Workshop önerilerini kullanın.

    bash
    # Yepyeni bir skill önerinopenclaw skills workshop propose-create \  --name "hello-world" \  --description "Selamlama yazdıran basit bir skill." \  --proposal ./PROPOSAL.md # Mevcut bir skill için güncelleme önerinopenclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "Güncellenmiş selamlama skill'i"

    Öneri destek dosyaları içeriyorsa --proposal-dir kullanın:

    bash
    openclaw skills workshop propose-create \  --name "hello-world" \  --description "Selamlama yazdıran basit bir skill." \  --proposal-dir ./hello-world-proposal/

    Dizin, kökünde PROPOSAL.md içermelidir. Destek dosyaları assets/, examples/, references/, scripts/ veya templates/ altında bulunur.

    İncelemeden sonra:

    bash
    openclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

    Önerinin tam yaşam döngüsü için Skill Workshop bölümüne bakın.

    ClawHub'da yayımlama

  • SKILL.md dosyanızın eksiksiz olduğundan emin olun

    name, description ve tüm metadata.openclaw erişim denetimi alanlarının ayarlandığından emin olun. Bir proje sayfanız varsa homepage URL'si ekleyin.

  • Bağımsız ClawHub CLI'ı yükleyin ve oturum açın

    bash
    npm i -g clawhubclawhub login

  • Yayımlayın

    bash
    clawhub skill publish ./path/to/hello-world

    Çıkarılan sürümü geçersiz kılmak veya belirli bir sahip altında yayımlamak için --version <version> ya da --owner <owner> ekleyin. Tam akış, sahip kapsamı ve diğer bakım komutları (clawhub sync, clawhub skill rename, ...) için ClawHub — Yayımlama ve ClawHub CLI bölümlerine bakın.

    • En iyi uygulamalar

    İlgili konular

    Skills başvurusu

    Yükleme sırası, erişim denetimi, izin listeleri ve SKILL.md biçimi.
    Skill Workshop

    Ajan tarafından taslak hâline getirilen skill'ler için öneri kuyruğu.
    Skills yapılandırması

    Tam skills.* yapılandırma şeması.
    ClawHub

    Herkese açık kayıt defterindeki skill'lere göz atın ve skill yayımlayın.
    Plugin oluşturma

    Plugin'ler, belgeledikleri araçlarla birlikte skill'ler sunabilir.
    Was this useful?
    On this page

    On this page