Ana içeriğe atla
Skills, ajana araçları nasıl ve ne zaman kullanacağını öğretir. Her skill, YAML frontmatter ve markdown yönergeleri içeren bir SKILL.md dosyasına sahip bir dizindir. OpenClaw, skill’leri tanımlı bir öncelik sırasına göre birkaç kökten yükler.

​
İlk skill’inizi oluşturun

1

Create the skill directory

Skills, çalışma alanınızdaki skills/ klasöründe bulunur. Yeni skill’iniz için bir dizin oluşturun:
mkdir -p ~/.openclaw/workspace/skills/hello-world
Düzen için skill’leri alt klasörlerde gruplayabilirsiniz — skill yine klasör yoluna göre değil, SKILL.md frontmatter’ındaki adla adlandırılır:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

Write SKILL.md

Dizin içinde SKILL.md oluşturun. Frontmatter metadata’yı tanımlar; gövde ajana yönergeleri verir.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


Adlandırma kuralları:
- `name` için küçük harfler, rakamlar ve kısa çizgiler kullanın.
- Dizin adını ve frontmatter `name` değerini uyumlu tutun.
- `description` ajana ve slash-command keşfinde gösterilir —
  tek satır ve 160 karakterin altında tutun.

</Step>

<Step title="Verify the skill loaded">
```bash
openclaw skills list
OpenClaw varsayılan olarak skill kökleri altındaki SKILL.md dosyalarını izler. İzleyici devre dışıysa veya mevcut bir oturuma devam ediyorsanız, ajanın yenilenmiş listeyi alması için yeni bir oturum başlatın:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

Test it

Skill’i tetiklemesi gereken bir mesaj gönderin:
openclaw agent --message "give me a greeting"
Ya da bir sohbet açıp ajana doğrudan sorun. Adıyla açıkça çağırmak için /skill hello-world kullanın.

​
SKILL.md başvurusu

​
Zorunlu alanlar

AlanAçıklama
nameKüçük harfler, rakamlar ve kısa çizgiler kullanan benzersiz slug
descriptionAjana ve keşif çıktısında gösterilen tek satırlık açıklama

​
İsteğe bağlı frontmatter anahtarları

AlanVarsayılanAçıklama
user-invocabletrueSkill’i kullanıcı slash command olarak gösterir
disable-model-invocationfalseSkill’i ajanın system prompt’undan çıkarır (/skill ile yine çalışır)
command-dispatch—Slash command’ı modeli atlayarak doğrudan bir araca yönlendirmek için tool olarak ayarlayın
command-tool—command-dispatch: tool ayarlandığında çağrılacak araç adı
command-arg-moderawAraç yönlendirmesi için ham argüman dizesini araca iletir
homepage—macOS Skills kullanıcı arayüzünde “Website” olarak gösterilen URL
Geçit alanları (requires.bins, requires.env vb.) için Skills — Gating bölümüne bakın.

​
{baseDir} kullanımı

Skill gövdesinde, yolları sabit yazmadan skill dizini içindeki dosyalara başvurmak için {baseDir} kullanın: 
Run the helper script at `{baseDir}/scripts/run.sh`.

​
Koşullu etkinleştirme ekleme

Skill’inizi yalnızca bağımlılıkları mevcut olduğunda yüklenecek şekilde geçide alın: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
AnahtarAçıklama
requires.binsTüm ikili dosyalar PATH üzerinde mevcut olmalıdır
requires.anyBinsEn az bir ikili dosya PATH üzerinde mevcut olmalıdır
requires.envHer env var işlemde veya yapılandırmada mevcut olmalıdır
requires.configHer openclaw.json yolu truthy olmalıdır
osPlatform filtresi: ["darwin"], ["linux"], ["win32"]
alwaysTüm geçitleri atlayıp skill’i her zaman dahil etmek için true olarak ayarlayın
Tam başvuru: Skills — Gating.
openclaw.json içinde bir API anahtarını skill girdisine bağlayın:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
Anahtar yalnızca o ajan turu için host işlemine enjekte edilir. Sandbox’a ulaşmaz — bkz. sandbox env var’ları.

​
Skill Workshop üzerinden önerin

Ajan tarafından taslaklanan skill’ler için veya bir skill canlıya alınmadan önce operatör incelemesi istediğinizde, doğrudan SKILL.md yazmak yerine Skill Workshop önerilerini kullanın. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"
Öneri destek dosyaları içerdiğinde --proposal-dir kullanın: 
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/
Dizin PROPOSAL.md içermelidir. Destek dosyaları assets/, examples/, references/, scripts/ veya templates/ içine konabilir. İncelemeden sonra: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
Tam öneri yaşam döngüsü için Skill Workshop bölümüne bakın.

​
ClawHub’a yayımlama

1

Ensure your SKILL.md is complete

name, description ve varsa metadata.openclaw geçit alanlarının ayarlandığından emin olun. Bir proje sayfanız varsa homepage URL’si ekleyin.
2

Install the ClawHub skill

ClawHub skill’i, geçerli yayımlama komutu biçimini ve gerekli metadata’yı belgeler:
openclaw skills install @openclaw/clawhub-publish
3

Publish

clawhub publish
Tam akış için ClawHub — Publishing bölümüne bakın.

​
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, prompt’ların güvenilmeyen girdiden rastgele komut enjeksiyonuna izin vermediğinden emin olun.
  • Yerelde test edin — paylaşmadan önce openclaw agent --message "..." kullanın.
  • ClawHub kullanın — sıfırdan oluşturmadan önce clawhub.ai adresinde topluluk skill’lerine göz atın.

​
İlgili

Skills reference

Yükleme sırası, geçitler, izin listeleri ve SKILL.md biçimi.

Skill Workshop

Ajan tarafından taslaklanan skill’ler için öneri kuyruğu.

Skills config

Tam skills.* yapılandırma şeması.

ClawHub

Genel registry’de skill’lere göz atın ve yayımlayın.

Building plugins

Plugins, belgeledikleri araçlarla birlikte skill’ler gönderebilir.