​

Werkzeuge (OpenClaw)

​

Werkzeuge deaktivieren

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

• Der Abgleich ist nicht case-sensitiv.
• *-Wildcards werden unterstützt ("*" bedeutet alle Werkzeuge).
• Wenn tools.allow nur auf unbekannte oder nicht geladene Plugin-Werkzeugnamen verweist, protokolliert OpenClaw eine Warnung und ignoriert die Allowlist, sodass Kernwerkzeuge verfügbar bleiben.

​

Werkzeugprofile (Basis-Allowlist)

• minimal: nur session_status
• coding: group:fs, group:runtime, group:sessions, group:memory, image
• messaging: group:messaging, sessions_list, sessions_history, sessions_send, session_status
• full: keine Einschränkung (wie nicht gesetzt)

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

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

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

​

Anbieter­spezifische Werkzeugrichtlinie

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

​

Werkzeuggruppen (Kurzschreibweisen)

• 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 integrierten OpenClaw-Werkzeuge (schließt Anbieter-Plugins aus)

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

​

Plugins + Werkzeuge

• Lobster: typisierte Workflow-Laufzeit mit fortsetzbaren Freigaben (erfordert die Lobster CLI auf dem Gateway-Host).
• LLM Task: reiner JSON-LLM-Schritt für strukturierte Workflow-Ausgaben (optionale Schema-Validierung).

​

Werkzeuginventar

​

apply_patch

​

exec

• command (erforderlich)
• yieldMs (automatischer Hintergrund nach Timeout, Standard 10000)
• background (sofortiger Hintergrund)
• timeout (Sekunden; beendet den Prozess bei Überschreitung, Standard 1800)
• elevated (Bool; auf dem Host ausführen, wenn erhöhter Modus aktiviert/erlaubt ist; ändert das Verhalten nur, wenn der Agent sandboxed ist)
• host (sandbox | gateway | node)
• security (deny | allowlist | full)
• ask (off | on-miss | always)
• node (Node-ID/-Name für host=node)
• Benötigen Sie ein echtes TTY? Setzen Sie pty: true.

• Gibt status: "running" mit einer sessionId zurück, wenn im Hintergrund.
• Verwenden Sie process, um Hintergrund-Sitzungen abzufragen/protokollieren/schreiben/beenden/leeren.
• Wenn process nicht erlaubt ist, läuft exec synchron und ignoriert yieldMs/background.
• elevated ist durch tools.elevated plus einen agents.list[].tools.elevated-Override geschützt (beide müssen erlauben) und ist ein Alias für host=gateway + security=full.
• elevated ändert das Verhalten nur, wenn der Agent sandboxed ist (sonst No-op).
• host=node kann eine macOS-Companion-App oder einen headless Node-Host adressieren (openclaw node run).
• Gateway-/Node-Freigaben und Allowlists: Exec approvals.

​

process

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

• poll gibt neue Ausgabe und Exit-Status zurück, wenn abgeschlossen.
• log unterstützt zeilenbasierte offset/limit (lassen Sie offset weg, um die letzten N Zeilen zu erhalten).
• process ist pro Agent begrenzt; Sitzungen anderer Agenten sind nicht sichtbar.

​

web_search

• query (erforderlich)
• count (1–10; Standard aus tools.web.search.maxResults)

• Erfordert einen Brave-API-Schlüssel (empfohlen: openclaw configure --section web, oder setzen Sie BRAVE_API_KEY).
• Aktivieren über tools.web.search.enabled.
• Antworten werden gecacht (Standard 15 Min.).
• Siehe Web tools für die Einrichtung.

​

web_fetch

• url (erforderlich)
• extractMode (markdown | text)
• maxChars (lange Seiten kürzen)

• Aktivieren über tools.web.fetch.enabled.
• maxChars wird durch tools.web.fetch.maxCharsCap begrenzt (Standard 50000).
• Antworten werden gecacht (Standard 15 Min.).
• Für JS-lastige Seiten bevorzugen Sie das Browser-Werkzeug.
• Siehe Web tools für die Einrichtung.
• Siehe Firecrawl für das optionale Anti-Bot-Fallback.

​

browser

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

• profiles — alle Browser-Profile mit Status auflisten
• create-profile — neues Profil mit automatisch zugewiesenem Port erstellen (oder cdpUrl)
• delete-profile — Browser stoppen, Benutzerdaten löschen, aus der Konfiguration entfernen (nur lokal)
• reset-profile — verwaisten Prozess auf dem Port des Profils beenden (nur lokal)

• profile (optional; Standard browser.defaultProfile)
• target (sandbox | host | node)
• node (optional; wählt eine spezifische Node-ID/-Name) Hinweise:
• Erfordert browser.enabled=true (Standard true; setzen Sie false, um zu deaktivieren).
• Alle Aktionen akzeptieren den optionalen Parameter profile für Multi-Instanz-Unterstützung.
• Wenn profile fehlt, wird browser.defaultProfile verwendet (Standard „chrome“).
• Profilnamen: nur Kleinbuchstaben, alphanumerisch + Bindestriche (max. 64 Zeichen).
• Portbereich: 18800–18899 (~100 Profile max.).
• Remote-Profile sind nur „attach-only“ (kein Start/Stopp/Reset).
• Wenn eine browserfähige Node verbunden ist, kann das Werkzeug automatisch dorthin routen (außer Sie fixieren target).
• snapshot verwendet standardmäßig ai, wenn Playwright installiert ist; verwenden Sie aria für den Accessibility-Tree.
• snapshot unterstützt auch Role-Snapshot-Optionen (interactive, compact, depth, selector), die Refs wie e12 zurückgeben.
• act erfordert ref aus snapshot (numerische 12 aus AI-Snapshots oder e12 aus Role-Snapshots); verwenden Sie evaluate für seltene CSS-Selektor-Fälle.
• Vermeiden Sie standardmäßig act → wait; nur in Ausnahmefällen verwenden (keine verlässliche UI-State, auf die gewartet werden kann).
• upload kann optional eine ref übergeben, um nach dem Scharfstellen automatisch zu klicken.
• upload unterstützt auch inputRef (aria ref) oder element (CSS-Selektor), um <input type="file"> direkt zu setzen.

​

canvas

• present, hide, navigate, eval
• snapshot (liefert Image-Block + MEDIA:<path>)
• a2ui_push, a2ui_reset

• Verwendet unter der Haube Gateway-node.invoke.
• Wenn kein node angegeben ist, wählt das Werkzeug einen Standard (einzelne verbundene Node oder lokaler Mac-Node).
• A2UI ist nur v0.8 (kein createSurface); die CLI lehnt v0.9-JSONL mit Zeilenfehlern ab.
• Schneller Smoke-Test: 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

• Kamera-/Bildschirmbefehle erfordern, dass die Node-App im Vordergrund ist.
• Bilder liefern Image-Blöcke + MEDIA:<path>.
• Videos liefern FILE:<path> (mp4).
• Standort liefert ein JSON-Payload (lat/lon/accuracy/timestamp).
• run-Parameter: command argv-Array; optional 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 (erforderlicher Pfad oder URL)
• prompt (optional; Standard „Describe the image.“)
• model (optionaler Override)
• maxBytesMb (optionale Größenbegrenzung)

• Nur verfügbar, wenn agents.defaults.imageModel konfiguriert ist (primär oder Fallbacks) oder wenn ein implizites Bildmodell aus Ihrem Standardmodell + konfigurierter Auth abgeleitet werden kann (Best-Effort-Paarung).
• Verwendet das Bildmodell direkt (unabhängig vom Haupt-Chatmodell).

​

message

• send (Text + optionale Medien; MS Teams unterstützt zusätzlich card für Adaptive Cards)
• poll (WhatsApp/Discord/MS-Teams-Umfragen)
• 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 routet WhatsApp über das Gateway; andere Kanäle gehen direkt.
• poll verwendet das Gateway für WhatsApp und MS Teams; Discord-Umfragen gehen direkt.
• Wenn ein Nachrichten-Werkzeugaufruf an eine aktive Chat-Sitzung gebunden ist, sind Sendungen auf das Ziel dieser Sitzung beschränkt, um Kontext-Leaks zu vermeiden.

​

cron

• status, list
• add, update, remove, run, runs
• wake (Systemereignis einreihen + optionaler sofortiger Heartbeat)

• add erwartet ein vollständiges Cron-Job-Objekt (gleiches Schema wie cron.add RPC).
• update verwendet { jobId, patch } (id wird aus Kompatibilitätsgründen akzeptiert).

​

gateway

• restart (autorisiert + sendet SIGUSR1 für In-Process-Restart; openclaw gateway Neustart in-place)
• config.get / config.schema
• config.apply (validieren + Konfiguration schreiben + Neustart + Wake)
• config.patch (partielles Update zusammenführen + Neustart + Wake)
• update.run (Update ausführen + Neustart + Wake)

• Verwenden Sie delayMs (Standard 2000), um eine laufende Antwort nicht zu unterbrechen.
• restart ist standardmäßig deaktiviert; aktivieren Sie es mit commands.restart: true.

​

sessions_list / sessions_history / sessions_send / sessions_spawn / session_status

• sessions_list: kinds?, limit?, activeMinutes?, messageLimit? (0 = keine)
• sessions_history: sessionKey (oder sessionId), limit?, includeTools?
• sessions_send: sessionKey (oder sessionId), message, timeoutSeconds? (0 = Fire-and-forget)
• sessions_spawn: task, label?, agentId?, model?, runTimeoutSeconds?, cleanup?
• session_status: sessionKey? (Standard aktuell; akzeptiert sessionId), model? (default löscht den Override)

• main ist der kanonische Direkt-Chat-Schlüssel; global/unbekannt sind ausgeblendet.
• messageLimit > 0 ruft die letzten N Nachrichten pro Sitzung ab (Werkzeugnachrichten gefiltert).
• sessions_send wartet auf den finalen Abschluss, wenn timeoutSeconds > 0.
• Zustellung/Ankündigung erfolgt nach Abschluss und ist Best-Effort; status: "ok" bestätigt, dass der Agentenlauf beendet ist, nicht dass die Ankündigung zugestellt wurde.
• sessions_spawn startet einen Sub-Agent-Lauf und postet eine Ankündigungsantwort zurück in den anfragenden Chat.
• sessions_spawn ist nicht blockierend und gibt sofort status: "accepted" zurück.
• sessions_send führt ein Reply-back-Pingpong aus (Antwort REPLY_SKIP, um zu stoppen; max. Züge über session.agentToAgent.maxPingPongTurns, 0–5).
• Nach dem Pingpong führt der Ziel-Agent einen Ankündigungsschritt aus; antworten Sie mit ANNOUNCE_SKIP, um die Ankündigung zu unterdrücken.

​

agents_list

• Das Ergebnis ist auf Pro-Agent-Allowlists beschränkt (agents.list[].subagents.allowAgents).
• Wenn ["*"] konfiguriert ist, enthält das Werkzeug alle konfigurierten Agenten und markiert allowAny: true.

​

Parameter (gemeinsam)

• gatewayUrl (Standard ws://127.0.0.1:18789)
• gatewayToken (falls Auth aktiviert)
• timeoutMs

• profile (optional; Standard browser.defaultProfile)
• target (sandbox | host | node)
• node (optional; spezifische Node-ID/-Name fixieren)

​

Empfohlene Agentenabläufe

1. browser → status / start
2. snapshot (ai oder aria)
3. act (click/type/press)
4. screenshot bei Bedarf zur visuellen Bestätigung

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

1. nodes → status
2. describe auf der gewählten Node
3. notify / run / camera_snap / screen_record

​

Sicherheit

• Vermeiden Sie direktes system.run; verwenden Sie nodes → run nur mit ausdrücklicher Zustimmung des Nutzers.
• Respektieren Sie die Zustimmung des Nutzers für Kamera-/Bildschirmaufnahmen.
• Verwenden Sie status/describe, um Berechtigungen sicherzustellen, bevor Medienbefehle aufgerufen werden.

​

Wie Werkzeuge dem Agenten präsentiert werden

1. System-Prompt-Text: eine menschenlesbare Liste + Anleitung.
2. Werkzeug-Schema: die strukturierten Funktionsdefinitionen, die an die Modell-API gesendet werden.