返回

06. OpenClaw Skills Beceri Sistemi Detaylı Açıklama

Skills, OpenClaw'ın genişletme yeteneklerinin çekirdeğidir; topluluk 5700'den fazla beceri paketi katkıda bulunmuştur. Bu makale Skills kavramını, kurulum yöntemlerini, ClawHub kullanımını, beceri sınıflandırmasını, yapılandırma yönetimini ve AI asistanının yeteneklerini geliştirmek için uygun becerileri nasıl seçeceğinizi ve kullanacağınızı detaylı olarak açıklar.

OpenClaw v2026.2 için geçerlidir | Bu makale temel kurulumu tamamladığınızı ve AI asistan yeteneklerini genişletmek istediğinizi varsayar.

TL;DR: Skills önceden paketlenmiş yetenek genişletmeleridir. Kurulum: openclaw skill install <name>, dizin: ~/.openclaw/workspace/skills/. ClawHub’da 5700+ topluluk becerisi var: kodlama asistanı, arama araştırma, geliştirme operasyonları, web otomasyonu vb. Her beceri SKILL.md (açıklama+tetikleyiciler+talimatlar), isteğe bağlı araç uygulaması içerir. Güvenlik taraması VirusTotal ile doğrulanır.

Skills Nedir?

Kavram Açıklaması

Skills önceden paketlenmiş yetenek genişletme modülleridir ve şunları içerir:

Bileşen Açıklama
SKILL.md Beceri tanım dosyası, açıklama, tetikleyiciler, talimatlar, örnekler içerir
Tools Çağrılabilir araç fonksiyonları (isteğe bağlı)
Resources İlgili kaynak dosyaları (isteğe bağlı)
Package.json Bağımlılık bildirimi (isteğe bağlı)

Skills vs Tools

Özellik Skills Tools
Kaynak Topluluk katkısı Yerleşik/özel
Kurulum Kurulum gerekir Varsayılan olarak mevcut
Karmaşıklık Çok karmaşık olabilir Genellikle basit
Paylaşılabilir Evet Genellikle paylaşılmaz
Güncelleme Bağımsız güncelleme Sistemle birlikte güncellenir

Beceri Sınıflandırması

ClawHub’daki beceriler kategoriye göre düzenlenir:

Kategori Sayı Örnek Beceriler
Kodlama Asistanı 133+ coding-agent, debug-pro, tdd-guide
Arama Araştırma 253+ web-search, deepwiki, exa-search
Geliştirme Operasyonları 212+ docker-essentials, git-workflows
Web Otomasyonu 139+ browser-control, puppeteer-skill
Üretkenlik Araçları 135+ calendar-skill, task-manager
Veri Analizi 46+ data-analyzer, budget-variance
Akıllı Ev 56+ home-assistant, smart-home-io
PDF Belgeler 67+ pdf-reader, doc-summarizer
Görsel Video 60+ image-gen, video-editor
Not Bilgi 100+ obsidian, notion-sync

Skills Kurulum Yöntemleri

Yöntem Bir: ClawHub CLI (Önerilen)

# Beceri ara
openclaw skill search gmail

# Beceri kur
openclaw skill install gmail

# Belirli sürüm kur
openclaw skill install [email protected]

# GitHub'dan kur
openclaw skill install github:user/skill-repo

# Yerel yoldan kur
openclaw skill install ./my-skill

Yöntem İki: Manuel Kurulum

# Beceri deposunu klonla
git clone https://github.com/user/skill-repo.git

# Beceri dizinine kopyala
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

Yöntem Üç: GitHub Bağlantısı Yapıştırma

Sohbette doğrudan becerinin GitHub bağlantısını gönderin, Agent otomatik olarak tanıyacak ve kuracaktır:

Bu beceriyi kurun: https://github.com/user/skill-repo

Beceri Dizin Yapısı

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

ClawHub Kullanım Kılavuzu

ClawHub’a Erişim

Tüm mevcut becerilere göz atmak için clawhub.com adresini ziyaret edin.

Beceri Arama

# CLI arama
openclaw skill search <anahtar kelime>

# Örnekler
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

Beceri Detayları

Her beceri sayfası şunları içerir:

Bilgi Açıklama
Ad ve Açıklama Becerinin işlev açıklaması
Yazar Beceri geliştiricisi
Sürüm Mevcut sürüm numarası
İndirme Sayısı Kurulum sayısı
Bağımlılıklar Gerekli diğer beceriler veya paketler
SKILL.md Önizleme Beceri tanım dosyası
Güvenlik Taraması VirusTotal tarama sonucu

Güvenlik Taraması

ClawHub, her beceriyi güvenlik taramasından geçirmek için VirusTotal ile iş birliği yapar:

# Beceri güvenlik durumunu görüntüle
openclaw skill info gmail --security

# Çıktı örneği:
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

Kurulum Öncesi Kontrol

# Beceri bağımlılıklarını kontrol et
openclaw skill check gmail

# Çıktı örneği:
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

Beceri Yapılandırması

Yapılandırma Dosyası Konumu

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

SKILL.md Yapı Detayları

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

Beceri Yapılandırma Dosyası

Bazı beceriler ek yapılandırma gerektirir:

# Beceriyi yapılandır
openclaw skill config gmail

# veya yapılandırma dosyasını manuel düzenle
vi ~/.openclaw/workspace/skills/gmail/config.json

Yapılandırma örneği:

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

Beceri Ortam Değişkenleri

# Beceri ortam değişkenlerini ayarla
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# veya .env dosyasında
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

Beceri Yönetimi

Kurulu Becerileri Görüntüleme

# Tüm becerileri listele
openclaw skill list

# Çıktı örneği:
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

Beceri Etkinleştirme/Devre Dışı Bırakma

# Beceriyi devre dışı bırak
openclaw skill disable home-assistant

# Beceriyi etkinleştir
openclaw skill enable home-assistant

Beceri Güncelleme

# Tek beceriyi güncelle
openclaw skill update gmail

# Tüm becerileri güncelle
openclaw skill update --all

# Güncellenebilir olanları kontrol et
openclaw skill outdated

Beceri Kaldırma

# Beceriyi kaldır
openclaw skill uninstall gmail

# Kaldır ve yapılandırmayı temizle
openclaw skill uninstall gmail --purge

Beceri Tanılama

# Beceri sorunlarını teşhis et
openclaw skill diagnose gmail

# Çıktı örneği:
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

Önerilen Yaygın Beceriler

Programlama Geliştirme

Beceri Adı İşlev Kurulum Komutu
coding-agent Claude Code, Codex vb. çalıştırma openclaw skill install coding-agent
debug-pro Sistematik hata ayıklama yöntemi openclaw skill install debug-pro
tdd-guide Test odaklı geliştirme openclaw skill install tdd-guide
git-workflows Git iş akışı openclaw skill install git-workflows
docker-essentials Docker temelleri openclaw skill install docker-essentials

Üretkenlik

Beceri Adı İşlev Kurulum Komutu
gmail Gmail yönetimi openclaw skill install gmail
calendar Takvim yönetimi openclaw skill install calendar
task-manager Görev yönetimi openclaw skill install task-manager
notion-sync Notion senkronizasyonu openclaw skill install notion-sync
obsidian Obsidian notları openclaw skill install obsidian

Arama Araştırma

Beceri Adı İşlev Kurulum Komutu
web-search Web araması openclaw skill install web-search
deepwiki Wiki araması openclaw skill install deepwiki
exa-search AI araması openclaw skill install exa-search
research-paper Makale araması openclaw skill install research-paper

Akıllı Ev

Beceri Adı İşlev Kurulum Komutu
home-assistant Home Assistant kontrolü openclaw skill install home-assistant
smart-home-io Akıllı ev cihazları openclaw skill install smart-home-io
philips-hue Philips Hue openclaw skill install philips-hue

Beceri Geliştirme Temelleri

Yeni Beceri Oluşturma

# Beceri şablonu oluştur
openclaw skill create my-skill

# Oluşturulan dizin yapısı
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

SKILL.md Şablonu

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

Araç Tanımı Ekleme

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

Beceri Yayınlama

# Beceriyi doğrula
openclaw skill validate my-skill

# ClawHub'a yayınla
openclaw skill publish my-skill

# veya GitHub'a gönder
git add .
git commit -m "Initial skill release"
git push origin main

Beceri Güvenliği

Güvenlik En İyi Uygulamaları

Öneri Açıklama
Kaynak İncelemesi Yalnızca güvenilir kaynaklardan beceri kurun
İzin Kontrolü Becerinin hangi izinlere ihtiyaç duyduğunu öğrenin
Kodu İnceleyin SKILL.md ve uygulama kodunu kontrol edin
İzole Test Yeni becerileri önce test ortamında kullanın
Düzenli Güncelleme Becerileri en son sürümde tutun

Beceri İzinleri

# Beceri izinlerini görüntüle
openclaw skill permissions gmail

# Çıktı örneği:
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

Beceri İzinlerini Sınırlama

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

Beceri Çakışma Çözümü

Yaygın Çakışmalar

Çakışma Türü Açıklama Çözüm
Tetikleyici Örtüşmesi Birden fazla beceri aynı anahtar kelimeye yanıt veriyor Tetikleyicileri netleştirin veya çakışan beceriyi devre dışı bırakın
Bağımlılık Çakışması Farklı beceriler farklı sürüm bağımlılıkları gerektiriyor İzole ortam kullanın
İzin Çakışması Beceriler aynı izinlere ihtiyaç duyuyor Gerekli olup olmadığını kontrol edin

Çakışmaları Çözme

# Beceri çakışmalarını görüntüle
openclaw skill conflicts

# Çıktı örneği:
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# Beceri önceliğini ayarla
openclaw skill priority gmail 10
openclaw skill priority outlook 5

İzole Ortam

Bağımlılık çakışması olan beceriler için izole ortam kullanılabilir:

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

Sorun Giderme

Beceri Çalışmıyor

# Beceri durumunu kontrol et
openclaw skill list --status

# Beceri yüklemesini kontrol et
openclaw skill load gmail --verbose

# Beceri günlüklerini görüntüle
openclaw logs --filter skill:gmail

Kimlik Doğrulama Başarısız

# Yeniden kimlik doğrulama
openclaw skill auth gmail --reauth

# Kimlik doğrulama durumunu kontrol et
openclaw skill auth gmail --status

Bağımlılık Sorunları

# Bağımlılıkları kontrol et
openclaw skill deps gmail

# Bağımlılıkları kur
openclaw skill deps gmail --install

# Bağımlılıkları güncelle
openclaw skill deps gmail --update

Beceri Yükleme Hatası

# SKILL.md sözdizimini doğrula
openclaw skill validate gmail

# Çıktı örneği:
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

Özet

Skills sistemi OpenClaw genişletme yeteneklerinin çekirdeğidir:

  • Zengin ekosistem: 5700+ topluluk becerisi çeşitli senaryoları kapsar
  • Basit kurulum: Tek satır komutla kurulum
  • Esnek yapılandırma: Özelleştirme ve geçersiz kılma desteği
  • Güvenli ve kontrollü: İzin yönetimi ve güvenlik taraması

Uygun becerileri seçerek ve yapılandırarak AI asistanınıza sınırsız yetenek genişletmesi sağlayabilirsiniz.


Bu Bölümün Özeti:

  • Skills kavramını ve yapısını anladınız
  • Birden fazla beceri kurma ve yönetme yöntemine hakim oldunuz
  • ClawHub kullanarak beceri keşfetmeyi ve değerlendirmeyi öğrendiniz
  • Beceri güvenliği ve izin yönetimini öğrendiniz
  • Beceri geliştirme temellerine hakim oldunuz

Güncelleme Kayıtları:

  • 2026-02-26: İlk sürüm yayınlandı, OpenClaw v2026.2 temel alındı

Seri Navigasyonu: