ClawHub
ClawHub, OpenClaw skills ve eklentileri için herkese açık kayıt defteridir.- Skills aramak/kurmak/güncellemek ve ClawHub’dan eklenti kurmak için yerel
openclawkomutlarını kullanın. - Kayıt defteri kimlik doğrulaması, yayımlama, silme, silmeyi geri alma veya eşitleme iş akışlarına ihtiyaç duyduğunuzda ayrı
clawhubCLI’yi kullanın.
Yerel OpenClaw akışları
Skills:openclaw komutları etkin çalışma alanınıza kurulum yapar ve kaynak
meta verilerini kalıcı olarak saklar; böylece sonraki update çağrıları ClawHub üzerinde kalabilir.
Eklenti kurulumları, arşiv kurulumu çalıştırılmadan önce ilan edilen pluginApi ve minGatewayVersion
uyumluluğunu doğrular; böylece uyumsuz ana makineler paketi kısmen kurmak yerine
erken ve kapalı biçimde başarısız olur.
openclaw plugins install clawhub:... yalnızca kurulabilir eklenti ailelerini kabul eder.
Bir ClawHub paketi aslında bir skill ise, OpenClaw durur ve bunun yerine sizi
openclaw skills install <slug> komutuna yönlendirir.
ClawHub nedir
- OpenClaw skills ve eklentileri için herkese açık bir kayıt defteri.
- Skill paketleri ve meta verileri için sürümlü bir depo.
- Arama, etiketler ve kullanım sinyalleri için bir keşif yüzeyi.
Nasıl çalışır
- Bir kullanıcı bir skill paketi yayımlar (dosyalar + meta veriler).
- ClawHub paketi saklar, meta verileri ayrıştırır ve bir sürüm atar.
- Kayıt defteri skill’i arama ve keşif için dizinler.
- Kullanıcılar OpenClaw içinde skill’lere göz atar, indirir ve kurar.
Neler yapabilirsiniz
- Yeni skills ve mevcut skills’in yeni sürümlerini yayımlayabilirsiniz.
- Skills’i ada, etiketlere veya aramaya göre keşfedebilirsiniz.
- Skill paketlerini indirip dosyalarını inceleyebilirsiniz.
- Kötüye kullanılan veya güvenli olmayan skills’i bildirebilirsiniz.
- Moderatörseniz gizleyebilir, görünür yapabilir, silebilir veya yasaklayabilirsiniz.
Bu kimin için (başlangıç dostu)
OpenClaw aracınıza yeni yetenekler eklemek istiyorsanız, ClawHub skills bulup kurmanın en kolay yoludur. Arka ucun nasıl çalıştığını bilmeniz gerekmez. Şunları yapabilirsiniz:- Skills’i doğal dille aramak.
- Bir skill’i çalışma alanınıza kurmak.
- Skills’i daha sonra tek komutla güncellemek.
- Kendi skills’inizi yayımlayarak yedeklemek.
Hızlı başlangıç (teknik olmayan)
- İhtiyacınız olan bir şeyi arayın:
openclaw skills search "calendar"
- Bir skill kurun:
openclaw skills install <skill-slug>
- Yeni skill’in algılanması için yeni bir OpenClaw oturumu başlatın.
- Kayıt defteri yayımlama veya kimlik doğrulamasını yönetmek istiyorsanız ayrıca
clawhubCLI’yi de kurun.
ClawHub CLI’yi kurun
Buna yalnızca yayımlama/eşitleme gibi kayıt defteri kimliği doğrulanmış iş akışları için ihtiyacınız vardır:OpenClaw içine nasıl oturur
Yerelopenclaw skills install, etkin çalışma alanındaki skills/
dizinine kurulum yapar. openclaw plugins install clawhub:..., güncellemeler için
normal yönetilen bir eklenti kurulumu ile birlikte ClawHub kaynak meta verilerini kaydeder.
Anonim ClawHub eklenti kurulumları özel paketler için de kapalı biçimde başarısız olur.
Topluluk veya diğer resmi olmayan kanallar yine de kurulabilir, ancak OpenClaw
operatörlerin etkinleştirmeden önce kaynağı ve doğrulamayı inceleyebilmesi için uyarı verir.
Ayrı clawhub CLI de skills’i mevcut çalışma dizininiz altındaki ./skills içine kurar.
Bir OpenClaw çalışma alanı yapılandırılmışsa, clawhub
--workdir (veya CLAWHUB_WORKDIR) ile geçersiz kılmadığınız sürece o çalışma alanına geri döner.
OpenClaw çalışma alanı skills’ini <workspace>/skills
içinden yükler ve bunları bir sonraki oturumda algılar. Zaten
~/.openclaw/skills veya paketlenmiş skills kullanıyorsanız, çalışma alanı skills öncelikli olur.
Skills’in nasıl yüklendiği, paylaşıldığı ve kapılandığı hakkında daha fazla ayrıntı için
Skills bölümüne bakın.
Skill sistemi genel bakışı
Bir skill, OpenClaw’a belirli bir görevin nasıl yapılacağını öğreten sürümlü bir dosya paketidir. Her yayımlama yeni bir sürüm oluşturur ve kayıt defteri, kullanıcıların değişiklikleri denetleyebilmesi için sürüm geçmişini tutar. Tipik bir skill şunları içerir:- Birincil açıklama ve kullanım için bir
SKILL.mddosyası. - Skill tarafından kullanılan isteğe bağlı yapılandırmalar, betikler veya destekleyici dosyalar.
- Etiketler, özet ve kurulum gereksinimleri gibi meta veriler.
Hizmetin sağladıkları (özellikler)
- Skills ve bunların
SKILL.mdiçeriğinde herkese açık gezinme. - Yalnızca anahtar sözcüklere değil, embedding’lere (vektör arama) dayalı arama.
- Semver, değişiklik günlükleri ve etiketler (
latestdahil) ile sürümlendirme. - Sürüm başına zip olarak indirmeler.
- Topluluk geri bildirimi için yıldızlar ve yorumlar.
- Onaylar ve denetimler için moderasyon kancaları.
- Otomasyon ve betik yazımı için CLI dostu API.
Güvenlik ve moderasyon
ClawHub varsayılan olarak açıktır. Herkes skills yükleyebilir, ancak yayımlama için bir GitHub hesabının en az bir haftalık olması gerekir. Bu, meşru katkıcıları engellemeden kötüye kullanımı yavaşlatmaya yardımcı olur. Bildirme ve moderasyon:- Oturum açmış her kullanıcı bir skill bildirebilir.
- Bildirim nedenleri zorunludur ve kaydedilir.
- Her kullanıcının aynı anda en fazla 20 etkin bildirimi olabilir.
- 3’ten fazla benzersiz bildirimi olan skills varsayılan olarak otomatik gizlenir.
- Moderatörler gizli skills’i görüntüleyebilir, görünür yapabilir, silebilir veya kullanıcıları yasaklayabilir.
- Bildirim özelliğinin kötüye kullanımı hesap yasaklarıyla sonuçlanabilir.
CLI komutları ve parametreleri
Genel seçenekler (tüm komutlara uygulanır):--workdir <dir>: Çalışma dizini (varsayılan: mevcut dizin; OpenClaw çalışma alanına geri döner).--dir <dir>: Çalışma dizinine göreli skills dizini (varsayılan:skills).--site <url>: Site temel URL’si (tarayıcı girişi).--registry <url>: Kayıt defteri API temel URL’si.--no-input: İstemleri devre dışı bırak (etkileşimsiz).-V, --cli-version: CLI sürümünü yazdır.
clawhub login(tarayıcı akışı) veyaclawhub login --token <token>clawhub logoutclawhub whoami
--token <token>: Bir API belirteci yapıştırın.--label <label>: Tarayıcı giriş belirteçleri için saklanan etiket (varsayılan:CLI token).--no-browser: Tarayıcı açma (--tokengerektirir).
clawhub search "query"--limit <n>: En fazla sonuç.
clawhub install <slug>--version <version>: Belirli bir sürümü kur.--force: Klasör zaten varsa üzerine yaz.
clawhub update <slug>clawhub update --all--version <version>: Belirli bir sürüme güncelle (yalnızca tek slug).--force: Yerel dosyalar yayımlanmış hiçbir sürümle eşleşmiyorsa üzerine yaz.
clawhub list(.clawhub/lock.jsondosyasını okur)
clawhub skill publish <path>--slug <slug>: Skill slug’ı.--name <name>: Görünen ad.--version <version>: Semver sürümü.--changelog <text>: Değişiklik günlüğü metni (boş olabilir).--tags <tags>: Virgülle ayrılmış etiketler (varsayılan:latest).
clawhub package publish <source><source>yerel bir klasör,owner/repo,owner/repo@refveya bir GitHub URL’si olabilir.--dry-run: Hiçbir şey yüklemeden tam yayımlama planını oluştur.--json: CI için makine tarafından okunabilir çıktı ver.--source-repo,--source-commit,--source-ref: Otomatik algılama yeterli olmadığında isteğe bağlı geçersiz kılmalar.
clawhub delete <slug> --yesclawhub undelete <slug> --yes
clawhub sync--root <dir...>: Ek tarama kökleri.--all: İstem olmadan her şeyi yükle.--dry-run: Neyin yükleneceğini göster.--bump <type>: Güncellemeler içinpatch|minor|major(varsayılan:patch).--changelog <text>: Etkileşimsiz güncellemeler için değişiklik günlüğü.--tags <tags>: Virgülle ayrılmış etiketler (varsayılan:latest).--concurrency <n>: Kayıt defteri kontrolleri (varsayılan: 4).
Aracılar için yaygın iş akışları
Skills arama
Yeni skills indirme
Kurulu skills’i güncelleme
Skills’inizi yedekleme (yayımlama veya eşitleme)
Tek bir skill klasörü için:GitHub’dan bir eklenti yayımlama
package.json içinde gerekli OpenClaw meta verilerini içermelidir:
Gelişmiş ayrıntılar (teknik)
Sürümlendirme ve etiketler
- Her yayımlama yeni bir semver
SkillVersionoluşturur. latestgibi etiketler bir sürümü işaret eder; etiketleri taşıyarak geri alma yapabilirsiniz.- Değişiklik günlükleri sürüm başına eklenir ve eşitleme veya güncelleme yayımlarken boş olabilir.
Yerel değişiklikler ve kayıt defteri sürümleri
Güncellemeler, yerel skill içeriğini içerik karması kullanarak kayıt defteri sürümleriyle karşılaştırır. Yerel dosyalar yayımlanmış hiçbir sürümle eşleşmiyorsa, CLI üzerine yazmadan önce sorar (veya etkileşimsiz çalıştırmalarda--force gerektirir).
Eşitleme taraması ve geri dönüş kökleri
clawhub sync önce mevcut çalışma dizininizi tarar. Skill bulunmazsa, bilinen eski konumlara geri döner (örneğin ~/openclaw/skills ve ~/.openclaw/skills). Bu, ek bayraklar olmadan eski skill kurulumlarını bulmak için tasarlanmıştır.
Depolama ve kilit dosyası
- Kurulu skills, çalışma dizininiz altında
.clawhub/lock.jsoniçine kaydedilir. - Kimlik doğrulama belirteçleri ClawHub CLI yapılandırma dosyasında saklanır (
CLAWHUB_CONFIG_PATHile geçersiz kılınabilir).
Telemetri (kurulum sayıları)
clawhub sync komutunu oturum açıkken çalıştırdığınızda, CLI kurulum sayılarını hesaplamak için en az düzeyde bir anlık görüntü gönderir. Bunu tamamen devre dışı bırakabilirsiniz:
Ortam değişkenleri
CLAWHUB_SITE: Site URL’sini geçersiz kıl.CLAWHUB_REGISTRY: Kayıt defteri API URL’sini geçersiz kıl.CLAWHUB_CONFIG_PATH: CLI’nin belirteç/yapılandırmayı nereye kaydettiğini geçersiz kıl.CLAWHUB_WORKDIR: Varsayılan çalışma dizinini geçersiz kıl.CLAWHUB_DISABLE_TELEMETRY=1:syncsırasında telemetriyi devre dışı bırakır.