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 ön maddesi ve Markdown talimatları içeren bir SKILL.md dosyasının bulunduğu bir dizindir. OpenClaw, Skills öğelerini tanımlı bir öncelik sırasına göre çeşitli köklerden yükler.

İlk Skill'inizi oluşturun

  • Skill dizinini oluşturun

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

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

    Düzen sağlamak için Skills öğelerini alt klasörlerde gruplayabilirsiniz; Skill yine de klasör yoluna göre değil, SKILL.md ön maddesine göre adlandırılır:

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

  • SKILL.md dosyasını yazın

    Ön madde, 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ı 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 ön maddedeki `name` değerini aynı tutun.- `description`, ajana ve eğik çizgi komutu keşfinde gösterilir;  tek satır ve 160 karakterden kısa tutun.  OPENCLAW_DOCS_MARKER:stepClose:   OPENCLAW_DOCS_MARKER:stepOpen:IHRpdGxlPSJTa2lsbCdpbiB5w7xrbGVuZGnEn2luaSBkb8SfcnVsYXnEsW4i ```bashopenclaw skills list

    OpenClaw, Skills kökleri altındaki SKILL.md dosyalarını varsayılan olarak izler. İzleyici devre dışıysa veya mevcut bir oturuma devam ediyorsanız ajanın yenilenen 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 ajandan isteyin. Adıyla 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ı ön madde anahtarları

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

    Geçiş koşulu alanları (requires.bins, requires.env vb.) için Skills — Geçiş Koşulları bölümüne bakın.

    {baseDir} kullanımı

    Yolları sabit kodlamadan Skill dizini içindeki dosyalara 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'inizi yalnızca bağımlılıkları kullanılabilir olduğunda yüklenecek şekilde koşullandırın:

    markdown
    ---name: gemini-searchdescription: Gemini CLI kullanarak arama yapar.metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---
    Geçiş koşulu 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ğruluk değeri taşımalıdır
    os Platform filtresi: ["darwin"], ["linux"], ["win32"]
    always Tüm geçiş koşullarını atlayıp Skill'i her zaman dahil etmek için true olarak ayarlayın

    Tam başvuru: Skills — Geçiş Koşulları.

    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 ilgili ajan turu için ana sürece eklenir. Korumalı alana ulaşmaz; bkz. korumalı alan ortam değişkenleri.

    Skill Workshop aracılığıyla önerin

    Ajan tarafından taslak hâline getirilen Skills için veya bir Skill kullanıma alınmadan önce operatör incelemesi istediğinizde 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/

    Dizinin kökünde PROPOSAL.md bulunmalıdır. Destek dosyaları assets/, examples/, references/, scripts/ veya templates/ altında yer alır.

    İ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 geçiş koşulu alanlarının ayarlandığından emin olun. Bir proje sayfanız varsa homepage URL'si ekleyin.

  • Bağımsız ClawHub CLI'yi yükleyip 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ı, geçiş koşulları, izin listeleri ve SKILL.md biçimi.
    Skill Workshop

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

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

    Herkese açık kayıt defterinde Skills öğelerine göz atın ve bunları yayımlayın.
    Plugin geliştirme

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

    On this page