Skills oluşturma

Skills, ajana araçları nasıl ve ne zaman kullanacağını öğretir. Her skill, YAML frontmatter ve Markdown talimatları içeren bir SKILL.md dosyasına sahip bir dizindir. OpenClaw, skill’leri tanımlı bir öncelik sırasına göre çeşitli köklerden yükler.

İlk skill’inizi oluşturun

Skill dizinini oluşturun

Skill’ler, çalışma alanınızdaki skills/ klasöründe bulunur:

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

Düzenleme amacıyla skill’leri alt klasörlerde gruplayabilirsiniz — skill yine de klasör yoluyla değil, SKILL.md frontmatter alanıyla adlandırılır:

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill adı hâlâ "hello-world" ve /hello-world olarak çağrılır

SKILL.md dosyasını yazın

Frontmatter meta verileri tanımlar; gövde ise ajana talimatları verir.

---
name: hello-world
description: Selamlama yazdıran basit bir skill.
---

# Merhaba Dünya

Kullanıcı bir selamlama istediğinde şunu çalıştırmak için `exec` aracını kullanın:

```bash
echo "Özel skill'inizden merhaba!"

Adlandırma kuralları:
- `name` için küçük harfler, rakamlar ve kısa çizgiler kullanın.
- Dizin adıyla frontmatter içindeki `name` alanını uyumlu tutun.
- `description`, ajana ve eğik çizgi komutu keşfinde gösterilir —
  tek satırda ve 160 karakterden kısa tutun.

</Step>

<Step title="Skill'in yüklendiğini doğrulayın">
```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:

# Sohbetten — mevcut oturumu arşivleyip yeni bir oturum başlatın
/new

# Veya Gateway'i yeniden başlatın
openclaw gateway restart

Test edin

openclaw agent --message "bana bir selamlama ver"

Alternatif olarak bir sohbet açıp doğrudan ajana sorun. Ada göre açıkça çağırmak için /skill hello-world kullanın.

SKILL.md başvurusu

Zorunlu alanlar

Alan	Açıklama
`name`	Küçük harfler, rakamlar ve kısa çizgiler kullanan benzersiz kısa ad
`description`	Ajana ve keşif çıktısında gösterilen tek satırlık açıklama

İsteğe bağlı frontmatter anahtarları

Alan	Varsayılan	Açıklama
`user-invocable`	`true`	Skill’i kullanıcı eğik çizgi komutu olarak sunar
`disable-model-invocation`	`false`	Skill’i ajanın sistem isteminin dışında tutar (yine de `/skill` aracılığıyla çalışır)
`command-dispatch`	—	Eğik çizgi komutunu modeli atlayarak doğrudan bir araca yönlendirmek için `tool` olarak ayarlayın
`command-tool`	—	`command-dispatch: tool` ayarlandığında çağrılacak aracın adı
`command-arg-mode`	`raw`	Araç yönlendirmesinde ham bağımsız değişkenler dizesini araca iletir
`homepage`	—	macOS Skills kullanıcı arayüzünde “Website” olarak gösterilen URL

Erişim denetimi alanları (requires.bins, requires.env vb.) için Skills — Erişim denetimi bölümüne bakın.

`{baseDir}` kullanımı

Skill dizini içindeki dosyalara yolları sabit kodlamadan başvurun — ajan {baseDir} değerini skill’in kendi dizinine göre çözümler:

`{baseDir}/scripts/run.sh` konumundaki yardımcı betiği çalıştırın.

Koşullu etkinleştirme ekleme

Skill’inizin yalnızca bağımlılıkları kullanılabilir olduğunda yüklenmesi için erişim denetimi uygulayın:

---
name: gemini-search
description: Gemini CLI kullanarak arama yapın.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---

Erişim denetimi seçenekleri

Anahtar	Açıklama
`requires.bins`	Tüm ikili dosyalar `PATH` üzerinde bulunmalıdır
`requires.anyBins`	En az bir ikili dosya `PATH` üzerinde bulunmalıdır
`requires.env`	Her ortam değişkeni süreçte veya yapılandırmada bulunmalıdır
`requires.config`	Her `openclaw.json` yolu doğru değerli olmalıdır
`os`	Platform filtresi: `["darwin"]`, `["linux"]`, `["win32"]`
`always`	Tüm erişim denetimlerini atlamak ve skill’i her zaman dahil etmek için `true` olarak ayarlayın

Tam başvuru: Skills — Erişim denetimi.

Ortam ve API anahtarları

Bir API anahtarını openclaw.json içindeki bir skill girdisine bağlayın:

{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}

Anahtar, yalnızca söz konusu ajan dönüşü için ana sürece enjekte edilir. Korumalı alana ulaşmaz — bkz. korumalı alan ortam değişkenleri.

Skill Workshop aracılığıyla önerin

Ajan tarafından taslak hâline getirilen skill’ler için veya bir skill kullanıma girmeden önce operatör incelemesi istiyorsanız doğrudan SKILL.md yazmak yerine Skill Workshop önerilerini kullanın.

# Yepyeni bir skill önerin
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "Selamlama yazdıran basit bir skill." \
  --proposal ./PROPOSAL.md

# Mevcut bir skill için güncelleme önerin
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Güncellenmiş selamlama skill'i"

Öneri destek dosyaları içeriyorsa --proposal-dir kullanın:

openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "Selamlama yazdıran basit bir skill." \
  --proposal-dir ./hello-world-proposal/

Dizin, kökünde PROPOSAL.md içermelidir. Destek dosyaları assets/, examples/, references/, scripts/ veya templates/ altında bulunur. İncelemeden sonra:

openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>

Önerinin tam yaşam döngüsü için Skill Workshop bölümüne bakın.

ClawHub’da yayımlama

SKILL.md dosyanızın eksiksiz olduğundan emin olun

name, description ve tüm metadata.openclaw erişim denetimi alanlarının ayarlandığından emin olun. Bir proje sayfanız varsa homepage URL’si ekleyin.

Bağımsız ClawHub CLI'ı yükleyin ve oturum açın

npm i -g clawhub
clawhub login

Yayımlayın

clawhub skill publish ./path/to/hello-world

Çıkarılan sürümü geçersiz kılmak veya belirli bir sahip altında yayımlamak için --version <version> ya da --owner <owner> ekleyin. Tam akış, sahip kapsamı ve diğer bakım komutları (clawhub sync, clawhub skill rename, …) için ClawHub — Yayımlama ve ClawHub CLI bölümlerine bakın.

En iyi uygulamalar

Kısa ve öz olun — modele bir yapay zekâ olarak nasıl davranacağını değil, ne yapacağını söyleyin.
Önce güvenlik — skill’iniz exec kullanıyorsa istemlerin güvenilmeyen girdilerden rastgele komut enjeksiyonuna izin vermediğinden emin olun.
Yerel olarak test edin — paylaşmadan önce openclaw agent --message "..." kullanın.
ClawHub kullanın — sıfırdan oluşturmadan önce clawhub.ai adresindeki topluluk skill’lerine göz atın.

İlgili konular

Skills başvurusu

Yükleme sırası, erişim denetimi, izin listeleri ve SKILL.md biçimi.

Skill Workshop

Ajan tarafından taslak hâline getirilen skill’ler için öneri kuyruğu.

Skills yapılandırması

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

ClawHub

Herkese açık kayıt defterindeki skill’lere göz atın ve skill yayımlayın.

Plugin oluşturma

Plugin’ler, belgeledikleri araçlarla birlikte skill’ler sunabilir.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Skills oluşturma

İlk skill’inizi oluşturun

SKILL.md başvurusu

Zorunlu alanlar

İsteğe bağlı frontmatter anahtarları

`{baseDir}` kullanımı

Koşullu etkinleştirme ekleme

Skill Workshop aracılığıyla önerin

ClawHub’da yayımlama

En iyi uygulamalar

İlgili konular

Skills başvurusu

Skill Workshop

Skills yapılandırması

ClawHub

Plugin oluşturma

​İlk skill’inizi oluşturun

​SKILL.md başvurusu

​Zorunlu alanlar

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

​{baseDir} kullanımı

​Koşullu etkinleştirme ekleme

​Skill Workshop aracılığıyla önerin

​ClawHub’da yayımlama

​En iyi uygulamalar

​İlgili konular

Skills başvurusu

Skill Workshop

Skills yapılandırması

ClawHub

Plugin oluşturma

İlk skill’inizi oluşturun

SKILL.md başvurusu

Zorunlu alanlar

İsteğe bağlı frontmatter anahtarları

`{baseDir}` kullanımı

Koşullu etkinleştirme ekleme

Skill Workshop aracılığıyla önerin

ClawHub’da yayımlama

En iyi uygulamalar

İlgili konular