OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Verhoogde modus

Wanneer een agent binnen een sandbox wordt uitgevoerd, zijn diens exec-opdrachten beperkt tot de sandboxomgeving. In de verhoogde modus kan de agent daaruit ontsnappen en in plaats daarvan opdrachten buiten de sandbox uitvoeren, met configureerbare goedkeuringspoorten.

Richtlijnen

Beheer de verhoogde modus per sessie met slash-opdrachten:

Richtlijn Wat deze doet
/elevated on Buiten de sandbox uitvoeren op het geconfigureerde hostpad, met behoud van goedkeuringen
/elevated ask Hetzelfde als on (alias)
/elevated full Buiten de sandbox uitvoeren op het geconfigureerde hostpad en goedkeuringen overslaan wanneer het goedkeuringsbeleid voor modus/host al permissief is
/elevated off Terugkeren naar uitvoering die tot de sandbox is beperkt

Ook beschikbaar als /elev on|off|ask|full.

Stuur /elevated zonder argument om het huidige niveau te bekijken.

Werking

  • Beschikbaarheid controleren

    Verhoogde uitvoering moet in de configuratie zijn ingeschakeld en de afzender moet op de toelatingslijst staan:

    json5
    {  tools: {    elevated: {      enabled: true,      allowFrom: {        discord: ["user-id-123"],        whatsapp: ["+15555550123"],      },    },  },}

  • Het niveau instellen

    Stuur een bericht dat alleen een richtlijn bevat om de standaardwaarde voor de sessie in te stellen:

    Code
    /elevated full

    Of gebruik deze inline (alleen van toepassing op dat bericht):

    Code
    /elevated on run the deployment script

  • Opdrachten worden buiten de sandbox uitgevoerd

    Wanneer verhoogde uitvoering actief is, verlaten exec-aanroepen de sandbox. De effectieve host is standaard gateway, of node wanneer het geconfigureerde uitvoeringsdoel of dat van de sessie node is. In de modus full worden exec-goedkeuringen overgeslagen wanneer het bepaalde goedkeuringsbeleid voor uitvoeringsmodus/host al volledig permissief is (security full, ask off); anders blijft het normale goedkeuringsbeleid van toepassing. In de modus on/ask zijn de geconfigureerde goedkeuringsregels altijd van toepassing.

    • Volgorde van bepaling

    1. Inline richtlijn in het bericht (alleen van toepassing op dat bericht)
    2. Sessieoverschrijving (ingesteld door een bericht te sturen dat alleen een richtlijn bevat)
    3. Globale standaardwaarde (agents.defaults.elevatedDefault in de configuratie)

    Beschikbaarheid en toelatingslijsten

    • Globale poort: tools.elevated.enabled (moet true zijn)
    • Toelatingslijst voor afzenders: tools.elevated.allowFrom met lijsten per kanaal
    • Poort per agent: agents.list[].tools.elevated.enabled (kan alleen verder beperken; zowel de globale poort als de poort per agent moet true zijn)
    • Toelatingslijst per agent: agents.list[].tools.elevated.allowFrom (de afzender moet overeenkomen met zowel de globale lijst als die per agent)
    • Door het kanaal geleverde terugvaltoelatingslijst: kanaalplugins kunnen optioneel via een SDK-adapterhook een terugvaltoelatingslijst leveren, die wordt gebruikt wanneer tools.elevated.allowFrom.<provider> niet is geconfigureerd. Momenteel implementeert geen enkel meegeleverd kanaal deze hook, dus in de praktijk heeft elke provider momenteel een expliciete vermelding voor tools.elevated.allowFrom.<provider> nodig.
    • Alle poorten moeten worden gepasseerd; anders wordt verhoogde uitvoering als niet beschikbaar beschouwd

    Notaties voor vermeldingen in de toelatingslijst:

    Voorvoegsel Komt overeen met
    (geen) Afzender-ID, E.164 of het From-veld
    name: Weergavenaam van de afzender
    username: Gebruikersnaam van de afzender
    tag: Tag van de afzender
    id:, from:, e164: Expliciete selectie van een identiteit

    Wat verhoogde uitvoering niet beheert

    • Toolbeleid: als exec door het toolbeleid wordt geweigerd, kan verhoogde uitvoering dit niet omzeilen.
    • Beleid voor hostselectie: verhoogde uitvoering verandert auto niet in een vrije overschrijving tussen hosts. De regels voor het geconfigureerde uitvoeringsdoel of dat van de sessie worden gebruikt, waarbij node alleen wordt gekozen als het doel al node is.
    • Los van /exec: de richtlijn /exec past de standaardwaarden voor exec per sessie aan (host, security, ask, node) voor bevoegde afzenders en vereist geen verhoogde modus.

    Gerelateerd

    Exec-tool

    Uitvoering van shellopdrachten vanuit de agent.
    Exec-goedkeuringen

    Goedkeurings- en toelatingslijstsysteem voor exec.
    Sandboxing

    Sandboxconfiguratie op Gateway-niveau.
    Sandbox versus toolbeleid versus verhoogde uitvoering

    Hoe de drie poorten tijdens een toolaanroep samenwerken.
    Was this useful?
    On this page

    On this page