Ana içeriğe atla

​
Araçlar ve Eklentiler

Ajanın metin üretmenin ötesinde yaptığı her şey araçlar aracılığıyla gerçekleşir. Araçlar, ajanın dosya okumasını, komut çalıştırmasını, web’de gezinmesini, mesaj göndermesini ve cihazlarla etkileşime girmesini sağlar.

​
Araçlar, Skills ve eklentiler

OpenClaw birlikte çalışan üç katmana sahiptir:
1

Araçlar, ajanın çağırdığı şeylerdir

Bir araç, ajanın çağırabileceği türlendirilmiş bir işlevdir (ör. exec, browser, web_search, message). OpenClaw bir dizi yerleşik araç ile gelir ve eklentiler ek araçlar kaydedebilir.Ajan, araçları model API’sine gönderilen yapılandırılmış işlev tanımları olarak görür.
2

Skills ajana ne zaman ve nasıl olduğunu öğretir

Bir Skill, sistem istemine eklenen bir markdown dosyasıdır (SKILL.md). Skills, ajana araçları etkili biçimde kullanması için bağlam, kısıtlar ve adım adım yönlendirme sağlar. Skills çalışma alanınızda, paylaşılan klasörlerde bulunur veya eklentilerin içinde gelir.Skills başvurusu | Skill oluşturma
3

Eklentiler her şeyi birlikte paketler

Bir eklenti, yeteneklerin herhangi bir birleşimini kaydedebilen bir pakettir: kanallar, model sağlayıcıları, araçlar, Skills, konuşma, gerçek zamanlı transkripsiyon, gerçek zamanlı ses, medya anlama, görsel üretimi, video üretimi, web getirme, web arama ve daha fazlası. Bazı eklentiler çekirdektir (OpenClaw ile birlikte gelir), diğerleri haricidir (topluluk tarafından npm’de yayımlanır).Eklenti kurma ve yapılandırma | Kendinizinkini oluşturun

​
Yerleşik araçlar

Bu araçlar OpenClaw ile birlikte gelir ve herhangi bir eklenti kurmadan kullanılabilir:
AraçNe yaparSayfa
exec / processKabuk komutlarını çalıştırır, arka plan süreçlerini yönetirExec
code_executionYalıtılmış uzak Python analizi çalıştırırCode Execution
browserBir Chromium tarayıcısını kontrol eder (gezinti, tıklama, ekran görüntüsü)Browser
web_search / x_search / web_fetchWeb’de arama yapar, X gönderilerinde arama yapar, sayfa içeriği alırWeb
read / write / editÇalışma alanında dosya G/Ç
apply_patchÇok hunk’lı dosya patch’leriApply Patch
messageTüm kanallar üzerinden mesaj gönderirAgent Send
canvasDüğüm Canvas’ı sürer (sunum, eval, snapshot)
nodesEşleştirilmiş cihazları keşfeder ve hedefler
cron / gatewayZamanlanmış işleri yönetir; gateway’i inceler, patch’ler, yeniden başlatır veya günceller
image / image_generateGörselleri analiz eder veya oluşturur
ttsTek seferlik metinden konuşmaya dönüştürmeTTS
sessions_* / subagents / agents_listOturum yönetimi, durum ve alt ajan orkestrasyonuSub-agents
session_statusHafif /status tarzı geri okuma ve oturum modeli geçersiz kılmaSession Tools
Görsel çalışmaları için analiz amacıyla image, oluşturma veya düzenleme amacıyla image_generate kullanın. openai/*, google/*, fal/* veya varsayılan olmayan başka bir görsel sağlayıcısını hedefliyorsanız önce o sağlayıcının auth/API anahtarını yapılandırın. session_status, oturumlar grubundaki hafif durum/geri okuma aracıdır. Geçerli oturumla ilgili /status tarzı soruları yanıtlar ve isteğe bağlı olarak oturum başına model geçersiz kılma ayarlayabilir; model=default bu geçersiz kılmayı temizler. /status gibi, seyrek belirteç/önbellek sayaçlarını ve etkin çalışma zamanı model etiketini en son döküm kullanım girdisinden doldurabilir. gateway, gateway işlemleri için yalnızca sahip tarafından kullanılabilen çalışma zamanı aracıdır:
  • düzenlemelerden önce tek bir yol kapsamlı yapılandırma alt ağacı için config.schema.lookup
  • geçerli yapılandırma anlık görüntüsü + hash için config.get
  • yeniden başlatmalı kısmi yapılandırma güncellemeleri için config.patch
  • yalnızca tam yapılandırma değiştirme için config.apply
  • açık self-update + yeniden başlatma için update.run
Kısmi değişiklikler için önce config.schema.lookup, sonra config.patch tercih edin. config.apply yalnızca tüm yapılandırmayı bilerek değiştirirken kullanılmalıdır. Araç ayrıca tools.exec.ask veya tools.exec.security değerlerini değiştirmeyi reddeder; eski tools.bash.* takma adları aynı korumalı exec yollarına normalize edilir.

​
Eklenti tarafından sağlanan araçlar

Eklentiler ek araçlar kaydedebilir. Bazı örnekler:
  • Lobster — devam ettirilebilir onaylarla türlendirilmiş iş akışı çalışma zamanı
  • LLM Task — yapılandırılmış çıktı için yalnızca JSON LLM adımı
  • Diffs — diff görüntüleyici ve oluşturucu
  • OpenProse — markdown öncelikli iş akışı orkestrasyonu

​
Araç yapılandırması

​
İzin ve engelleme listeleri

Ajanın hangi araçları çağırabileceğini yapılandırmada tools.allow / tools.deny ile kontrol edin. Engelleme her zaman izne üstün gelir. 
{
  tools: {
    allow: ["group:fs", "browser", "web_search"],
    deny: ["exec"],
  },
}

​
Araç profilleri

tools.profile, allow/deny uygulanmadan önce temel bir izin listesi ayarlar. Ajan başına geçersiz kılma: agents.list[].tools.profile.
Profilİçerdikleri
fullKısıtlama yoktur (ayarlanmamışla aynıdır)
codinggroup:fs, group:runtime, group:web, group:sessions, group:memory, cron, image, image_generate
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
minimalYalnızca session_status

​
Araç grupları

İzin/engelleme listelerinde group:* kısayollarını kullanın:
GrupAraçlar
group:runtimeexec, process, code_execution (bash, exec için bir takma ad olarak kabul edilir)
group:fsread, write, edit, apply_patch
group:sessionssessions_list, sessions_history, sessions_send, sessions_spawn, sessions_yield, subagents, session_status
group:memorymemory_search, memory_get
group:webweb_search, x_search, web_fetch
group:uibrowser, canvas
group:automationcron, gateway
group:messagingmessage
group:nodesnodes
group:agentsagents_list
group:mediaimage, image_generate, tts
group:openclawTüm yerleşik OpenClaw araçları (eklenti araçları hariç)
sessions_history, sınırlı ve güvenlik filtresinden geçmiş bir geri çağırma görünümü döndürür. Bu görünüm, thinking etiketlerini, <relevant-memories> iskeletini, düz metin araç çağrısı XML yüklerini (şunlar dahil: <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> ve kırpılmış araç çağrısı blokları), indirgenmiş araç çağrısı iskeletini, sızmış ASCII/tam genişlikli model kontrol token’larını ve bozuk MiniMax araç çağrısı XML’ini asistan metninden çıkarır; ardından ham bir döküm dökümü gibi davranmak yerine redaksiyon/kırpma ve olası aşırı büyük satır yer tutucuları uygular.

​
Sağlayıcıya özgü kısıtlamalar

Küresel varsayılanları değiştirmeden belirli sağlayıcılar için araçları kısıtlamak üzere tools.byProvider kullanın: 
{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}