​

Araçlar (OpenClaw)

​

Araçları devre dışı bırakma

{
  tools: { deny: ["browser"] },
}

• 27. Eşleştirme büyük/küçük harfe duyarsızdır.
• * joker karakterleri desteklenir ("*" tüm araçlar anlamına gelir).
• tools.allow yalnızca bilinmeyen veya yüklenmemiş eklenti araç adlarına atıfta bulunuyorsa, OpenClaw bir uyarı kaydeder ve çekirdek araçlar kullanılabilir kalsın diye izin listesini yok sayar.

​

Araç profilleri (temel izin listesi)

• minimal: yalnızca session_status
• coding: group:fs, group:runtime, group:sessions, group:memory, image
• messaging: group:messaging, sessions_list, sessions_history, sessions_send, session_status
• full: kısıtlama yok (ayarlanmamış ile aynı)

{
  tools: {
    profile: "messaging",
    allow: ["slack", "discord"],
  },
}

{
  tools: {
    profile: "coding",
    deny: ["group:runtime"],
  },
}

{
  tools: { profile: "coding" },
  agents: {
    list: [
      {
        id: "support",
        tools: { profile: "messaging", allow: ["slack"] },
      },
    ],
  },
}

​

Sağlayıcıya özgü araç politikası

{
  tools: {
    profile: "coding",
    byProvider: {
      "google-antigravity": { profile: "minimal" },
    },
  },
}

{
  tools: {
    allow: ["group:fs", "group:runtime", "sessions_list"],
    byProvider: {
      "openai/gpt-5.2": { allow: ["group:fs", "sessions_list"] },
    },
  },
}

{
  agents: {
    list: [
      {
        id: "support",
        tools: {
          byProvider: {
            "google-antigravity": { allow: ["message", "sessions_list"] },
          },
        },
      },
    ],
  },
}

​

Araç grupları (kısayollar)

• group:runtime: exec, bash, process
• group:fs: read, write, edit, apply_patch
• group:sessions: sessions_list, sessions_history, sessions_send, sessions_spawn, session_status
• group:memory: memory_search, memory_get
• group:web: web_search, web_fetch
• group:ui: browser, canvas
• group:automation: cron, gateway
• group:messaging: message
• group:nodes: nodes
• group:openclaw: tüm yerleşik OpenClaw araçları (sağlayıcı eklentileri hariç)

{
  tools: {
    allow: ["group:fs", "browser"],
  },
}

​

Eklentiler + araçlar

• Lobster: devam ettirilebilir onaylara sahip tipli iş akışı çalışma zamanı (gateway ana makinesinde Lobster CLI gerektirir).
• LLM Task: yapılandırılmış iş akışı çıktısı için yalnızca JSON LLM adımı (isteğe bağlı şema doğrulama).

​

28. Araç envanteri

​

apply_patch

​

exec

• command (gerekli)
• yieldMs (zaman aşımından sonra otomatik arka plan, varsayılan 10000)
• background (hemen arka plan)
• timeout (saniye; aşılırsa süreci öldürür, varsayılan 1800)
• elevated (bool; yükseltilmiş mod etkin/izinliyse ana makinede çalıştır; yalnızca ajan sandbox içindeyken davranışı değiştirir)
• host (sandbox | gateway | node)
• security (deny | allowlist | full)
• ask (off | on-miss | always)
• node (host=node için düğüm kimliği/adı)
• Gerçek bir TTY mi gerekiyor? pty: true ayarlayın.

• Arka planda çalıştırıldığında sessionId içeren status: "running" döndürür.
• Arka plan oturumlarını yoklamak/günlüğe almak/yazmak/öldürmek/temizlemek için process kullanın.
• process izinli değilse, exec eşzamanlı çalışır ve yieldMs/background’u yok sayar.
• elevated, tools.elevated ve herhangi bir agents.list[].tools.elevated geçersiz kılmasına bağlıdır (ikisi de izin vermelidir) ve host=gateway + security=full için bir takma addır.
• elevated yalnızca ajan sandbox içindeyken davranışı değiştirir (aksi halde etkisizdir).
• host=node, bir macOS yardımcı uygulamasını veya başsız bir düğüm ana makinesini (openclaw node run) hedefleyebilir.
• gateway/düğüm onayları ve izin listeleri: Exec approvals.

​

process

• list, poll, log, write, kill, clear, remove

• poll, tamamlandığında yeni çıktı ve çıkış durumunu döndürür.
• log, satır bazlı offset/limit’u destekler (offset’i atlayarak son N satırı alın).
• 29. process ajan başına kapsamlıdır; diğer ajanlardan gelen oturumlar görünmez.

​

web_search

• query (gerekli)
• count (1–10; varsayılan tools.web.search.maxResults’dan)

• Brave API anahtarı gerektirir (önerilen: openclaw configure --section web veya BRAVE_API_KEY ayarlayın).
• tools.web.search.enabled üzerinden etkinleştirin.
• Yanıtlar önbelleğe alınır (varsayılan 15 dk).
• Kurulum için Web tools bölümüne bakın.

​

web_fetch

• url (gerekli)
• extractMode (markdown | text)
• maxChars (uzun sayfaları kısalt)

• tools.web.fetch.enabled üzerinden etkinleştirin.
• maxChars, tools.web.fetch.maxCharsCap ile sınırlandırılır (varsayılan 50000).
• Yanıtlar önbelleğe alınır (varsayılan 15 dk).
• JS ağırlıklı siteler için tarayıcı aracını tercih edin.
• Kurulum için Web tools bölümüne bakın.
• İsteğe bağlı anti‑bot yedeği için Firecrawl bölümüne bakın.

​

browser

• status, start, stop, tabs, open, focus, close
• snapshot (aria/ai)
• screenshot (görüntü bloğu + MEDIA:<path> döndürür)
• act (UI eylemleri: click/type/press/hover/drag/select/fill/resize/wait/evaluate)
• navigate, console, pdf, upload, dialog

• profiles — durumla birlikte tüm tarayıcı profillerini listeler
• create-profile — otomatik port tahsisiyle yeni profil oluşturur (veya cdpUrl)
• delete-profile — tarayıcıyı durdurur, kullanıcı verisini siler, yapılandırmadan kaldırır (yalnızca yerel)
• reset-profile — profilin portundaki yetim süreci öldürür (yalnızca yerel)

• profile (isteğe bağlı; varsayılan browser.defaultProfile)
• target (sandbox | host | node)
• node (isteğe bağlı; belirli bir düğüm kimliği/adı seçer) Notlar:
• browser.enabled=true gerektirir (varsayılan true; devre dışı bırakmak için false ayarlayın).
• Tüm eylemler, çoklu örnek desteği için isteğe bağlı profile parametresini kabul eder.
• profile atlanırsa, browser.defaultProfile kullanılır (varsayılan “chrome”).
• Profil adları: yalnızca küçük harf alfanümerik + tire (en fazla 64 karakter).
• Port aralığı: 18800-18899 (yaklaşık 100 profil maks.).
• Uzak profiller yalnızca bağlanabilir (başlat/durdur/sıfırla yok).
• Tarayıcı yetenekli bir düğüm bağlıysa, araç otomatik yönlendirebilir ( target ile sabitlemezseniz).
• Playwright yüklüyken snapshot varsayılan olarak ai’dır; erişilebilirlik ağacı için aria kullanın.
• snapshot, rol‑anlık görüntü seçeneklerini (interactive, compact, depth, selector) de destekler ve e12 gibi referanslar döndürür.
• act, snapshot’dan ref gerektirir (AI anlık görüntülerinden sayısal 12 veya rol anlık görüntülerinden e12); nadir CSS seçici ihtiyaçları için evaluate kullanın.
• Varsayılan olarak act → wait’dan kaçının; yalnızca istisnai durumlarda kullanın (beklenecek güvenilir bir UI durumu yoksa).
• upload, hazırlanma sonrası otomatik tıklama için isteğe bağlı bir ref geçebilir.
• upload, <input type="file">’yi doğrudan ayarlamak için inputRef (aria ref) veya element (CSS seçici) de destekler.

​

canvas

• present, hide, navigate, eval
• snapshot (görüntü bloğu + MEDIA:<path> döndürür)
• a2ui_push, a2ui_reset

• Altta gateway node.invoke kullanır.
• node sağlanmazsa, araç bir varsayılan seçer (tek bağlı düğüm veya yerel mac düğümü).
• A2UI yalnızca v0.8’dir (createSurface yok); CLI, satır hatalarıyla v0.9 JSONL’yi reddeder.
• Hızlı kontrol: openclaw nodes canvas a2ui push --node <id> --text "Hello from A2UI".

​

nodes

• status, describe
• pending, approve, reject (eşleştirme)
• notify (macOS system.notify)
• run (macOS system.run)
• camera_snap, camera_clip, screen_record
• location_get

• Kamera/ekran komutları, düğüm uygulamasının ön planda olmasını gerektirir.
• Görseller, görüntü blokları + MEDIA:<path> döndürür.
• Videolar FILE:<path> (mp4) döndürür.
• Konum, JSON yükü (lat/lon/accuracy/timestamp) döndürür.
• run parametreleri: command argv dizisi; isteğe bağlı cwd, env (KEY=VAL), commandTimeoutMs, invokeTimeoutMs, needsScreenRecording.

{
  "action": "run",
  "node": "office-mac",
  "command": ["echo", "Hello"],
  "env": ["FOO=bar"],
  "commandTimeoutMs": 12000,
  "invokeTimeoutMs": 45000,
  "needsScreenRecording": false
}

​

image

• image (gerekli yol veya URL)
• prompt (isteğe bağlı; varsayılan “Görüntüyü tanımla.”)
• model (isteğe bağlı geçersiz kılma)
• maxBytesMb (isteğe bağlı boyut üst sınırı)

• Yalnızca agents.defaults.imageModel yapılandırıldığında (birincil veya yedekler) ya da varsayılan modeliniz + yapılandırılmış kimlik doğrulama üzerinden örtük bir görüntü modeli çıkarılabildiğinde kullanılabilir (en iyi çaba eşleştirme).
• Görüntü modelini doğrudan kullanır (ana sohbet modelinden bağımsız).

​

message

• send (metin + isteğe bağlı medya; MS Teams ayrıca Adaptive Cards için card’ü destekler)
• poll (WhatsApp/Discord/MS Teams anketleri)
• react / reactions / read / edit / delete
• pin / unpin / list-pins
• permissions
• thread-create / thread-list / thread-reply
• search
• sticker
• member-info / role-info
• emoji-list / emoji-upload / sticker-upload
• role-add / role-remove
• channel-info / channel-list
• voice-status
• event-list / event-create
• timeout / kick / ban

• send, WhatsApp’ı Gateway üzerinden yönlendirir; diğer kanallar doğrudan gider.
• poll, WhatsApp ve MS Teams için Gateway’i kullanır; Discord anketleri doğrudan gider.
• Bir mesaj aracı çağrısı etkin bir sohbet oturumuna bağlıyken, gönderimler bağlam sızıntılarını önlemek için o oturumun hedefiyle sınırlandırılır.

​

cron

• status, list
• add, update, remove, run, runs
• wake (sistem olayı kuyruğa al + isteğe bağlı anında heartbeat)

• add, tam bir cron işi nesnesi bekler (cron.add RPC ile aynı şema).
• update, { jobId, patch } kullanır (uyumluluk için id kabul edilir).

​

gateway

• restart (yetkilendirir + işlem içi yeniden başlatma için SIGUSR1 gönderir; yerinde openclaw gateway yeniden başlatma)
• config.get / config.schema
• config.apply (doğrula + yapılandırmayı yaz + yeniden başlat + uyandır)
• config.patch (kısmi güncellemeyi birleştir + yeniden başlat + uyandır)
• update.run (güncellemeyi çalıştır + yeniden başlat + uyandır)

• Devam eden bir yanıtı bölmemek için delayMs (varsayılan 2000) kullanın.
• restart varsayılan olarak devre dışıdır; commands.restart: true ile etkinleştirin.

​

sessions_list / sessions_history / sessions_send / sessions_spawn / session_status

• sessions_list: kinds?, limit?, activeMinutes?, messageLimit? (0 = yok)
• sessions_history: sessionKey (veya sessionId), limit?, includeTools?
• sessions_send: sessionKey (veya sessionId), message, timeoutSeconds? (0 = fire‑and‑forget)
• sessions_spawn: task, label?, agentId?, model?, runTimeoutSeconds?, cleanup?
• session_status: sessionKey? (varsayılan geçerli; sessionId kabul edilir), model? (default geçersiz kılmayı temizler)

• main kanonik doğrudan sohbet anahtarıdır; küresel/bilinmeyenler gizlidir.
• messageLimit > 0, oturum başına son N mesajı getirir (araç mesajları filtrelenir).
• sessions_send, timeoutSeconds > 0 olduğunda nihai tamamlanmayı bekler.
• Teslim/duyuru tamamlanmadan sonra gerçekleşir ve en iyi çabadır; status: "ok", duyurunun teslim edildiğini değil, ajan çalışmasının bittiğini doğrular.
• sessions_spawn, bir alt ajan çalışması başlatır ve talep eden sohbete bir duyuru yanıtı gönderir.
• sessions_spawn bloklamaz ve status: "accepted"’yi hemen döndürür.
• sessions_send, yanıt‑geri ping‑pong’u çalıştırır (durdurmak için REPLY_SKIP yanıtlayın; maksimum tur session.agentToAgent.maxPingPongTurns ile, 0–5).
• Ping‑pong sonrası hedef ajan bir duyuru adımı çalıştırır; duyuruyu bastırmak için ANNOUNCE_SKIP yanıtlayın.

​

agents_list

• Sonuç, ajan başına izin listeleriyle (agents.list[].subagents.allowAgents) sınırlıdır.
• ["*"] yapılandırıldığında, araç tüm yapılandırılmış ajanları içerir ve allowAny: true’i işaretler.

​

Parametreler (genel)

• gatewayUrl (varsayılan ws://127.0.0.1:18789)
• gatewayToken (kimlik doğrulama etkinse)
• timeoutMs

• profile (isteğe bağlı; varsayılan browser.defaultProfile)
• target (sandbox | host | node)
• node (isteğe bağlı; belirli bir düğüm kimliği/adını sabitle)

​

Önerilen ajan akışları

1. browser → status / start
2. snapshot (ai veya aria)
3. act (click/type/press)
4. Görsel doğrulama gerekiyorsa screenshot

1. canvas → present
2. a2ui_push (isteğe bağlı)
3. snapshot

1. nodes → status
2. Seçilen düğümde describe
3. notify / run / camera_snap / screen_record

​

Güvenli kullanım

• Doğrudan system.run’ten kaçının; yalnızca açık kullanıcı onayıyla nodes → run kullanın.
• Kamera/ekran yakalama için kullanıcı onayına uyun.
• Medya komutlarını çağırmadan önce izinleri sağlamak için status/describe kullanın.

​

30. Araçların ajana nasıl sunulduğu

1. Sistem istemi metni: insan tarafından okunabilir bir liste + rehberlik.
2. Araç şeması: model API’sine gönderilen yapılandırılmış işlev tanımları.