Bir ClawHub becerisini ajanınız çalıştırmadan önce incelemek

OpenClaw kendi altyapınızda barındırdığınız kişisel bir ajandır: kontrol ettiğiniz bir makinede çalışır, sizinle sohbet uygulamaları üzerinden konuşur ve nasıl kurduğunuza bağlı olarak dosyalar, kabuk, tarayıcı ve hesaplarınız üzerinde işlem yapabilir. ClawHub ise insanların onun için beceri paylaştığı açık kayıt deposudur. Bir beceriyi kurmak saniyeler sürer; sorun da tam olarak budur. Beceri, çoğu zaman yanında betikler de bulunan ve ajanınızın ona verdiğiniz tüm erişimle uygulayacağı bir talimat setidir. Her birini, okuyana kadar bir yabancının yazdığı güvenilmeyen kod olarak görün. Bu sayfa önerilen becerilerin bir listesi değildir; böyle her liste eskir ve hiçbiri kurduğunuz şeye kefil olamaz. Bunun yerine herhangi bir açık kayıt deposundaki herhangi bir beceriye uygulayabileceğiniz bir inceleme yöntemi sunar. Hâlâ bir ajan seçiyorsanız kişisel ajan seçimi ve güvenilir hâle getirilmesi yazısına bakın.

Beceri nedir ve neden incelenmeyi hak eder

OpenClaw'un kullandığı biçimde bir beceri, merkezinde SKILL.md dosyası bulunan bir klasördür: adı ve açıklamayı içeren kısa bir başlık bölümü, ardından düz bir dille yazılmış talimatlar. Klasörde betikler, şablonlar ve başvuru dosyaları da bulunabilir. Ajan, becerinin ne zaman işe yarayacağına açıklamayı okuyarak karar verir ve gerektiğinde geri kalanını yükler. Genel kavram için ajan becerileri nedir yazısına bakın.

Becerileri göründüğünden daha riskli kılan üç şey var:

• Talimatlar uygulanabilir niyettir. "Başlamadan önce aşağıdaki kurulum komutunu çalıştır" gibi bir cümle, kabuk erişimi olan bir ajan tarafından yerine getirilir. Kötü niyetli ya da özensiz talimatların zarar vermek için tek satır koda ihtiyacı yoktur.
• Beceriyle gelen betikler ajanınızın haklarıyla çalışır. Ajan ev dizininizi okuyabiliyorsa, çalıştırması söylenen her betik de okuyabilir.
• İçerik kurulumdan sonra değişebilir. Çalışma anında bir URL'den betik çeken ya da kendini güncelleyen bir beceri, yarın, onu okuduğunuz gündekinden farklı davranabilir.

Becerinin neye dokunabildiğini çıkarın

Kurmadan önce beceriyi indirin ve yalnızca kayıt deposu sayfasındaki açıklamayı değil, her dosyayı okuyun. Ne yaptığını beş başlık altında not edin:

Terminalden hızlı bir ilk tarama bariz durumları yakalar; okumanın yerini tutmaz:

grep -rnE "curl|wget|base64|eval|chmod|ssh|\.env|token|api[_-]?key|crontab" ./beceri-klasoru

Ardından bulduklarınızı becerinin yaptığını iddia ettiği şeyle karşılaştırın. E-posta yapılandırmanızı okuyan bir hava durumu becerisi ya da ödeme token'ı isteyen bir not alma becerisi, bilmeniz gerekeni zaten söylemiştir.

İzinleri beceriden bağımsız belirleyin

Beceri, ajanın ne yapması gerektiğini anlatır. Ajanın neye izinli olduğuna karar veren şey asla beceri olmamalıdır. İzinleri ajanın kendi yapılandırmasında belirleyin ve hangi beceriler kurulu olursa olsun dar tutun:

• Ajanınız destekliyorsa araç çalıştırmayı bir kum havuzunda (sandbox) ya da ayrı bir kullanıcı hesabında, yalnızca bir çalışma dizinine erişimle yapın.
• Komutlar ve araçlar için yasak listesi yerine izin listesini tercih edin. OpenClaw sürümünüzün kum havuzu ve komutlar için onay istemi gibi hangi kontrolleri sunduğunu kontrol edin.
• Gönderen, silen, ödeme yapan ya da zamanlayan her şey için onay isteyin.
• Ajana kişisel token'larınızı değil, yalnızca ona ait düşük yetkili kimlik bilgileri verin.
• Ajanın yapılandırma ve bellek dosyalarını, onları değiştirmek için bir nedeni olmayan becerilerin erişiminden uzak tutun.

İlke, MCP sunucuları ve CLI'lar için geçerli olanla aynıdır: bir yeteneği bağlamak tek başına yetkiyi genişletmemelidir. Araçları yetkiyi genişletmeden bağlamak notu bu fikri açıyor; ajanlara salt okumayla başlamak notu da her yeni yeteneğin ilk sürümünün neden bir şeyi değiştirmek yerine yalnızca bakması gerektiğini anlatıyor.

Köken bilgisini kontrol edin

Bir kayıt deposu girdisi size bir ad ve bir açıklama verir. Ona güvenmeden önce beceriyi kimin yazdığını ve indirdiğiniz şeyin incelediğinizle aynı olup olmadığını netleştirin.

• Yayıncı. Bağlantılı bir kaynak deposu ve başka işlerden oluşan bir geçmişi olan, kimliği belirlenebilir bir geliştirici var mı? Popüler görünen tek bir beceriye sahip yeni bir hesap ek dikkat gerektirir.
• Ad. Bilinen becerilerin bir harf farklı ya da fazladan bir kelime içeren kopyalarına dikkat edin. Ad taklidi (typosquatting) her paket deposunda görülen eski bir numaradır.
• Kaynakla eşleşme. Kayıt deposundaki paket kaynak deposuyla aynı mı? İkisini satır satır karşılaştırın.
• Geçmiş. Değişiklik günlüğünü ya da commit geçmişini okuyun. Küçük bir güncellemede gelen büyük değişiklikler ya da eskiden yalnızca metinden oluşan bir beceriye yakın zamanda eklenmiş betikler ikinci bir bakışı hak eder.
• Kanıt olmayan sinyaller. İndirme sayıları, yıldızlar ve yorumlar güvenliği değil popülerliği gösterir. Çok kurulan bir beceri, saldırganlar için de daha cazip bir hedeftir.

Bir sürümü inceledikten sonra onu sabitleyin. Bir kopyasını kendi deponuzda ya da yapılandırmanızda tutun; böylece çalıştırdığınız kod okuduğunuz kodla aynı olur. Her güncellemeyi yeni bir inceleme olarak ele alın.

Gerçek kullanımdan önce örnek veriyle deneyin

Okumak çok şeyi yakalar, ama son kontrol davranıştır. Beceriyi önce silip atabileceğiniz bir ortamda çalıştırın:

1. Yalıtılmış bir ortam hazırlayın: sanal makine, konteyner ya da yeni bir ajan profiline sahip, gerçek kimlik bilgisi bulunmayan ayrı bir işletim sistemi kullanıcısı.
2. Gerçek malzemenize benzeyen ama hassas hiçbir şey içermeyen örnek veriler hazırlayın; yanına açıkça sahte gizli bilgiler barındıran birkaç tuzak dosya ekleyin.
3. Becerinin amaçlandığı temsilî görevleri ve amaçlanmadığı birkaç görevi çalıştırın.
4. Dışa giden ağ bağlantılarını, çalışma dizini dışındaki dosya değişikliklerini ve yeni zamanlanmış işleri izleyin.
5. Ajanın döküm kaydını okuyun. Becerinin talimatlarını izleyip sizin istemediğiniz bir şey yaptı mı? Tuzak dosyalardaki sahte gizli bilgiler okundu ya da bir yere gönderildi mi?

Beceri bu denemeden geçerse sabitlenmiş sürümü yukarıda anlatılan dar izinlerle kurun ve kurulu becerilerin sürümünü ve ne zaman incelendiğini gösteren bir envanter tutun. Artık kullanmadığınız becerileri kaldırın; her biri ek saldırı yüzeyidir. Küçük ihtiyaçlar için kendi becerinizi yazmak çoğu zaman başkasınınkini incelemekten daha hızlıdır: bir CLI'ı ajan becerisine dönüştürmek yazısı bu kalıbı gösteriyor.

GoCux nerede durur

GoCux becerilere bu sayfanın önerdiği gözle bakar: yeniden kullanılabilir bir talimat seti kendi başına hiçbir izin vermez. Bir GoCux iş emrinde işin gerektirdiği becerileri GoCux seçer; ancak ajanın neye izinli olduğunu beceri değil, iş emrinin kapsamı ve şirketin kuralları belirler. Sonuç doğuran eylemler, beceri ne derse desin bir kişinin kararını bekler: dışarıya bir şey göndermek, veri silmek, dosya dışa aktarmak ve iş zamanlamak karar için durur; ajanın kendi talimatlarındaki bir değişiklik de geçerli olmadan önce incelemeye alınır. Her adım, karar ve sonuç tek bir denetim izinde yer alır. Müşteri CLI'ı kendi yerel araçlarının ve izinlerinin sahibi olmaya devam eder. Dokümantasyondaki ajan becerileri sayfasına ve bir kişinin kararını bekleyen yedi eylem sınıfı notuna bakın.

İnceleme kontrol listesi

• Becerideki her dosyayı okudunuz; yalnızca kayıt deposundaki açıklamayı değil.
• İlgili dosyaları, komutları, sunucuları, kimlik bilgilerini ve eylemleri listelediniz; hepsi belirtilen amaçla örtüşüyor.
• Kurulumda ya da çalışma anında, sizin incelemeniz olmadan kod indirip çalıştıran bir şey yok.
• Yayıncı ve kaynak deposu belirlenebiliyor; paket kaynakla eşleşiyor.
• Sürüm sabitlendi ve bir kopyası sizin denetiminizde tutuluyor; güncellemeler yeni bir incelemeyi tetikliyor.
• Beceri, örnek veri ve tuzak gizli bilgilerle yalıtılmış bir ortamda çalıştı ve amacının dışına çıkmadı.
• İzinler ajanın yapılandırmasında, dar ve beceriden bağımsız olarak tanımlı.
• Gönderme, silme, ödeme ve zamanlama hâlâ sizin onayınızı gerektiriyor.