OpenClaw için Özel Beceriler Geliştirme: Adım Adım Eğitim

OpenClaw, 50'den fazla beceri paketiyle birlikte gelir ve ClawHub pazarı, topluluk tarafından oluşturulmuş 5.700'den fazla seçeneğe ev sahipliği yapar. Ancak gerçek rekabet avantajı, tam olarak iş akışlarınız için oluşturulmuş özel becerilerden gelir. Tescilli bir API'yi entegre etmeniz, karmaşık bir iş sürecini otomatikleştirmeniz veya dahili bir veritabanına bağlanmanız gerekiyorsa, özel beceriler bunu mümkün kılar.

Bu eğitimde, uyarlayabileceğiniz pratik örneklerle mimari kararlardan üretim dağıtımına kadar tüm yaşam döngüsü anlatılmaktadır.

Beceri Mimarisini Anlamak

OpenClaw'daki beceri, temsilciye belirli bir görevi nasıl gerçekleştireceğini öğreten bağımsız bir modüldür. Beceriler, basit talimat dosyalarından API entegrasyonlarına ve karmaşık mantığa sahip tam uygulamalara kadar uzanır.

Beceri Dizini Yapısı

my-custom-skill/
  SKILL.md            # Required: natural language instructions
  index.ts            # Optional: TypeScript module for logic
  config.json         # Optional: configurable parameters
  package.json        # Optional: npm dependencies
  tests/              # Optional: test files

Gerekli olan tek dosya SKILL.md'dir. Geriye kalan her şey isteğe bağlıdır ve karmaşıklık gerektirdikçe eklenir.

SKILL.md Dosyası

Bu her becerinin kalbidir. Aracıya becerinin ne yaptığını, ne zaman etkinleştirileceğini, nasıl yürütüleceğini, hangi verilere ihtiyaç duyduğunu ve çıktının nasıl biçimlendirileceğini söyler. Açık ve doğal bir dille yazın; LLM bu talimatları yorumlar.

Öğretici: CRM Arama Becerisi Oluşturma

Adım 1: Beceri Talimatlarını Tanımlayın

# CRM Customer Lookup

## When to Use
Activate when the user asks about a customer, client, or account.

## Steps
1. Extract the search criteria from the user message
2. Call the CRM API search endpoint
3. If multiple results, present a numbered list
4. If single result, display the full customer profile
5. If no results, suggest alternative search terms

Adım 2: Kod Modülünü Ekleyin

API entegrasyonları için API kimlik doğrulamasını, istek biçimlendirmesini, hata işlemeyi ve yanıt ayrıştırmayı işleyen bir index.ts dosyası ekleyin.

import { SkillContext, SkillResult } from "@openclaw/sdk";

export async function searchCustomer(
  ctx: SkillContext,
  query: string
): Promise<SkillResult> {
  const apiUrl = ctx.config.get("crm_api_url");
  const apiKey = ctx.config.get("crm_api_key");

  const response = await fetch(
    apiUrl + "/api/customers/search?q=" + encodeURIComponent(query),
    { headers: { Authorization: "Bearer " + apiKey } }
  );

  if (!response.ok) {
    return { success: false, error: "CRM API error: " + response.status };
  }

  const customers = await response.json();
  return {
    success: true,
    data: customers,
    message: "Found " + customers.length + " matching customer(s)."
  };
}

3. Adım: Beceriyi Yapılandırın

Kullanımdayken şifrelenmesi gereken kimlik bilgilerine yönelik tür bildirimleri, gerekli bayraklar ve hassas işaretleyiciler içeren yapılandırılabilir parametreler için config.json oluşturun.

Adım 4: Testleri Yazma

Sahte API yanıtlarıyla kod modülünü birim test edin. Aşamalandırmada gerçek API ile entegrasyon testi. Mesajlaşma uygulamanız aracılığıyla konuşma testi. Hatalı girişler, API hataları ve zaman aşımları içeren uç durum testi.

Adım 5: Beceriyi Kullanın

Beceri dizinini OpenClaw becerileri klasörüne kopyalayın, bağımlılıkları yükleyin ve OpenClaw'ı yeniden başlatın. Ekip dağıtımları için npm modülleri veya Git depoları olarak paket becerileri.

Gelişmiş Beceri Kalıpları

Durum Bilgili Beceriler

Bazı beceriler, OpenClaw bellek API'sini kullanarak birden fazla etkileşimde durumu korur. Konuşma dönüşleri arasında durumu okuyup yazarak, onay süreçleri gibi çok adımlı iş akışlarını etkinleştirin.

Bileşik Beceriler

Karmaşık iş akışları için diğer becerilere devredilen beceriler. Bir ProcessOrder becerisi, CRM-müşteri arama, envanter kontrolü ve fiyatlandırma-hesaplama becerilerini sırayla harekete geçirebilir ve bunların sonuçlarını tek bir yanıtta birleştirebilir.

Planlanmış Beceriler

Talep üzerine değil, cron planına göre çalışan beceriler. Otomatik günlük raporlar ve izleme görevleri için beceri yapılandırmasında zamanlamayı, saat dilimini ve bildirim kanalını yapılandırın.

Özel Beceriler için En İyi Güvenlik Uygulamaları

• Kimlik Bilgisi Yönetimi -- API anahtarlarını hiçbir zaman sabit kodlamayın. Kullanımda olmayan şifreleme için yapılandırma sistemini sensitive: true ile kullanın.
• Giriş Doğrulaması -- Kullanıcı girişlerini API'lere veya veritabanlarına aktarmadan önce daima doğrulayın ve temizleyin.
• İzin Kapsamı -- Yalnızca becerinizin ihtiyaç duyduğu izinleri isteyin. Salt okunur becerilerin yazma erişimi olmamalıdır.
• Hız Sınırlama -- İstek sayımı ile harici API'leri kazara taşmaya karşı koruyun.

Hata Ayıklama Becerileri

Beceri yürütmesini izlemek için ayrıntılı günlük kaydını etkinleştirin. Adım adım uygulama için OpenClaw beceri hata ayıklayıcısını kullanın:

openclaw skill debug my-custom-skill --input "Look up customer Acme Corp"
openclaw skill trace --last

Sıkça Sorulan Sorular

Tek bir beceri ne kadar karmaşık olmalı?

Tek sorumluluk ilkesini takip edin. Bir beceri bir şeyi iyi yapmalıdır. Karmaşık iş akışları, uzmanlaşmış iş akışlarına devredilen bileşik becerileri kullanmalıdır.

Beceri kodu için TypeScript yerine Python kullanabilir miyim?

Evet. OpenClaw, beceri kodu modülleri için TypeScript, Python ve Go'yu destekler. SKILL.md dosyası ve config.json, dilden bağımsız olarak aynı kalır.

Üretimdeki becerileri nasıl sürümlendirebilir ve güncelleyebilirim?

Config.json'da anlamsal sürüm oluşturmayı kullanın. Yeni sürümleri eski sürümlerle birlikte dağıtın (mavi-yeşil dağıtım) ve trafiği kademeli olarak değiştirin. OpenClaw yerel olarak beceri sürümü oluşturmayı destekler.

Sonraki Adımlar

Kurumsal beceri geliştirme için ECOSIRE OpenClaw özel beceriler hizmeti mimari rehberliği, kod incelemesi, güvenlik denetimi ve üretim dağıtım desteği sağlar.

---

Özel iş akışlarınız için oluşturulmuş özel becerilere mi ihtiyacınız var? Beceri değerlendirmesi için OpenClaw hizmetlerimizi keşfedin veya bize ulaşın.