​

Hulpmiddelen (OpenClaw)

​

Tools uitschakelen

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

• Overeenkomen is hoofdletterongevoelig.
• *-wildcards worden ondersteund ("*" betekent alle tools).
• Als tools.allow alleen onbekende of niet-geladen plugin-toolnamen bevat, logt OpenClaw een waarschuwing en negeert de toegestane lijst zodat kerntools beschikbaar blijven.

​

Toolprofielen (basis-toegestane lijst)

• minimal: alleen session_status
• coding: group:fs, group:runtime, group:sessions, group:memory, image
• messaging: group:messaging, sessions_list, sessions_history, sessions_send, session_status
• full: geen beperking (zelfde als niet ingesteld)

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

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

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

​

Provider-specifiek toolbeleid

{
  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"] },
          },
        },
      },
    ],
  },
}

​

Toolgroepen (snelkoppelingen)

• 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: alle ingebouwde OpenClaw-tools (sluit provider-plugins uit)

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

​

Plugins + tools

• Lobster: getypeerde workflow-runtime met hervatbare goedkeuringen (vereist de Lobster CLI op de Gateway-host).
• LLM Task: JSON-only LLM-stap voor gestructureerde workflow-uitvoer (optionele schema-validatie).

​

Toolinventaris

​

apply_patch

​

exec

• command (vereist)
• yieldMs (automatisch naar achtergrond na timeout, standaard 10000)
• background (direct naar achtergrond)
• timeout (seconden; stopt het proces bij overschrijding, standaard 1800)
• elevated (bool; uitvoeren op host als verhoogde modus is ingeschakeld/toegestaan; wijzigt alleen gedrag wanneer de agent gesandboxed is)
• host (sandbox | gateway | node)
• security (deny | allowlist | full)
• ask (off | on-miss | always)
• node (node-id/naam voor host=node)
• Echte TTY nodig? Stel pty: true in.

• Retourneert status: "running" met een sessionId wanneer naar de achtergrond gestuurd.
• Gebruik process om achtergrond-sessies te pollen/loggen/schrijven/stoppen/opschonen.
• Als process niet is toegestaan, draait exec synchroon en negeert yieldMs/background.
• elevated wordt afgeschermd door tools.elevated plus een eventuele agents.list[].tools.elevated-override (beide moeten toestaan) en is een alias voor host=gateway + security=full.
• elevated wijzigt alleen gedrag wanneer de agent gesandboxed is (anders is het een no-op).
• host=node kan richten op een macOS Companion-app of een headless node-host (openclaw node run).
• gateway/node-goedkeuringen en toegestane lijsten: Exec approvals.

​

process

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

• poll retourneert nieuwe uitvoer en exitstatus wanneer voltooid.
• log ondersteunt regelgebaseerde offset/limit (laat offset weg om de laatste N regels op te halen).
• process is per agent afgebakend; sessies van andere agents zijn niet zichtbaar.

​

web_search

• query (vereist)
• count (1–10; standaard uit tools.web.search.maxResults)

• Vereist een Brave API-sleutel (aanbevolen: openclaw configure --section web, of stel BRAVE_API_KEY in).
• Inschakelen via tools.web.search.enabled.
• Antwoorden worden gecachet (standaard 15 min).
• Zie Web tools voor installatie.

​

web_fetch

• url (vereist)
• extractMode (markdown | text)
• maxChars (lange pagina’s afkappen)

• Inschakelen via tools.web.fetch.enabled.
• maxChars wordt begrensd door tools.web.fetch.maxCharsCap (standaard 50000).
• Antwoorden worden gecachet (standaard 15 min).
• Voor JS-zware sites heeft de browser-tool de voorkeur.
• Zie Web tools voor installatie.
• Zie Firecrawl voor de optionele anti-bot fallback.

​

browser

• status, start, stop, tabs, open, focus, close
• snapshot (aria/ai)
• screenshot (retourneert image block + MEDIA:<path>)
• act (UI-acties: click/type/press/hover/drag/select/fill/resize/wait/evaluate)
• navigate, console, pdf, upload, dialog

• profiles — lijst alle browserprofielen met status
• create-profile — maak nieuw profiel met automatisch toegewezen poort (of cdpUrl)
• delete-profile — stop browser, verwijder gebruikersdata, verwijder uit config (alleen lokaal)
• reset-profile — kill verweesd proces op de poort van het profiel (alleen lokaal)

• profile (optioneel; standaard browser.defaultProfile)
• target (sandbox | host | node)
• node (optioneel; kiest een specifieke node-id/naam) Notities:
• Vereist browser.enabled=true (standaard true; stel false in om uit te schakelen).
• Alle acties accepteren een optionele profile-parameter voor multi-instance-ondersteuning.
• Wanneer profile ontbreekt, wordt browser.defaultProfile gebruikt (standaard “chrome”).
• Profielnamen: alleen lowercase alfanumeriek + koppeltekens (max. 64 tekens).
• Poortbereik: 18800-18899 (~100 profielen max).
• Externe profielen zijn alleen attach-only (geen start/stop/reset).
• Als een browser-geschikte node is verbonden, kan de tool hier automatisch naartoe routen (tenzij je target vastzet).
• snapshot is standaard ai wanneer Playwright is geïnstalleerd; gebruik aria voor de toegankelijkheidsboom.
• snapshot ondersteunt ook role-snapshot-opties (interactive, compact, depth, selector) die refs retourneren zoals e12.
• act vereist ref uit snapshot (numerieke 12 uit AI-snapshots, of e12 uit role-snapshots); gebruik evaluate voor zeldzame CSS-selectorbehoeften.
• Vermijd standaard act → wait; gebruik het alleen in uitzonderlijke gevallen (geen betrouwbare UI-status om op te wachten).
• upload kan optioneel een ref doorgeven om automatisch te klikken na het armeren.
• upload ondersteunt ook inputRef (aria-ref) of element (CSS-selector) om <input type="file"> direct in te stellen.

​

canvas

• present, hide, navigate, eval
• snapshot (retourneert image block + MEDIA:<path>)
• a2ui_push, a2ui_reset

• Gebruikt gateway node.invoke onder de motorkap.
• Als geen node is opgegeven, kiest de tool een standaard (één verbonden node of lokale mac-node).
• A2UI is alleen v0.8 (geen createSurface); de CLI weigert v0.9 JSONL met regel-fouten.
• Snelle rooktest: openclaw nodes canvas a2ui push --node <id> --text "Hello from A2UI".

​

nodes

• status, describe
• pending, approve, reject (pairing)
• notify (macOS system.notify)
• run (macOS system.run)
• camera_snap, camera_clip, screen_record
• location_get

• Camera-/schermopdrachten vereisen dat de node-app op de voorgrond staat.
• Afbeeldingen retourneren image blocks + MEDIA:<path>.
• Video’s retourneren FILE:<path> (mp4).
• Locatie retourneert een JSON-payload (lat/lon/nauwkeurigheid/timestamp).
• run-parameters: command argv-array; optioneel 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 (vereist pad of URL)
• prompt (optioneel; standaard “Describe the image.”)
• model (optionele override)
• maxBytesMb (optionele groottebeperking)

• Alleen beschikbaar wanneer agents.defaults.imageModel is geconfigureerd (primair of fallbacks), of wanneer een impliciet afbeeldingsmodel kan worden afgeleid uit je standaardmodel + geconfigureerde authenticatie (best-effort koppeling).
• Gebruikt het afbeeldingsmodel direct (onafhankelijk van het hoofdchatmodel).

​

message

• send (tekst + optionele media; MS Teams ondersteunt ook card voor Adaptive Cards)
• poll (WhatsApp/Discord/MS Teams polls)
• 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 routeert WhatsApp via de Gateway; andere kanalen gaan direct.
• poll gebruikt de Gateway voor WhatsApp en MS Teams; Discord-polls gaan direct.
• Wanneer een message-toolcall is gebonden aan een actieve chatsessie, zijn verzendacties beperkt tot het doel van die sessie om cross-context-lekken te voorkomen.

​

cron

• status, list
• add, update, remove, run, runs
• wake (enqueue systeemevent + optionele onmiddellijke heartbeat)

• add verwacht een volledig cronjob-object (zelfde schema als cron.add RPC).
• update gebruikt { jobId, patch } (id geaccepteerd voor compatibiliteit).

​

gateway

• restart (autoriseert + verstuurt SIGUSR1 voor in-process herstart; openclaw gateway herstart in-place)
• config.get / config.schema
• config.apply (valideren + config wegschrijven + herstart + wake)
• config.patch (gedeeltelijke update samenvoegen + herstart + wake)
• update.run (update uitvoeren + herstart + wake)

• Gebruik delayMs (standaard 2000) om een lopend antwoord niet te onderbreken.
• restart is standaard uitgeschakeld; schakel in met commands.restart: true.

​

sessions_list / sessions_history / sessions_send / sessions_spawn / session_status

• sessions_list: kinds?, limit?, activeMinutes?, messageLimit? (0 = geen)
• sessions_history: sessionKey (of sessionId), limit?, includeTools?
• sessions_send: sessionKey (of sessionId), message, timeoutSeconds? (0 = fire-and-forget)
• sessions_spawn: task, label?, agentId?, model?, runTimeoutSeconds?, cleanup?
• session_status: sessionKey? (standaard huidige; accepteert sessionId), model? (default wist override)

• main is de canonieke direct-chat-sleutel; globaal/onbekend wordt verborgen.
• messageLimit > 0 haalt de laatste N berichten per sessie op (toolberichten gefilterd).
• sessions_send wacht op definitieve voltooiing wanneer timeoutSeconds > 0.
• Levering/aankondiging gebeurt na voltooiing en is best-effort; status: "ok" bevestigt dat de agentrun is afgerond, niet dat de aankondiging is afgeleverd.
• sessions_spawn start een sub-agentrun en plaatst een announce-antwoord terug naar de aanvragende chat.
• sessions_spawn is non-blocking en retourneert status: "accepted" onmiddellijk.
• sessions_send voert een reply‑back ping‑pong uit (antwoord REPLY_SKIP om te stoppen; max. beurten via session.agentToAgent.maxPingPongTurns, 0–5).
• Na de ping‑pong voert de doelagent een announce-stap uit; antwoord ANNOUNCE_SKIP om de aankondiging te onderdrukken.

​

agents_list

• Resultaat is beperkt tot per-agent toegestane lijsten (agents.list[].subagents.allowAgents).
• Wanneer ["*"] is geconfigureerd, bevat de tool alle geconfigureerde agents en markeert allowAny: true.

​

Parameters (gemeenschappelijk)

• gatewayUrl (standaard ws://127.0.0.1:18789)
• gatewayToken (als authenticatie is ingeschakeld)
• timeoutMs

• profile (optioneel; standaard browser.defaultProfile)
• target (sandbox | host | node)
• node (optioneel; pin een specifieke node-id/naam)

​

Aanbevolen agentflows

1. browser → status / start
2. snapshot (ai of aria)
3. act (click/type/press)
4. screenshot als je visuele bevestiging nodig hebt

1. canvas → present
2. a2ui_push (optioneel)
3. snapshot

1. nodes → status
2. describe op de gekozen node
3. notify / run / camera_snap / screen_record

​

Veiligheid

• Vermijd directe system.run; gebruik nodes → run alleen met expliciete toestemming van de gebruiker.
• Respecteer toestemming van de gebruiker voor camera-/schermopname.
• Gebruik status/describe om rechten te waarborgen vóór het aanroepen van media-opdrachten.

​

Hoe tools aan de agent worden gepresenteerd

1. Systeemprompttekst: een voor mensen leesbare lijst + richtlijnen.
2. Toolschema: de gestructureerde functiedefinities die naar de model-API worden gestuurd.