Buradan başlayın
Çoğu aracı için yerleşik araç kategorileriyle başlayın, ardından ilkeyi yalnızca aracının daha az araç görmesi gerektiğinde veya açık ana makine erişimine ihtiyaç duyduğunda ayarlayın.| Şunu yapmanız gerekiyorsa… | Önce bunu kullanın | Sonra okuyun |
|---|---|---|
| Bir aracının mevcut yeteneklerle eyleme geçmesine izin vermek | Yerleşik araçlar | Araç kategorileri |
| Bir aracının neleri çağırabileceğini denetlemek | Araç ilkesi | Tools and custom providers |
| Bir aracıya iş akışı öğretmek | Skills | Skills, Skills oluşturma ve Skill Workshop |
| Yeni bir entegrasyon veya çalışma zamanı yüzeyi eklemek | Plugin’ler | Plugin’ler ve Plugin oluşturma |
| İşi daha sonra veya arka planda çalıştırmak | Otomasyon | Otomasyona genel bakış |
| Birden fazla aracıyı veya harness’ı koordine etmek | Alt aracılar | ACP aracıları ve Aracı gönderimi |
| Büyük bir OpenClaw araç kataloğunda arama yapmak | Araç Arama | Araç Arama |
Araçlar, Skills veya Plugin’ler arasında seçim yapın
Use a tool when the agent needs to act
Araç, aracının çağırabileceği yazılmış bir işlevdir; örneğin
exec, browser,
web_search, message veya image_generate. Aracını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ış işlev
tanımları olarak gönderilir.Model yalnızca etkin profilden, izin ver/reddet ilkesinden, sağlayıcı kısıtlamalarından,
sandbox durumundan, kanal izinlerinden ve Plugin kullanılabilirliğinden geçen araçları görür.Use a skill when the agent needs instructions
Skill, aracı istemine yüklenen bir
SKILL.md yönerge paketidir. Aracı zaten
ihtiyaç duyduğu araçlara sahipse ancak tekrarlanabilir bir iş akışına, inceleme rubriğine,
komut sırasına veya işletim kısıtına ihtiyaç duyuyorsa Skill kullanın.Skills bir çalışma alanında, paylaşılan Skill dizininde, yönetilen OpenClaw
Skill kökünde veya Plugin paketinde bulunabilir.Skills | Skill Workshop | Skills oluşturma | Skills yapılandırmasıUse a plugin when OpenClaw needs a new capability
Bir Plugin araçlar, Skills, kanallar, model sağlayıcıları, konuşma, gerçek zamanlı
ses, medya üretimi, web araması, web getirme, hook’lar ve diğer çalışma zamanı
yetenekleri ekleyebilir. Yetenek kod, kimlik bilgileri, yaşam döngüsü hook’ları,
manifest meta verileri veya kurulabilir paketleme içeriyorsa Plugin kullanın. Mevcut
Plugin’ler ClawHub, npm, git, yerel dizinler veya arşivlerden kurulabilir.Plugin’leri kurma ve yapılandırma | Plugin oluşturma | Plugin SDK
Yerleşik araç kategorileri
Tablo, yüzeyi tanıyabilmeniz için temsili araçları listeler. Tam ilke başvurusu değildir. Kesin gruplar, varsayılanlar ve izin ver/reddet semantiği için Tools and custom providers sayfasını kullanın.| Kategori | Aracı şunu yapmaya ihtiyaç duyduğunda kullanın… | Temsili araçlar | Sonra okuyun |
|---|---|---|---|
| Ç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 | Çalışma alanı dosyalarını okumak ve değiştirmek | read, write, edit, apply_patch | Patch 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 | Aracı gönderimi |
| Oturumlar ve aracılar | Oturumları incelemek, iş devretmek, başka bir çalıştırmayı yönlendirmek veya durum bildirmek | sessions_*, subagents, agents_list, session_status, goal | Hedef, Alt aracılar, Oturum aracı |
| Otomasyon | İşi 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 OpenClaw katalogları | Her şemayı modele göndermeden çok sayıda uygun aracı aramak ve çağırmak | tool_search_code, tool_search, tool_describe | Araç Arama |
Araç Arama deneysel bir OpenClaw aracı yüzeyidir. Codex harness çalıştırmaları,
tools.toolSearch yerine Codex’e özgü kod modu, yerel araç arama, ertelenmiş
dinamik araçlar ve iç içe araç çağrıları kullanır.Plugin tarafından sağlanan araçlar
Plugin’ler ek araçlar kaydedebilir. Plugin yazarları araçlarıapi.registerTool(...) ve manifestin contracts.tools alanı üzerinden bağlar; sözleşme
ayrıntıları için Plugin SDK ve Plugin manifest
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 Diffs
- Yalnızca JSON iş akışı adımları için LLM Görevi
- Sürdürülebilir onaylara sahip yazılmış iş akışları için Lobster
- Gürültülü
execvebasharaç çı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 denetimi ve A2UI işleme için Canvas
Erişimi ve onayları yapılandırın
Araç ilkesi model çağrısından önce uygulanır. İlke bir aracı kaldırırsa model, o aracın şemasını ilgili tur için almaz. Bir çalıştırma; global yapılandırma, aracı başına yapılandırma, kanal ilkesi, sağlayıcı kısıtlamaları, sandbox kuralları, kanal/çalışma zamanı ilkesi veya Plugin kullanılabilirliği nedeniyle araçları kaybedebilir.- Tools and custom providers, 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ı, ana makine komutu onay ilkesini belgeler.
- Yükseltilmiş exec, sandbox dışındaki denetimli yürütmeyi belgeler.
- Sandbox ile araç ilkesi ile yükseltilmiş erişim, dosya ve süreç erişimini hangi katmanın denetlediğini açıklar.
- Aracı başına sandbox ve araç kısıtlamaları, devredilen çalıştırmalar için aracıya özgü kısıtlamaları belgeler.
Yetenekleri genişletin
OpenClaw’ın yapmasını istediğiniz işe göre genişletme yolunu seçin:- Plugin’ler ile mevcut bir Plugin’i kurun veya yönetin.
- Plugin oluşturma ile yeni bir entegrasyon, sağlayıcı, kanal, araç veya hook oluşturun.
- Skills ve Skills oluşturma ile yeniden kullanılabilir aracı yönergeleri ekleyin veya ayarlayın.
- Uygulama sözleşmelerine ihtiyaç duyduğunuzda Plugin SDK ve Plugin manifest kullanın.
Eksik araçlarda sorun giderin
Model bir aracı göremiyor veya çağıramıyorsa geçerli tur için etkin ilkeyle başlayın:- Tools and custom providers içinde etkin profili,
tools.allowvetools.denydeğerlerini kontrol edin. - Tools and custom providers içindeki sağlayıcıya özgü kısıtlamaları kontrol edin ve seçilen model sağlayıcısının araç şeklini desteklediğini doğrulayın.
- Sandbox ile araç ilkesi ile yükseltilmiş erişim ve Yükseltilmiş exec ile kanal izinlerini, sandbox durumunu ve yükseltilmiş erişimi kontrol edin.
- Sahip olan Plugin’in Plugin’ler içinde kurulu ve etkin olup olmadığını kontrol edin.
- Devredilen çalıştırmalar için Aracı başına sandbox ve araç kısıtlamaları içindeki aracı başına kısıtlamaları kontrol edin.
- Büyük OpenClaw katalogları için çalıştırmanın doğrudan araç gösterimi 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
- Aracı modeli, oturumlar, bellek ve çok aracılı koordinasyon için Aracılar
- Kanonik araç ilkesi başvurusu için Tools and custom providers
- Plugin kurulumu ve yönetimi için Plugin’ler
- Plugin yazarı başvurusu için Plugin SDK
- Skill yükleme sırası, geçitleme ve yapılandırma için Skills
- Oluşturulan ve incelenen Skill oluşturma için Skill Workshop
- Kompakt OpenClaw araç kataloğu keşfi için Araç Arama