Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Beceri 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 dizinin içinde SKILL.md oluşturun. Frontmatter meta verileri tanımlar, markdown gövdesi ise ajan için talimatları 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!".
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.
3

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.
4

Beceriyi yükleyin

OpenClaw’ın beceriyi algılaması için yeni bir oturum başlatın:
# From chat
/new

# Or restart the gateway
openclaw gateway restart
Becerinin yüklendiğini doğrulayın:
openclaw skills list
5

Test edin

Beceriyi tetiklemesi gereken bir mesaj gönderin:
openclaw agent --message "give me a greeting"
Ya da ajanla sohbet edip bir selamlama isteyin.

Beceri meta verileri referansı

YAML frontmatter şu alanları destekler:
AlanZorunluAçıklama
nameEvetKüçük harfler, rakamlar ve kısa çizgiler kullanan benzersiz tanımlayıcı
descriptionEvetAjana gösterilen tek satırlık açıklama
metadata.openclaw.osHayırİşletim sistemi 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 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ÖncelikKapsam
\<workspace\>/skills/En yüksekAjan başına
\<workspace\>/.agents/skills/YüksekÇalışma alanı ajanı başına
~/.agents/skills/OrtaPaylaşılan ajan profili
~/.openclaw/skills/OrtaPaylaşılan (tüm ajanlar)
Paketlenmiş (OpenClaw ile gönderilir)DüşükKüresel
skills.load.extraDirsEn düşükÖzel paylaşılan klasörler

İlgili