Ana içeriğe atla

​
Skills Oluşturma

Skills, aracıya araçları nasıl ve ne zaman kullanacağını öğretir. Her Skill, YAML frontmatter ve markdown yönergeleri içeren bir SKILL.md dosyası barındıran bir dizindir. Skills öğelerinin nasıl yüklendiği ve önceliklendirildiği için bkz. Skills.

​
İlk Skill’inizi oluşturun

1

Skill dizinini oluşturun

Skills, çalışma alanınızda bulunur. Yeni bir klasör oluşturun:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

SKILL.md yazın

Bu dizin içinde SKILL.md oluşturun. Frontmatter meta verileri tanımlar, markdown gövdesi ise aracı için yönergeleri 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!".
3

Araçlar ekleyin (isteğe bağlı)

Frontmatter içinde özel araç şemaları tanımlayabilir veya aracıya mevcut sistem araçlarını (exec veya browser gibi) kullanmasını söyleyebilirsiniz. Skills ayrıca belgeledikleri araçlarla birlikte plugin’lerin içinde de dağıtılabilir.
4

Skill'i yükleyin

OpenClaw’ın Skill’i algılaması için yeni bir oturum başlatın:
# Sohbetten
/new

# Veya gateway'i yeniden başlatın
openclaw gateway restart
Skill’in yüklendiğini doğrulayın:
openclaw skills list
5

Test edin

Skill’i tetiklemesi gereken bir mesaj gönderin:
openclaw agent --message "give me a greeting"
Veya aracıyla sohbet edin ve ondan bir selamlama isteyin.

​
Skill meta veri başvurusu

YAML frontmatter şu alanları destekler:
FieldRequiredDescription
nameEvetBenzersiz tanımlayıcı (snake_case)
descriptionEvetAracıya gösterilen tek satırlık açıklama
metadata.openclaw.osHayırOS filtresi (["darwin"], ["linux"] vb.)
metadata.openclaw.requires.binsHayırPATH üzerinde gerekli ikili dosyalar
metadata.openclaw.requires.configHayırGerekli yapılandırma anahtarları

​
En iyi uygulamalar

  • Kısa olun — modele bir AI gibi 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 — ClawHub üzerinde Skills öğelerine göz atın ve katkıda bulunun

​
Skills nerede bulunur

LocationÖncelikKapsam
\<workspace\>/skills/En yüksekAracı başına
\<workspace\>/.agents/skills/YüksekÇalışma alanı aracısı başına
~/.agents/skills/OrtaPaylaşılan aracı profili
~/.openclaw/skills/OrtaPaylaşılan (tüm aracılar)
Paketlenmiş (OpenClaw ile gelir)DüşükGenel
skills.load.extraDirsEn düşükÖzel paylaşılan klasörler

​
İlgili