​

Verktyg (OpenClaw)

​

Inaktivera verktyg

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

• Matchning är skiftlägesokänslig.
• * jokertecken stöds ("*" betyder alla verktyg).
• Om tools.allow endast refererar till okända eller ej laddade plugin‑verktygsnamn loggar OpenClaw en varning och ignorerar tillåtelselistan så att kärnverktyg förblir tillgängliga.

​

Verktygsprofiler (bas‑tillåtelselista)

• minimal: endast session_status
• coding: group:fs, group:runtime, group:sessions, group:memory, image
• messaging: group:messaging, sessions_list, sessions_history, sessions_send, session_status
• full: inga begränsningar (samma som ej satt)

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

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

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

​

Leverantörsspecifik verktygspolicy

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

​

Verktygsgrupper (genvägar)

• 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: alla inbyggda OpenClaw‑verktyg (exkluderar leverantörspluginer)

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

​

Pluginer + verktyg

• Lobster: typad workflow‑runtime med återupptagbara godkännanden (kräver Lobster CLI på gateway‑värden).
• LLM Task: JSON‑endast LLM‑steg för strukturerad workflow‑utdata (valfri schemavalidering).

​

Verktygsinventering

​

apply_patch

​

exec

• command (krävs)
• yieldMs (auto‑bakgrund efter timeout, standard 10000)
• background (omedelbar bakgrund)
• timeout (sekunder; dödar processen om den överskrids, standard 1800)
• elevated (bool; kör på värd om förhöjt läge är aktiverat/tillåtet; ändrar endast beteende när agenten är sandboxad)
• host (sandbox | gateway | node)
• security (deny | allowlist | full)
• ask (off | on-miss | always)
• node (nod‑id/namn för host=node)
• Behöver du en riktig TTY? Ange pty: true.

• Returnerar status: "running" med ett sessionId när den körs i bakgrunden.
• Använd process för att polla/logga/skriva/döda/rensa bakgrundssessioner.
• Om process inte är tillåtet körs exec synkront och ignorerar yieldMs/background.
• elevated styrs av tools.elevated plus eventuell agents.list[].tools.elevated‑åsidosättning (båda måste tillåta) och är ett alias för host=gateway + security=full.
• elevated ändrar endast beteende när agenten är sandboxad (annars är det en no‑op).
• host=node kan rikta sig till en macOS companion‑app eller en headless nodvärd (openclaw node run).
• gateway/nod‑godkännanden och tillåtelselistor: Exec approvals.

​

process

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

• poll returnerar ny utdata och exit‑status när den är klar.
• log stöder radbaserad offset/limit (utelämna offset för att hämta de senaste N raderna).
• process är per agent; sessioner från andra agenter är inte synliga.

​

web_search

• query (krävs)
• count (1–10; standard från tools.web.search.maxResults)

• Kräver en Brave API‑nyckel (rekommenderat: openclaw configure --section web, eller sätt BRAVE_API_KEY).
• Aktivera via tools.web.search.enabled.
• Svar cachelagras (standard 15 min).
• Se Web tools för konfiguration.

​

web_fetch

• url (krävs)
• extractMode (markdown | text)
• maxChars (trunkera långa sidor)

• Aktivera via tools.web.fetch.enabled.
• maxChars begränsas av tools.web.fetch.maxCharsCap (standard 50000).
• Svar cachelagras (standard 15 min).
• För JS‑tunga webbplatser, föredra browser‑verktyget.
• Se Web tools för konfiguration.
• Se Firecrawl för valfri anti‑bot‑fallback.

​

browser

• status, start, stop, tabs, open, focus, close
• snapshot (aria/ai)
• screenshot (returnerar bildblock + MEDIA:<path>)
• act (UI‑åtgärder: click/type/press/hover/drag/select/fill/resize/wait/evaluate)
• navigate, console, pdf, upload, dialog

• profiles — lista alla browserprofiler med status
• create-profile — skapa ny profil med automatiskt tilldelad port (eller cdpUrl)
• delete-profile — stoppa browser, radera användardata, ta bort från konfig (endast lokalt)
• reset-profile — döda föräldralös process på profilens port (endast lokalt)

• profile (valfri; standard browser.defaultProfile)
• target (sandbox | host | node)
• node (valfri; välj specifikt nod‑id/namn) Noteringar:
• Kräver browser.enabled=true (standard är true; sätt false för att inaktivera).
• Alla åtgärder accepterar valfri profile‑parameter för stöd av flera instanser.
• När profile utelämnas används browser.defaultProfile (standard “chrome”).
• Profilnamn: endast gemener alfanumeriskt + bindestreck (max 64 tecken).
• Portintervall: 18800–18899 (~100 profiler max).
• Fjärrprofiler är endast attach‑only (ingen start/stop/reset).
• Om en browser‑kapabel nod är ansluten kan verktyget auto‑routa till den (om du inte pinnar target).
• snapshot standardiserar till ai när Playwright är installerat; använd aria för tillgänglighetsträdet.
• snapshot stöder även role‑snapshot‑alternativ (interactive, compact, depth, selector) som returnerar referenser som e12.
• act kräver ref från snapshot (numeriskt 12 från AI‑snapshots, eller e12 från role‑snapshots); använd evaluate för sällsynta behov av CSS‑selektor.
• Undvik act → wait som standard; använd endast i undantagsfall (ingen pålitlig UI‑status att vänta på).
• upload kan valfritt skicka ett ref för auto‑klick efter aktivering.
• upload stöder även inputRef (aria‑ref) eller element (CSS‑selektor) för att sätta <input type="file"> direkt.

​

canvas

• present, hide, navigate, eval
• snapshot (returnerar bildblock + MEDIA:<path>)
• a2ui_push, a2ui_reset

• Använder gateway node.invoke under huven.
• Om ingen node anges väljer verktyget en standard (en ensam ansluten nod eller lokal mac‑nod).
• A2UI är endast v0.8 (ingen createSurface); CLI avvisar v0.9 JSONL med radfel.
• Snabb kontroll: openclaw nodes canvas a2ui push --node <id> --text "Hello from A2UI".

​

nodes

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

• Kamera/skärm‑kommandon kräver att nodappen är i förgrunden.
• Bilder returnerar bildblock + MEDIA:<path>.
• Videor returnerar FILE:<path> (mp4).
• Plats returnerar en JSON‑payload (lat/lon/accuracy/timestamp).
• run‑parametrar: command argv‑array; valfri 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 (krävd sökväg eller URL)
• prompt (valfri; standard “Describe the image.”)
• model (valfri åsidosättning)
• maxBytesMb (valfri storleksgräns)

• Endast tillgängligt när agents.defaults.imageModel är konfigurerad (primär eller fallbacks), eller när en implicit bildmodell kan härledas från din standardmodell + konfigurerad autentisering (best‑effort‑parning).
• Använder bildmodellen direkt (oberoende av huvud‑chattmodellen).

​

message

• send (text + valfri media; MS Teams stöder även card för Adaptive Cards)
• poll (WhatsApp/Discord/MS Teams‑omröstningar)
• 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 routar WhatsApp via Gateway; andra kanaler går direkt.
• poll använder Gateway för WhatsApp och MS Teams; Discord‑omröstningar går direkt.
• När ett meddelandeverktygsanrop är bundet till en aktiv chattsession begränsas sändningar till sessionens mål för att undvika läckage mellan kontexter.

​

cron

• status, list
• add, update, remove, run, runs
• wake (köar systemhändelse + valfri omedelbar heartbeat)

• add förväntar sig ett fullständigt cronjobb‑objekt (samma schema som cron.add RPC).
• update använder { jobId, patch } (id accepteras för kompatibilitet).

​

gateway

• restart (auktoriserar + skickar SIGUSR1 för omstart i process; openclaw gateway startar om in‑place)
• config.get / config.schema
• config.apply (validera + skriv konfig + starta om + väck)
• config.patch (sammanfoga partiell uppdatering + starta om + väck)
• update.run (kör uppdatering + starta om + väck)

• Använd delayMs (standard 2000) för att undvika att avbryta ett pågående svar.
• restart är inaktiverad som standard; aktivera med commands.restart: true.

​

sessions_list / sessions_history / sessions_send / sessions_spawn / session_status

• sessions_list: kinds?, limit?, activeMinutes?, messageLimit? (0 = ingen)
• sessions_history: sessionKey (eller sessionId), limit?, includeTools?
• sessions_send: sessionKey (eller sessionId), message, timeoutSeconds? (0 = fire‑and‑forget)
• sessions_spawn: task, label?, agentId?, model?, runTimeoutSeconds?, cleanup?
• session_status: sessionKey? (standard aktuell; accepterar sessionId), model? (default rensar åsidosättning)

• main är den kanoniska direct‑chat‑nyckeln; globala/okända döljs.
• messageLimit > 0 hämtar de senaste N meddelandena per session (verktygsmeddelanden filtreras).
• sessions_send väntar på slutlig färdigställning när timeoutSeconds > 0.
• Leverans/annonsering sker efter färdigställande och är best‑effort; status: "ok" bekräftar att agentkörningen är klar, inte att annonseringen levererades.
• sessions_spawn startar en sub‑agentkörning och postar ett announce‑svar tillbaka till begärande chatt.
• sessions_spawn är icke‑blockerande och returnerar status: "accepted" omedelbart.
• sessions_send kör en svar‑ping‑pong (svara REPLY_SKIP för att stoppa; max varv via session.agentToAgent.maxPingPongTurns, 0–5).
• Efter ping‑pong kör målagenten ett announce‑steg; svara ANNOUNCE_SKIP för att undertrycka annonseringen.

​

agents_list

• Resultatet är begränsat till per‑agent‑tillåtelselistor (agents.list[].subagents.allowAgents).
• När ["*"] är konfigurerad inkluderar verktyget alla konfigurerade agenter och markerar allowAny: true.

​

Parametrar (gemensamma)

• gatewayUrl (standard ws://127.0.0.1:18789)
• gatewayToken (om autentisering är aktiverad)
• timeoutMs

• profile (valfri; standard browser.defaultProfile)
• target (sandbox | host | node)
• node (valfri; pinna ett specifikt nod‑id/namn)

​

Rekommenderade agentflöden

1. browser → status / start
2. snapshot (ai eller aria)
3. act (click/type/press)
4. screenshot om du behöver visuell bekräftelse

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

1. nodes → status
2. describe på vald nod
3. notify / run / camera_snap / screen_record

​

Säkerhet

• Undvik direkt system.run; använd nodes → run endast med uttryckligt användarsamtycke.
• Respektera användarsamtycke för kamera/skärm‑inspelning.
• Använd status/describe för att säkerställa behörigheter innan media‑kommandon anropas.

​

Hur verktyg presenteras för agenten

1. Systemprompt‑text: en människoläsbar lista + vägledning.
2. Verktygsschema: de strukturerade funktionsdefinitionerna som skickas till modell‑API:t.