English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Skills

Skills oluşturma

Skills, araca araçların nasıl ve ne zaman kullanılacağını öğretir. Her skill, YAML frontmatter ve markdown yönergeleri içeren bir SKILL.md dosyası barındıran bir dizindir.

Skills’in nasıl yüklendiği ve önceliklendirildiği için bkz. Skills.

İlk skill’inizi oluşturun

  • Skill dizinini oluştur

    Skills çalışma alanınızda bulunur. Yeni bir klasör oluşturun:

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

  • SKILL.md yaz

    Bu dizinin içinde SKILL.md oluşturun. Frontmatter, metadata’yı tanımlar; markdown gövdesi ise aracı için yönergeler içerir.

    ---
name: hello-world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".

    Skill name için küçük harfler, rakamlar ve kısa çizgilerle hyphen-case kullanın. Klasör adı ile frontmatter name değerini uyumlu tutun.

  • Araçlar ekle (isteğe bağlı)

    Frontmatter içinde özel araç şemaları tanımlayabilir veya araca mevcut sistem araçlarını (exec ya da browser gibi) kullanmasını söyleyebilirsiniz. Skills ayrıca belgeledikleri araçlarla birlikte plugins içinde de gönderilebilir.

  • Skill’i yükle

    OpenClaw’ın skill’i algılaması için yeni bir oturum başlatın:

    # From chat
/new

# Or restart the gateway
openclaw gateway restart

    Skill’in yüklendiğini doğrulayın:

    openclaw skills list

  • Test et

    Skill’i tetiklemesi gereken bir mesaj gönderin:

    openclaw agent --message "give me a greeting"

    Ya da yalnızca araçla sohbet edip bir selamlama isteyin.

    • Skill metadata referansı

    YAML frontmatter şu alanları destekler:

    Alan Zorunlu Açıklama
    name Evet Küçük harfler, rakamlar ve kısa çizgiler kullanan benzersiz tanımlayıcı
    description Evet Araca gösterilen tek satırlık açıklama
    metadata.openclaw.os Hayır İşletim sistemi filtresi (["darwin"], ["linux"] vb.)
    metadata.openclaw.requires.bins Hayır PATH üzerinde gerekli ikili dosyalar
    metadata.openclaw.requires.config Hayır Gerekli config anahtarları

    En iyi uygulamalar

    • Kısa ve öz olun — modele bir yapay zeka olarak nasıl davranacağını değil, ne yapacağını söyleyin
    • Önce güvenlik — skill’iniz exec kullanıyorsa, istemlerin güvenilmeyen girdiden rastgele komut enjeksiyonuna izin vermediğinden emin olun
    • Yerelde test edin — paylaşmadan önce test etmek için openclaw agent --message "..." kullanın
    • ClawHub kullanın — Skills’e ClawHub üzerinden göz atın ve katkıda bulunun

    Skills’in bulunduğu yerler

    Konum Öncelik Kapsam
    \<workspace\>/skills/ En yüksek Aracı başına
    \<workspace\>/.agents/skills/ Yüksek Çalışma alanı aracı başına
    ~/.agents/skills/ Orta Paylaşılan aracı profili
    ~/.openclaw/skills/ Orta Paylaşılan (tüm aracılar)
    Paketli (OpenClaw ile gönderilir) Düşük Genel
    skills.load.extraDirs En düşük Özel paylaşılan klasörler

    İlgili