OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Baslangic

Sorun Giderme

Sorun Giderme

clawhub login bir tarayıcı açıyor ancak hiçbir zaman tamamlanmıyor

CLI, tarayıcıyla oturum açma sırasında kısa ömürlü bir yerel geri çağırma sunucusu başlatır.

  • Tarayıcınızın http://127.0.0.1:<port>/callback adresine erişebildiğinden emin olun.
  • Geri çağırma hiçbir zaman ulaşmıyorsa yerel güvenlik duvarı, VPN ve proxy kurallarını kontrol edin.
  • Grafik arabirimi olmayan ortamlarda ClawHub web kullanıcı arabiriminde bir API belirteci oluşturun ve şunu çalıştırın:
bash
clawhub login --token clh_...

whoami veya publish, Unauthorized (401) döndürüyor

  • clawhub login ile yeniden oturum açın.
  • Özel bir yapılandırma yolu kullanıyorsanız CLAWHUB_CONFIG_PATH değerinin, geçerli belirtecinizi içeren dosyayı gösterdiğini doğrulayın.
  • Bir API belirteci kullanıyorsanız web kullanıcı arabiriminde iptal edilmediğini doğrulayın.

Arama veya yükleme, Rate limit exceeded (429) döndürüyor

Yanıttaki yeniden deneme bilgilerini okuyun:

  • Retry-After: yeniden denemeden önce beklenecek saniye sayısı.
  • RateLimit-Limit: bu isteğe uygulanan sınır.
  • RateLimit-Remaining: üstbilgi mevcut olduğunda kalan bütçenizin tam değeri. 429 üzerinde bu değer 0 şeklindedir.
  • RateLimit-Reset veya X-RateLimit-Reset: sıfırlama zamanlaması.

Çok sayıda kullanıcı tek bir çıkış IP'sini paylaşıyorsa her kişi yalnızca birkaç istek gönderse bile anonim IP sınırlarına ulaşılabilir. Mümkün olduğunda oturum açın ve bildirilen gecikmeden sonra yeniden deneyin.

Arama veya yükleme, proxy arkasında başarısız oluyor

CLI, standart proxy değişkenlerini dikkate alır:

bash
export HTTPS_PROXY=http://proxy.example.com:3128clawhub search "my query"

Desteklenen adlar arasında HTTPS_PROXY, HTTP_PROXY, https_proxy ve http_proxy bulunur.

Bir skill aramada görünmüyor

  • Biliyorsanız tam kısa adı veya sahip sayfasını kontrol edin.
  • Sürümün herkese açık olduğunu ve tarama ya da moderasyon nedeniyle bekletilmediğini doğrulayın.
  • Skill size aitse oturum açın ve inceleyin:
bash
clawhub inspect @openclaw/demo

Yalnızca sahibin görebildiği tanılama bilgileri tarama, yükleme geçidi veya moderasyon durumunu açıklayabilir.

Gerekli meta veriler eksik olduğu için yayımlama başarısız oluyor

Skill'ler için SKILL.md ön bilgilerini kontrol edin. Kullanıcıların ve tarayıcıların paketi anlayabilmesi için gerekli ortam değişkenleri ve araçlar bildirilmelidir.

Plugin'ler için package.json uyumluluk meta verilerini kontrol edin. Kod Plugin'i yayımlamalarında openclaw.compat.pluginApi ve openclaw.build.openclawVersion gibi OpenClaw uyumluluk alanları gereklidir.

Önce yayımlama yükünü önizleyin:

bash
clawhub package publish <source> --family code-plugin --dry-run

Yayımlama, GitHub sahibi veya kaynak hatasıyla başarısız oluyor

ClawHub, paketleri yayımlayanlarla ilişkilendirmek için GitHub kimliğini ve kaynak atfını kullanır.

  • Paketin sahibi olan veya paketi yayımlayabilen GitHub hesabıyla oturum açtığınızdan emin olun.
  • Kaynak URL'sinin herkese açık veya ClawHub tarafından erişilebilir olduğunu kontrol edin.
  • GitHub kaynakları için owner/repo, owner/repo@ref veya tam bir GitHub URL'si kullanın.

Bir ad alanı talep edilmiş veya ayrılmış olduğu için yayımlama başarısız oluyor

Sahip tanıtıcısı, kuruluş ad alanı, paket kapsamı, skill kısa adı veya paket adı zaten talep edilmiş ya da ayrılmış olduğu için yayımlama başarısız olursa önce ad alanıyla eşleşen sahip üzerinden yayımlama yaptığınızı doğrulayın. Plugin paketlerinde @example-org/example-plugin gibi kapsamlı adlar, eşleşen example-org sahibi olarak yayımlanmalıdır.

Kuruluşunuzun, projenizin veya markanızın ad alanının hak sahibi olduğuna inanıyor ancak mevcut ClawHub sahibini yönetemiyorsanız herkese açık ve hassas olmayan kanıtlarla bir Kuruluş / Ad Alanı Talebi sorunu açın. Kanıt yönergeleri ve herkese açık sorunlara nelerin eklenmemesi gerektiği için Kuruluş ve Ad Alanı Talepleri bölümüne bakın.

sync, hiçbir skill bulunamadığını söylüyor

sync, SKILL.md veya skill.md içeren klasörleri arar.

Taramak istediğiniz kökleri belirtin:

bash
clawhub sync --root /path/to/skills

Nelerin yayımlanacağından emin değilseniz önce önizleyin:

bash
clawhub sync --all --dry-run --no-input

update, yerel değişiklikler nedeniyle işlemi reddediyor

Yerel dosyalar ClawHub'ın bildiği hiçbir sürümle eşleşmiyor. Şunlardan birini seçin:

  • Yerel düzenlemeleri koruyun ve güncellemeyi atlayın.
  • Yayımlanmış sürümle üzerine yazın:
bash
clawhub update @openclaw/demo --force
  • Düzenlediğiniz kopyayı yeni bir kısa ad veya fork olarak yayımlayın.

OpenClaw'da Plugin yüklemesi başarısız oluyor

  • Açık bir ClawHub kaynağı kullanın:
bash
openclaw plugins install clawhub:<package>
  • Tarama durumu ve uyumluluk meta verileri için paket ayrıntıları sayfasını kontrol edin.
  • OpenClaw sürümünüzün paketin belirtilen uyumluluk aralığını karşıladığını doğrulayın.
  • Paket gizli, bekletilmiş veya engellenmişse sahibi sorunu çözene kadar yüklenemeyebilir.

Herkese açık API istekleri başarısız oluyor

  • 429 yeniden deneme üstbilgilerine uyun ve herkese açık liste/arama yanıtlarını önbelleğe alın.
  • Kullanıcıları standart ClawHub listeleme sayfasına geri yönlendirin.
  • Gizli, özel, bekletilmiş veya moderasyon nedeniyle engellenmiş içerikleri herkese açık API yüzeyinin dışında yansıtmayın.

Uç nokta ayrıntıları için HTTP API bölümüne bakın.

Was this useful?
On this page

On this page