Zum Hauptinhalt springen
Berechtigungsmodi legen fest, wie viel Autorität ein Agent hat, bevor er Host-Befehle ausführen, Dateien schreiben oder ein Backend-Harness um zusätzlichen Zugriff bitten kann. Beginnen Sie mit tools.exec.mode: "auto", wenn OpenClaw zuerst Allowlists verwenden soll und anschließend bei Fehltreffern die native Codex-Auto-Review oder eine menschliche Genehmigungsroute.
Der Berechtigungsmodus ist von tools.exec.host=auto getrennt. tools.exec.host wählt aus, wo ein Befehl ausgeführt wird. tools.exec.mode wählt aus, wie Host-Exec genehmigt wird.

Empfohlene Standardeinstellung

Verwenden Sie auto für Coding-Agenten, die nützlichen Host-Zugriff benötigen, ohne jeden Fehltreffer zu einer menschlichen Rückfrage zu machen:
openclaw config set tools.exec.mode auto
openclaw approvals get
openclaw gateway restart
Überprüfen Sie anschließend die wirksame Richtlinie:
openclaw exec-policy show
Im Modus auto führt OpenClaw deterministische Allowlist-Treffer direkt aus. Genehmigungs-Fehltreffer durchlaufen zuerst den nativen Auto-Reviewer von OpenClaw und fallen dann bei Bedarf auf die konfigurierte menschliche Genehmigungsroute zurück.

OpenClaw-Host-Exec-Modi

tools.exec.mode ist die normalisierte Richtlinienoberfläche für Host-exec.
ModusVerhaltenVerwenden, wenn
denyHost-Exec blockieren.Keine Host-Befehle erlaubt sind.
allowlistNur Allowlist-Befehle ausführen.Sie einen bekannten sicheren Befehlssatz haben.
askAllowlist-Treffer ausführen und bei Fehltreffern fragen.Ein Mensch neue Befehlsformen prüfen soll.
autoAllowlist-Treffer ausführen, dann Auto-Review verwenden.Coding-Sitzungen praktischen, abgesicherten Zugriff benötigen.
fullHost-Exec ohne Rückfragen ausführen.Dieser vertrauenswürdige Host/diese Sitzung Genehmigungsgates überspringen soll.
Die vollständige Host-Exec-Richtlinie, die lokale Genehmigungsdatei, das Allowlist-Schema, sichere Bins und das Weiterleitungsverhalten finden Sie unter Exec-Genehmigungen.

Codex-Guardian-Zuordnung

Für native Codex-App-Server-Sitzungen wird tools.exec.mode: "auto" Codex-Guardian-geprüften Genehmigungen zugeordnet, wenn die lokalen Codex-Anforderungen dies zulassen. OpenClaw sendet normalerweise:
Codex-FeldTypischer Wert
approvalPolicyon-request
approvalsReviewerauto_review
sandboxworkspace-write
Im Modus auto bewahrt OpenClaw keine veralteten unsicheren Codex-Überschreibungen wie approvalPolicy: "never" oder sandbox: "danger-full-access" auf. Verwenden Sie tools.exec.mode: "full" nur, wenn Sie bewusst die Haltung ohne Genehmigungen wünschen. Informationen zur App-Server-Einrichtung, Auth-Reihenfolge und zu nativen Codex-Laufzeitdetails finden Sie unter Codex-Harness.

ACPX-Harness-Berechtigungen

ACPX-Sitzungen sind nicht interaktiv und können daher keine TTY-Berechtigungsaufforderung anklicken. ACPX verwendet separate Harness-Einstellungen unter plugins.entries.acpx.config:
EinstellungÜblicher WertBedeutung
permissionModeapprove-readsNur Lesezugriffe automatisch genehmigen.
permissionModeapprove-allSchreibzugriffe und Shell-Befehle automatisch genehmigen.
permissionModedeny-allAlle Berechtigungsaufforderungen ablehnen.
nonInteractivePermissionsfailAbbrechen, wenn eine Aufforderung erforderlich wäre.
nonInteractivePermissionsdenyDie Aufforderung ablehnen und nach Möglichkeit fortfahren.
Legen Sie ACPX-Berechtigungen getrennt von OpenClaw-Exec-Genehmigungen fest:
openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail
openclaw gateway restart
Verwenden Sie approve-all als ACPX-Break-Glass-Entsprechung einer Harness-Sitzung ohne Rückfragen. Einrichtungsdetails und Fehlermodi finden Sie unter ACP-Agenten einrichten.

Einen Modus auswählen

ZielKonfiguration
Host-Befehle vollständig blockierentools.exec.mode: "deny"
Nur bekannte sichere Befehle ausführen lassentools.exec.mode: "allowlist"
Einen Menschen für jede neue Befehlsform fragentools.exec.mode: "ask"
Codex/OpenClaw-Auto-Review vor Menschen verwendentools.exec.mode: "auto"
Host-Exec-Genehmigungen vollständig überspringentools.exec.mode: "full" plus passende Host-Genehmigungsdatei
Nicht interaktive ACPX-Sitzungen schreiben/ausführen lassenplugins.entries.acpx.config.permissionMode: "approve-all"
Wenn ein Befehl nach dem Ändern des Modus weiterhin eine Aufforderung zeigt oder fehlschlägt, prüfen Sie beide Ebenen:
openclaw approvals get
openclaw exec-policy show
Host-Exec verwendet das strengere Ergebnis aus OpenClaw-Konfiguration und der hostlokalen Genehmigungsdatei. ACPX-Harness-Berechtigungen lockern Host-Exec-Genehmigungen nicht, und Host-Exec-Genehmigungen lockern ACPX-Harness-Aufforderungen nicht.

Verwandt