Skills

Skills oluşturma

Skills, ajana araçları nasıl ve ne zaman kullanacağını öğretir. Her beceri, YAML frontmatter ve markdown talimatları içeren bir SKILL.md dosyası bulunan bir dizindir.

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

İlk becerinizi oluşturun

  • Beceri dizinini oluşturun

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

    bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world
  • SKILL.md yazın

    Bu dizinin içinde SKILL.md oluşturun. Frontmatter meta verileri tanımlar, markdown gövdesi ise ajan için talimatları içerir.

    markdown
    ---name: hello-worlddescription: 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!".

    Beceri name değeri 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 ekleyin (isteğe bağlı)

    Frontmatter içinde özel araç şemaları tanımlayabilir veya ajana mevcut sistem araçlarını (exec ya da browser gibi) kullanmasını söyleyebilirsiniz. Skills, belgeledikleri araçlarla birlikte Plugin'lerin içinde de sunulabilir.

  • Beceriyi yükleyin

    OpenClaw'ın beceriyi algılaması için yeni bir oturum başlatın:

    bash
    # From chat/new # Or restart the gatewayopenclaw gateway restart

    Becerinin yüklendiğini doğrulayın:

    bash
    openclaw skills list
  • Test edin

    Beceriyi tetiklemesi gereken bir mesaj gönderin:

    bash
    openclaw agent --message "give me a greeting"

    Ya da ajanla sohbet edip bir selamlama isteyin.

  • Beceri meta verileri 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 Ajana 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 yapılandırma anahtarları

    En iyi uygulamalar

    • Kısa ve öz olun — modele bir yapay zeka nasıl olacağını değil, ne yapacağını söyleyin
    • Önce güvenlik — beceriniz 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ınClawHub üzerinde becerilere göz atın ve katkıda bulunun

    Becerilerin bulunduğu yerler

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

    İlgili

    Was this useful?