openclaw approvals

Verwalten Sie Ausführungsgenehmigungen für den lokalen Host, den Gateway-Host oder einen Node-Host. Ohne Zielflag lesen bzw. schreiben Befehle die lokale Genehmigungsdatei auf dem Datenträger. Verwenden Sie --gateway, um das Gateway als Ziel festzulegen, oder --node <id|name|ip>, um einen bestimmten Node als Ziel festzulegen.

Alias: openclaw exec-approvals

Verwandte Themen: Ausführungsgenehmigungen, Nodes

openclaw exec-policy

openclaw exec-policy ist der praktische, ausschließlich lokale Befehl, der die angeforderte tools.exec.*-Konfiguration und die Genehmigungsdatei des lokalen Hosts in einem Schritt synchron hält:

openclaw exec-policy showopenclaw exec-policy show --json openclaw exec-policy preset yoloopenclaw exec-policy preset cautious --json openclaw exec-policy set --host gateway --security full --ask off --ask-fallback full

Voreinstellungen (yolo, cautious, deny-all) wenden host, security, ask und askFallback gemeinsam an. set wendet nur die von Ihnen übergebenen Flags an; jeder akzeptierte Wert wird validiert (--host auto|sandbox|gateway|node, --security deny|allowlist|full, --ask off|on-miss|always, --ask-fallback deny|allowlist|full).

Geltungsbereich:

• Aktualisiert die lokale Konfigurationsdatei und die lokale Genehmigungsdatei gemeinsam; überträgt die Richtlinie nicht an das Gateway oder einen Node-Host.
• --host node wird abgelehnt: Node-Ausführungsgenehmigungen werden zur Laufzeit vom Node abgerufen, daher kann die lokale exec-policy sie nicht synchronisieren. Verwenden Sie stattdessen openclaw approvals set --node <id|name|ip>.
• exec-policy show kennzeichnet host=node-Geltungsbereiche zur Laufzeit als vom Node verwaltet, anstatt eine effektive Richtlinie aus der lokalen Genehmigungsdatei abzuleiten.

Verwenden Sie für Genehmigungen auf Remote-Hosts direkt openclaw approvals set --gateway oder openclaw approvals set --node <id|name|ip>.

Häufig verwendete Befehle

openclaw approvals getopenclaw approvals get --node <id|name|ip>openclaw approvals get --gatewayopenclaw approvals pendingopenclaw approvals resolve <id> <allow-once|allow-always|deny>

get zeigt die effektive Ausführungsrichtlinie für das Ziel: die angeforderte tools.exec-Richtlinie, die Richtlinie der Host-Genehmigungsdatei und das zusammengeführte effektive Ergebnis. Nodes mit einer hostnativen Richtlinie, etwa der Windows-Begleitanwendung, zeigen diese Richtlinie direkt an, anstatt die Richtlinienlogik der OpenClaw-Genehmigungsdatei anzuwenden.

Bei dateibasierten Nodes erfordert die zusammengeführte Ansicht einen vom Host aufgelösten Richtlinien-Snapshot. Bei älteren Nodes wird die effektive Richtlinie als nicht verfügbar angezeigt, anstatt anzunehmen, dass die angeforderte Richtlinie des Gateways auch auf dem Host gilt.

Rangfolge:

• Die Host-Genehmigungsdatei ist die verbindliche maßgebliche Quelle.
• Die angeforderte tools.exec-Richtlinie kann die beabsichtigte Wirkung einschränken oder erweitern, das effektive Ergebnis wird jedoch aus den Hostregeln abgeleitet.
• --node kombiniert die Genehmigungsdatei des Node-Hosts mit der tools.exec-Richtlinie des Gateways (beide gelten zur Laufzeit).
• Wenn die Gateway-Konfiguration nicht verfügbar ist, greift die CLI auf den Node-Genehmigungs-Snapshot zurück und weist darauf hin, dass die endgültige Laufzeitrichtlinie nicht berechnet werden konnte.

Ausstehende Genehmigungen

Listen Sie ausstehende Ausführungs-, Plugin- und OpenClaw-Systemagent-Genehmigungen vom Gateway auf:

openclaw approvals pendingopenclaw approvals pending --json

Die vollständige Auflistung und der entsprechende operatorweite resolve-Ablauf verwenden operator.admin, da Genehmigungsdatensätze andernfalls die Filterung nach Anforderer und Prüfer beibehalten. Für die Auflösung wird außerdem der dedizierte operator.approvals-Geltungsbereich angefordert. Die standardmäßige CLI-Operatorberechtigung umfasst beide Geltungsbereiche; ein eingeschränkter Drittanbieter-Client sollte keine Administratorberechtigung anfordern, nur um diesen Befehl nachzubilden.

Die menschenlesbare Ausgabe zeigt die Art der Genehmigung, die Zuordnung zu Agent und Sitzung, das Alter der Anfrage, die verbleibende Zeit bis zum Ablauf, einen gekürzten Befehl oder eine Zusammenfassung sowie ein Shell-neutrales id64_<base64url>-ID-Token. Auf die kompakte Tabelle folgt stets ein Full request text-Block mit jedem vollständigen Token und einer verlustfrei maskierten Anfrage, sodass eine Kürzung aufgrund der Terminalbreite weder ein Suffix noch das für die Auflösung benötigte Token verbergen kann. Kopieren Sie das vollständige Token in resolve. Unsichere Terminalzeichen in anderen Feldern werden als sichtbare Unicode-Escapes dargestellt. Die JSON-Ausgabe gibt normalisierte Einträge unter approvals zurück und bewahrt für Skripte die ursprünglichen Rohwerte id, summary, createdAtMs und expiresAtMs; Roh-IDs werden von resolve weiterhin akzeptiert, sofern sie nicht das reservierte Präfix für id64_-Anzeigetoken verwenden.

Wenn ein angegebener id64_-Wert sowohl mit einer wörtlichen Roh-ID als auch mit dem dekodierten Anzeigetoken einer anderen Genehmigung übereinstimmt, weist die CLI ihn als mehrdeutig zurück, anstatt die Auflösung der falschen Anfrage zu riskieren.

Lösen Sie eine Genehmigung anhand ihrer vollständigen ID auf:

openclaw approvals resolve <id> allow-onceopenclaw approvals resolve <id> allow-alwaysopenclaw approvals resolve <id> deny --reason "Not expected during maintenance"

Die CLI liest den vereinheitlichten Genehmigungsdatensatz, um dessen Art zu bestimmen, prüft die angeforderte Entscheidung anhand der für den Datensatz zulässigen Entscheidungen und ruft anschließend den vereinheitlichten Resolver auf. Eine erste erfolgreiche Entscheidung wird mit 0 beendet. Die Wiederholung der gespeicherten Entscheidung wird ebenfalls mit 0 beendet und meldet already resolved (same decision). Eine widersprüchliche Entscheidung, eine fehlende oder abgelaufene Genehmigung oder eine für diese Genehmigungsart nicht verfügbare Entscheidung führt zu einer eindeutigen Fehlermeldung und einem Beenden mit einem von null verschiedenen Statuscode.

--reason fügt der CLI-Bestätigung eine lokale Notiz hinzu. Der aktuelle Gateway-Genehmigungsdatensatz besitzt kein Freitextfeld für den Auflösungsgrund, daher wird diese Notiz weder gespeichert noch an andere Genehmigungsoberflächen gesendet.

Genehmigungen aus einer Datei ersetzen

openclaw approvals set --file ./exec-approvals.jsonopenclaw approvals set --stdin <<'EOF'{ version: 1, defaults: { security: "full", ask: "off", askFallback: "full" } }EOFopenclaw approvals set --node <id|name|ip> --file ./exec-approvals.jsonopenclaw approvals set --gateway --file ./exec-approvals.json

set akzeptiert JSON5, nicht nur striktes JSON. Verwenden Sie entweder --file oder --stdin, nicht beides.

Hostnative Windows-Nodes verwenden ein eigenes Richtlinienformat:

openclaw approvals set --node <id|name|ip> --stdin <<'EOF'{  defaultAction: "deny",  rules: [{ pattern: "hostname", action: "allow" }]}EOF

Die CLI liest zuerst den aktuellen Hash des Nodes und sendet ihn mit der Aktualisierung, sodass gleichzeitige lokale Änderungen abgelehnt und nicht überschrieben werden. rules ist erforderlich, da dieser Vorgang die vollständige Regelliste des Nodes ersetzt; defaultAction ist optional. Ein Node, der seine native Richtlinie als deaktiviert meldet, kann nicht remote konfiguriert werden; aktivieren oder konfigurieren Sie die Richtlinie zuerst auf diesem Host. Hostnative Richtlinien unterstützen die allowlist add|remove-Hilfsfunktionen nicht.

Beispiel für „Nie nachfragen“/YOLO

Setzen Sie die Standardwerte der Host-Genehmigungen für einen Host, der bei Ausführungsgenehmigungen niemals anhalten soll, auf full + off:

openclaw approvals set --stdin <<'EOF'{  version: 1,  defaults: {    security: "full",    ask: "off",    askFallback: "full"  }}EOF

Verwenden Sie für Nodes, die eine OpenClaw-Genehmigungsdatei bereitstellen, denselben Inhalt mit openclaw approvals set --node <id|name|ip> --stdin. Hostnative Nodes erfordern das oben gezeigte, eigentümerspezifische Format.

Dies ändert nur die Host-Genehmigungsdatei. Um auch die angeforderte OpenClaw-Richtlinie entsprechend auszurichten, legen Sie außerdem Folgendes fest:

openclaw config set tools.exec.host gatewayopenclaw config set tools.exec.mode full

tools.exec.host=gateway wird hier ausdrücklich angegeben, da host=auto weiterhin „Sandbox verwenden, wenn verfügbar, andernfalls Gateway“ bedeutet: Bei YOLO geht es um Genehmigungen, nicht um das Routing. Verwenden Sie gateway (oder /exec host=gateway), wenn Sie die Ausführung auf dem Host auch bei konfigurierter Sandbox wünschen.

Wenn askFallback weggelassen wird, ist der Standardwert deny. Legen Sie askFallback: "full" beim Upgrade eines Hosts ohne Benutzeroberfläche ausdrücklich fest, wenn das Verhalten ohne Rückfragen beibehalten werden soll.

Lokale Kurzform für dieselbe Absicht, ausschließlich auf dem lokalen Rechner:

openclaw exec-policy preset yolo

Hilfsfunktionen für die Positivliste

openclaw approvals allowlist add "~/Projects/**/bin/rg"openclaw approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"openclaw approvals allowlist add --agent "*" "/usr/bin/uname" openclaw approvals allowlist remove "~/Projects/**/bin/rg"

Allgemeine Optionen

get, set und allowlist add|remove unterstützen alle:

• --node <id|name|ip> (löst ID, Name, IP-Adresse oder ID-Präfix auf; derselbe Resolver wie openclaw nodes)
• --gateway
• gemeinsame Node-RPC-Optionen: --url, --token, --timeout, --json

Ohne Zielflag wird die lokale Genehmigungsdatei auf dem Datenträger verwendet.

allowlist add|remove unterstützt außerdem --agent <id> (Standardwert: "*", gilt für alle Agents).

pending und resolve verwenden stets das Gateway, da ausstehende Anfragen zum aktuellen Gateway-Zustand gehören. Sie unterstützen die gemeinsamen Gateway-Verbindungsoptionen --url, --token und --timeout; pending unterstützt außerdem --json.

Hinweise

• Der Node-Host muss system.execApprovals.get/set bekannt geben (macOS-App, monitorloser Node-Host oder Windows-Begleitanwendung).
• Genehmigungsdateien werden pro Host im OpenClaw-Zustandsverzeichnis gespeichert: $OPENCLAW_STATE_DIR/exec-approvals.json oder ~/.openclaw/exec-approvals.json, wenn die Variable nicht gesetzt ist.

Verwandte Themen

• CLI-Referenz
• Ausführungsgenehmigungen