CLI commands
Skills
openclaw skills
Yerel Skills öğelerini inceleyin, ClawHub'da arama yapın, ClawHub/Git/yerel dizinlerden Skills yükleyin, ClawHub Skills öğelerini doğrulayın ve ClawHub tarafından izlenen yüklemeleri güncelleyin.
İlgili:
- Skills sistemi: Skills
- Skills Atölyesi: Skills Atölyesi
- Skills yapılandırması: Skills yapılandırması
- ClawHub yüklemeleri: ClawHub
Komutlar
openclaw skills search "calendar"openclaw skills search --limit 20 --jsonopenclaw skills install @owner/<slug>openclaw skills install @owner/<slug> --version <version>openclaw skills install git:owner/repoopenclaw skills install git:owner/repo@mainopenclaw skills install ./path/to/skill --as custom-nameopenclaw skills install @owner/<slug> --forceopenclaw skills install @owner/<slug> --force-installopenclaw skills install @owner/<slug> --acknowledge-clawhub-riskopenclaw skills install @owner/<slug> --agent <id>openclaw skills install @owner/<slug> --globalopenclaw skills update @owner/<slug>openclaw skills update @owner/<slug> --force-installopenclaw skills update @owner/<slug> --acknowledge-clawhub-riskopenclaw skills update @owner/<slug> --globalopenclaw skills update --allopenclaw skills update --all --agent <id>openclaw skills update --all --globalopenclaw skills verify @owner/<slug>openclaw skills verify @owner/<slug> --version <version>openclaw skills verify @owner/<slug> --tag <tag>openclaw skills verify @owner/<slug> --cardopenclaw skills verify @owner/<slug> --globalopenclaw skills listopenclaw skills list --eligibleopenclaw skills list --jsonopenclaw skills list --verboseopenclaw skills list --agent <id>openclaw skills info <name>openclaw skills info <name> --jsonopenclaw skills info <name> --agent <id>openclaw skills checkopenclaw skills check --agent <id>openclaw skills check --jsonopenclaw skills workshop propose-create --name "qa-check" --description "QA checklist" --proposal ./PROPOSAL.mdopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Not reusable"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"search, update ve verify doğrudan ClawHub'ı kullanır. install @owner/<slug>
bir ClawHub Skill öğesi yükler, install git:owner/repo[@ref] bir Git Skill
öğesini klonlar ve install ./path yerel bir Skill dizinini kopyalar. Varsayılan
olarak install, update ve verify, etkin çalışma alanının skills/ dizinini
hedefler; --global ile paylaşılan, yönetilen Skills dizinini hedefler.
list/info/check ise geçerli çalışma alanı ve yapılandırma tarafından
görülebilen yerel Skills öğelerini incelemeye devam eder. Çalışma alanına dayalı
komutlar hedef çalışma alanını sırasıyla --agent <id> üzerinden, geçerli çalışma
dizini yapılandırılmış bir aracı çalışma alanının içindeyse bu dizinden ve son
olarak varsayılan aracıdan çözümler.
Git ve yerel dizin yüklemeleri, kaynak kökünde SKILL.md bulunmasını bekler.
Yükleme kısa adı, geçerliyse SKILL.md ön bilgilerindeki name alanından,
ardından kaynak dizin veya depo adından alınır; bunu geçersiz kılmak için
--as <slug> kullanın. --version yalnızca ClawHub içindir. Skill yüklemeleri
npm paket belirtimlerini veya zip/arşiv yollarını desteklemez ve
openclaw skills update yalnızca ClawHub tarafından izlenen yüklemeleri
günceller.
İlk katılım veya Skills ayarlarından tetiklenen, Gateway destekli Skill
bağımlılığı yüklemeleri bunun yerine ayrı skills.install istek yolunu kullanır.
Notlar:
| Bayrak/davranış | Açıklama |
|---|---|
search [query...] |
İsteğe bağlı sorgu; varsayılan ClawHub arama akışına göz atmak için belirtmeyin. |
search --limit <n> |
Döndürülen sonuçların sayısını sınırlar. |
install git:owner/repo[@ref] |
Bir Git Skill öğesi yükler. Dal başvuruları, git:owner/repo@feature/foo örneğinde olduğu gibi eğik çizgi içerebilir. |
install ./path/to/skill |
Kökünde SKILL.md bulunan yerel bir dizini yükler. |
install --as <slug> |
Git ve yerel dizin yüklemeleri için çıkarılan kısa adı geçersiz kılar. |
install --version <version> |
Yalnızca ClawHub Skill başvuruları için geçerlidir. |
install --force |
Aynı kısa ada sahip mevcut çalışma alanı Skill klasörünün üzerine yazar. |
install/update --force-install |
Bekleyen, GitHub destekli bir ClawHub Skill öğesini ClawHub taraması tamamlanmadan önce yükler. |
--global |
Paylaşılan, yönetilen Skills dizinini hedefler; --agent <id> ile birlikte kullanılamaz. |
--agent <id> |
Yapılandırılmış bir aracı çalışma alanını hedefler; geçerli çalışma dizininden yapılan çıkarımı geçersiz kılar. |
update @owner/<slug> |
İzlenen tek bir Skill öğesini günceller. Çalışma alanı yerine paylaşılan, yönetilen Skills dizinini hedeflemek için --global ekleyin. |
update --all |
Seçili çalışma alanındaki izlenen ClawHub yüklemelerini veya --global ile paylaşılan, yönetilen Skills dizinindekileri günceller. |
verify @owner/<slug> |
Varsayılan olarak ClawHub'ın clawhub.skill.verify.v1 JSON zarfını yazdırır. JSON zaten varsayılan olduğundan --json bayrağı yoktur. Skill zaten yüklüyse veya belirsizlik yoksa uyumluluk için yalın kısa adlar kabul edilir; sahip nitelemeli başvurular yayıncı belirsizliğini önler. |
verify kaynak kökeni |
ClawHub sunucu tarafından çözümlenen kaynak kökenini döndürdüğünde, doğrulama JSON'u ayrıca işleme sabitlenmiş bir openclaw.verifiedSourceUrl içerir. Kullanılamayan veya kaynağın kendisi tarafından beyan edilen kaynak URL'leri yalnızca ham köken zarfında kalır ve üst düzeye çıkarılmaz. |
verify sürüm seçici |
verify, yüklü ClawHub Skills öğeleri için .clawhub/origin.json dosyasını kullanır; böylece yüklü sürümü geldiği kayıt defterine göre doğrular. --version ve --tag, sürüm seçiciyi geçersiz kılar ancak köken meta verileri mevcutsa yüklü kayıt defterini korur. |
verify --card |
JSON yerine oluşturulan Skill Kartı Markdown'ını yazdırır. ClawHub ok: false veya decision: "fail" döndürdüğünde sıfır olmayan bir kodla çıkar; ClawHub politikası değişmediği sürece imzasız imzalar yalnızca bilgilendirme amaçlıdır. |
| Skill Kartı parmak izi | Yüklü ClawHub paketleri, oluşturulmuş bir skill-card.md içerebilir. OpenClaw, doğrulamayı bir ClawHub sunucu kararı olarak değerlendirir ve yalnızca oluşturulan kart paket parmak izini değiştirdi diye yüklü bir Skill öğesini reddetmez. |
check --agent <id> |
Seçilen aracının çalışma alanını denetler ve hazır Skills öğelerinden hangilerinin o aracının istemi veya komut yüzeyinde gerçekten görünür olduğunu bildirir. |
list |
Alt komut sağlanmadığında varsayılan eylemdir. |
list/info/check çıktısı |
İşlenmiş çıktı stdout'a gider. --json ile makine tarafından okunabilir yük, işlem hatları ve betikler için stdout'ta kalır. |
Topluluk ClawHub Skill yüklemeleri ve güncellemeleri, indirmeden önce güveni
denetler. Sürümlendirilmiş topluluk arşivi sürümleri, tam sürüme ait güven meta
verilerini kullanır. Çözümleyici destekli GitHub Skills öğeleri, sabitlenmiş bir
işleme dönmeden önce tarama ve zorunlu yükleme politikasını uygulamak için
ClawHub'ın yükleme çözümleyicisine dayanır; bekleyen, GitHub destekli bir Skill
öğesini bu tarama tamamlanmadan önce yüklemek için --force-install kullanın.
Kötü amaçlı veya engellenmiş topluluk sürümleri reddedilir. Riskli topluluk
sürümleri inceleme gerektirir; etkileşimsiz bir komutun bu incelemeden sonra
devam etmesi için --acknowledge-clawhub-risk gerekir. Resmî ClawHub Skill
yayıncıları ve OpenClaw ile paketlenmiş Skill kaynakları bu sürüm güveni istemini
atlar.
Skills Atölyesi
openclaw skills workshop, seçili çalışma alanındaki bekleyen Skill önerilerini
yönetir. Öneriler uygulanana kadar etkin Skills değildir. Öneri depolaması,
destek dosyası korumaları, Gateway yöntemleri ve onay politikası için
Skills Atölyesi bölümüne bakın.
openclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal ./PROPOSAL.mdopenclaw skills workshop propose-create \ --name "qa-check" \ --description "Repeatable QA checklist" \ --proposal-dir ./qa-check-proposalopenclaw skills workshop propose-update qa-check --proposal ./PROPOSAL.mdopenclaw skills workshop listopenclaw skills workshop inspect <proposal-id>openclaw skills workshop revise <proposal-id> --proposal ./PROPOSAL.mdopenclaw skills workshop apply <proposal-id>openclaw skills workshop reject <proposal-id> --reason "Duplicate"openclaw skills workshop quarantine <proposal-id> --reason "Needs security review"propose-create, propose-update ve revise, teklifin gerekçesini ve destekleyici
notları --proposal/--proposal-dir içeriğiyle birlikte kaydetmek için ayrıca
--goal <text> ve --evidence <text> seçeneklerini de kabul eder.
