Overview
Genel Bakış
Bu sayfayı doğru Capabilities yüzeyini seçmek için kullanın. Tools çağrılabilir eylemlerdir, skills ajanlara nasıl çalışacaklarını öğretir ve plugins araçlar, sağlayıcılar, kanallar, hook'lar ve paketlenmiş skills gibi çalışma zamanı yetenekleri ekler.
Bu bir genel bakış ve yönlendirme sayfasıdır. Kapsamlı araç politikası, varsayılanlar, grup üyeliği, sağlayıcı kısıtlamaları ve yapılandırma alanları için Araçlar ve özel sağlayıcılar sayfasını kullanın.
Buradan başlayın
Çoğu ajan için yerleşik araç kategorileriyle başlayın, ardından politikayı yalnızca ajanın daha az araç görmesi gerektiğinde veya açık host erişimine ihtiyacı olduğunda ayarlayın.
| Şunu yapmanız gerekiyorsa... | Önce bunu kullanın | Ardından okuyun |
|---|---|---|
| Bir ajanın mevcut yeteneklerle işlem yapmasını sağlamak | Yerleşik araçlar | Araç kategorileri |
| Bir ajanın neyi çağırabileceğini kontrol etmek | Araç politikası | Araçlar ve özel sağlayıcılar |
| Bir ajana bir iş akışı öğretmek | Skills | Skills ve Skills oluşturma |
| Yeni bir entegrasyon veya çalışma zamanı yüzeyi eklemek | Plugins | Plugins ve Plugins oluşturma |
| İşi daha sonra veya arka planda çalıştırmak | Otomasyon | Otomasyona genel bakış |
| Birden fazla ajanı veya harness'ı koordine etmek | Alt ajanlar | ACP ajanları ve Ajan gönderimi |
| Büyük bir PI araç kataloğunda arama yapmak | Araç Arama | Araç Arama |
Araçları, Skills'i veya plugins'i seçin
Ajanın işlem yapması gerektiğinde bir araç kullanın
Araç, ajanın çağırabileceği türlenmiş bir fonksiyondur; örneğin exec,
browser, web_search, message veya image_generate. Ajanın veri
okuması, dosyaları değiştirmesi, mesaj göndermesi, bir sağlayıcıyı çağırması
veya başka bir sistemi işletmesi gerektiğinde araçları kullanın. Görünür
araçlar modele yapılandırılmış fonksiyon tanımları olarak gönderilir.
Model yalnızca etkin profil, izin ver/reddet politikası, sağlayıcı kısıtlamaları, sandbox durumu, kanal izinleri ve plugin kullanılabilirliği sonrasında kalan araçları görür.
Ajanın yönergelere ihtiyacı olduğunda bir skill kullanın
Skill, ajan istemine yüklenen bir SKILL.md yönerge paketidir. Ajan zaten
ihtiyaç duyduğu araçlara sahipse ancak tekrarlanabilir bir iş akışına,
inceleme rubriğine, komut dizisine veya çalışma kısıtına ihtiyaç duyuyorsa
skill kullanın.
Skills bir workspace'te, paylaşılan skill dizininde, yönetilen OpenClaw skill kökünde veya plugin paketinde bulunabilir.
OpenClaw'ın yeni bir yeteneğe ihtiyacı olduğunda bir Plugin kullanın
Bir Plugin araçlar, Skills, kanallar, model sağlayıcıları, konuşma, realtime ses, medya üretimi, web araması, web getirme, hook'lar ve diğer çalışma zamanı yetenekleri ekleyebilir. Yeteneğin kodu, kimlik bilgileri, yaşam döngüsü hook'ları, manifest meta verileri veya kurulabilir paketi olduğunda Plugin kullanın. Mevcut plugins ClawHub, npm, git, yerel dizinler veya arşivlerden kurulabilir.
Plugins'i kurma ve yapılandırma | Plugins oluşturma | Plugin SDK
Yerleşik araç kategorileri
Tablo, yüzeyi tanıyabilmeniz için temsilî araçları listeler. Tam politika başvurusu değildir. Kesin gruplar, varsayılanlar ve izin ver/reddet anlamları için Araçlar ve özel sağlayıcılar sayfasını kullanın.
| Kategori | Ajanın şunu yapması gerektiğinde kullanın... | Temsilî araçlar | Sonraki okuma |
|---|---|---|---|
| Çalışma zamanı | Komut çalıştırmak, süreçleri yönetmek veya sağlayıcı destekli Python analizi kullanmak | exec, process, code_execution |
Exec, Kod yürütme |
| Dosyalar | Workspace dosyalarını okumak ve değiştirmek | read, write, edit, apply_patch |
Yama uygula |
| Web | Web'de arama yapmak, X gönderilerinde arama yapmak veya okunabilir sayfa içeriği getirmek | web_search, x_search, web_fetch |
Web araçları, Web getirme |
| Tarayıcı | Bir tarayıcı oturumunu işletmek | browser |
Tarayıcı |
| Mesajlaşma ve kanallar | Yanıtlar veya kanal eylemleri göndermek | message |
Ajan gönderimi |
| Oturumlar ve ajanlar | Oturumları incelemek, işi devretmek, başka bir çalışmayı yönlendirmek veya durum bildirmek | sessions_*, subagents, agents_list, session_status |
Alt ajanlar, Oturum aracı |
| Otomasyon | İş zamanlamak veya arka plan olaylarına yanıt vermek | cron, heartbeat_respond |
Otomasyon |
| Gateway ve düğümler | Gateway durumunu veya eşleştirilmiş hedef cihazları incelemek | gateway, nodes |
Gateway yapılandırması, Düğümler |
| Medya | Medyayı analiz etmek, üretmek veya seslendirmek | image, image_generate, music_generate, video_generate, tts |
Medyaya genel bakış |
| Büyük PI katalogları | Her şemayı modele göndermeden çok sayıda uygun aracı aramak ve çağırmak | tool_search_code, tool_search, tool_describe |
Araç Arama |
Plugin tarafından sağlanan araçlar
Plugins ek araçlar kaydedebilir. Plugin yazarları araçları
api.registerTool(...) ve manifest'in contracts.tools alanı üzerinden bağlar;
sözleşme ayrıntıları için Plugin SDK ve
Plugin manifesti sayfalarını kullanın.
Yaygın Plugin tarafından sağlanan araçlar şunları içerir:
- Dosya ve markdown farklarını işlemek için Farklar
- Yalnızca JSON iş akışı adımları için LLM Görevi
- Sürdürülebilir onaylarla türlenmiş iş akışları için Lobster
- Gürültülü
execvebasharacı çıktısını sıkıştırmak için Tokenjuice - Her şemayı isteme koymadan büyük araç kataloglarını keşfetmek ve çağırmak için Araç Arama
- Düğüm Canvas kontrolü ve A2UI işleme için Canvas
Erişimi ve onayları yapılandırın
Araç politikası model çağrısından önce uygulanır. Politika bir aracı kaldırırsa model o turun için o aracın şemasını almaz. Bir çalışma, genel yapılandırma, ajan başına yapılandırma, kanal politikası, sağlayıcı kısıtlamaları, sandbox kuralları, yalnızca sahip geçidi veya plugin kullanılabilirliği nedeniyle araçları kaybedebilir.
- Araçlar ve özel sağlayıcılar araç profillerini, izin ver/reddet listelerini, sağlayıcıya özgü kısıtlamaları, döngü algılamayı ve sağlayıcı destekli araç ayarlarını belgeler.
- Exec onayları host komutu onay politikasını belgeler.
- Yükseltilmiş exec sandbox dışındaki kontrollü yürütmeyi belgeler.
- Sandbox ve araç politikası ve yükseltilmiş hangi katmanın dosya ve süreç erişimini kontrol ettiğini açıklar.
- Ajan başına sandbox ve araç kısıtlamaları devredilen çalışmalar için ajana özgü kısıtlamaları belgeler.
Yetenekleri genişletin
OpenClaw'ın yapmasını istediğiniz işe göre genişletme yolunu seçin:
- Mevcut bir Plugin'i Plugins ile kurun veya yönetin.
- Yeni bir entegrasyonu, sağlayıcıyı, kanalı, aracı veya hook'u Plugins oluşturma ile oluşturun.
- Yeniden kullanılabilir ajan yönergelerini Skills ve Skills oluşturma ile ekleyin veya ayarlayın.
- İş akışı plugin dağıtımlı bir skill paketine ait olduğunda yeniden kullanılabilir iş akışı materyalini Skill atölyesi ile paketleyin.
- Uygulama sözleşmelerine ihtiyacınız olduğunda Plugin SDK ve Plugin manifesti sayfalarını kullanın.
Eksik araçlarda sorun giderme
Model bir aracı göremiyor veya çağıramıyorsa, geçerli tur için etkin politikayla başlayın:
- Araçlar ve özel sağlayıcılar içindeki etkin profili,
tools.allowvetools.denyayarlarını kontrol edin. - Araçlar ve özel sağlayıcılar içindeki sağlayıcıya özgü kısıtlamaları kontrol edin ve seçili model sağlayıcısının araç şeklini desteklediğini doğrulayın.
- Sandbox ve araç politikası ve yükseltilmiş ve Yükseltilmiş exec ile kanal izinlerini, sandbox durumunu ve yükseltilmiş erişimi kontrol edin.
- Sahip olan Plugin'in Plugins içinde kurulu ve etkin olup olmadığını kontrol edin.
- Devredilen çalışmalar için Ajan başına sandbox ve araç kısıtlamaları içindeki ajan başına kısıtlamaları kontrol edin.
- Büyük PI katalogları için çalışmanın doğrudan araç gösterimini mi yoksa Araç Arama mı kullandığını doğrulayın.
İlgili
- Cron, görevler, Heartbeat, taahhütler, hook'lar, kalıcı emirler ve Task Flow için Otomasyon
- Ajan modeli, oturumlar, bellek ve çok ajanlı koordinasyon için Ajanlar
- Kanonik araç politikası başvurusu için Araçlar ve özel sağlayıcılar
- Plugin kurulumu ve yönetimi için Plugins
- Plugin yazarı başvurusu için Plugin SDK
- Skill yükleme sırası, geçitleri ve yapılandırması için Skills
- Kompakt PI araç kataloğu keşfi için Araç Arama