Ana içeriğe atla

​
Araçlar ve Plugin’ler

Agent’ın metin üretmenin ötesinde yaptığı her şey araçlar aracılığıyla olur. Araçlar, agent’ı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 plugin’ler

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

Araçlar, agent’ın çağırdığı şeylerdir

Araç, agent’ın çağırabildiği tiplenmiş bir işlevdir (ör. exec, browser, web_search, message). OpenClaw bir dizi yerleşik araç ile gelir ve plugin’ler ek araçlar kaydedebilir.Agent, araçları model API’sine gönderilen yapılandırılmış işlev tanımları olarak görür.
2

Skills, agent’a ne zaman ve nasıl kullanılacağını öğretir

Skill, sistem komutuna enjekte edilen bir markdown dosyasıdır (SKILL.md). Skills, agent’a araçları etkili şekilde kullanması için bağlam, kısıtlar ve adım adım rehberlik sağlar. Skills çalışma alanınızda, paylaşılan klasörlerde bulunabilir veya plugin’lerin içinde gelebilir.Skills başvurusu | Skill oluşturma
3

Plugin’ler her şeyi birlikte paketler

Plugin, herhangi bir yetenek kombinasyonunu kaydedebilen bir pakettir: channels, model provider’lar, araçlar, Skills, konuşma, gerçek zamanlı transcription, gerçek zamanlı voice, medya anlama, görsel oluşturma, video oluşturma, web fetch, web search ve daha fazlası. Bazı plugin’ler core’dur (OpenClaw ile birlikte gelir), bazıları ise external’dır (topluluk tarafından npm üzerinde yayımlanır).Plugin’leri kurun ve yapılandırın | Kendinizinkini oluşturun

​
Yerleşik araçlar

Bu araçlar OpenClaw ile birlikte gelir ve herhangi bir plugin kurmadan kullanılabilir:
AraçNe yaparSayfa
exec / processShell komutları çalıştırır, arka plan süreçlerini yönetirExec
code_executionSandbox içinde uzak Python analizi çalıştırırCode Execution
browserBir Chromium tarayıcısını denetler (gezinme, tıklama, ekran görüntüsü)Browser
web_search / x_search / web_fetchWeb’de arama yapar, X gönderilerini arar, sayfa içeriğini getirirWeb
read / write / editÇalışma alanında dosya G/Ç
apply_patchÇok parçalı dosya yamalarıApply Patch
messageTüm channels üzerinden mesaj gönderirAgent Send
canvasNode Canvas’ı sürer (sunum, değerlendirme, snapshot)
nodesEşleştirilmiş cihazları keşfeder ve hedefler
cron / gatewayZamanlanmış işleri yönetir; gateway’i inceler, düzeltir, yeniden başlatır veya günceller
image / image_generateGörselleri analiz eder veya oluştururImage Generation
music_generateMüzik parçaları oluştururMusic Generation
video_generateVideolar oluştururVideo Generation
ttsTek seferlik metinden konuşmaya dönüştürmeTTS
sessions_* / subagents / agents_listOturum yönetimi, durum ve alt agent orkestrasyonuSub-agents
session_statusHafif /status tarzı geri okuma ve oturum model geçersiz kılmasıSession Tools
Görsel işleri için analizde image, oluşturmada veya düzenlemede image_generate kullanın. openai/*, google/*, fal/* veya varsayılan olmayan başka bir görsel provider’ı hedefliyorsanız, önce o provider’ın auth/API anahtarını yapılandırın. Müzik işleri için music_generate kullanın. google/*, minimax/* veya varsayılan olmayan başka bir müzik provider’ı hedefliyorsanız, önce o provider’ın auth/API anahtarını yapılandırın. Video işleri için video_generate kullanın. qwen/* veya varsayılan olmayan başka bir video provider’ı hedefliyorsanız, önce o provider’ın auth/API anahtarını yapılandırın. İş akışı odaklı ses üretimi için, ComfyUI gibi bir plugin bunu kaydettiğinde music_generate kullanın. Bu, metinden konuşmaya olan tts’den ayrıdır. session_status, sessions grubundaki hafif durum/geri okuma aracıdır. Geçerli oturum hakkında /status tarzı soruları yanıtlar ve isteğe bağlı olarak oturum başına model geçersiz kılması ayarlayabilir; model=default bu geçersiz kılmayı temizler. /status gibi, en son transcript kullanım girdisinden seyrek token/cache sayaçlarını ve etkin çalışma zamanı model etiketini geriye dönük 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ı config alt ağacı için config.schema.lookup
  • Geçerli config snapshot’ı + hash için config.get
  • Yeniden başlatmalı kısmi config güncellemeleri için config.patch
  • Yalnızca tam config değiştirme için config.apply
  • Açık self-update + yeniden başlatma için update.run
Kısmi değişikliklerde önce config.schema.lookup, sonra config.patch tercih edin. config.apply yalnızca tüm config’i bilerek değiştirdiğinizde 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.

​
Plugin tarafından sağlanan araçlar

Plugin’ler ek araçlar kaydedebilir. Bazı örnekler:
  • Lobster — devam ettirilebilir onaylarla tiplenmiş iş akışı çalışma zamanı
  • LLM Task — yapılandırılmış çıktı için yalnızca JSON LLM adımı
  • Music Generation — iş akışı destekli provider’larla paylaşılan music_generate aracı
  • Diffs — diff görüntüleyici ve oluşturucu
  • OpenProse — markdown-first iş akışı orkestrasyonu

​
Araç yapılandırması

​
İzin ve engelleme listeleri

Agent’ın hangi araçları çağırabileceğini config içindeki tools.allow / tools.deny ile denetleyin. 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. Agent başına geçersiz kılma: agents.list[].tools.profile.
ProfilNeleri içerir
fullKısıtlama yok (ayarlanmamış olmasıyla aynı)
codinggroup:fs, group:runtime, group:web, group:sessions, group:memory, cron, image, image_generate, music_generate, video_generate
messaginggroup:messaging, sessions_list, sessions_history, sessions_send, session_status
minimalYalnızca session_status

​
Araç grupları

İzin/engelleme listelerinde group:* kısa yolları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, music_generate, video_generate, tts
group:openclawTüm yerleşik OpenClaw araçları (plugin araçları hariç)
sessions_history, sınırlı ve güvenlik filtreli bir geri çağırma görünümü döndürür.
Thinking etiketlerini, <relevant-memories> iskeletini, düz metin tool-call XML yüklerini (şunlar dahil: <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> ve kesilmiş tool-call blokları), seviyesi düşürülmüş tool-call iskeletini, sızmış ASCII/tam genişlikli model kontrol token’larını ve assistant metnindeki bozuk MiniMax tool-call XML’ini ayıklar; ardından ham transcript dökümü gibi davranmak yerine redaksiyon/kısaltma ve olası büyük satır yer tutucuları uygular.

​
Provider’a özgü kısıtlamalar

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