openclaw policy

openclaw policy wordt geleverd door de gebundelde Policy-plugin. Het is een conformiteitslaag voor ondernemingen boven op bestaande OpenClaw-instellingen, geen tweede configuratiesysteem. U legt vereisten vast in policy.jsonc; OpenClaw observeert de actieve werkruimte als bewijs; Policy meldt afwijkingen via doctor --lint. Policy dwingt geen toolaanroepen af en herschrijft het runtimegedrag niet tijdens een aanvraag. Ook attesteert Policy geen referentieopslagen per agent, zoals auth-profiles.json.

Policy controleert geconfigureerde kanalen, MCP-servers, modelproviders, de netwerkhouding voor SSRF, toegang via inkomende verbindingen en kanalen, blootstelling van de Gateway en de houding voor Node-opdrachten, toegang tot agentwerkruimten, de sandboxhouding, de gegevensverwerkingshouding, de houding van geheimenproviders en authenticatieprofielen, en beheerde toolmetagegevens (TOOLS.md). Gebruik dit wanneer een werkruimte een duurzame, controleerbare verklaring nodig heeft, zoals "Telegram mag niet zijn ingeschakeld" of "beheerde tools moeten metagegevens over risico en eigenaar declareren". Als u alleen lokaal gedrag nodig hebt zonder attestatie of afwijkingsdetectie, is gewone configuratie voldoende.

Snel aan de slag

openclaw plugins enable policy

De Plugin blijft ingeschakeld, zelfs wanneer policy.jsonc ontbreekt, zodat doctor het ontbrekende artefact kan melden in plaats van controles stilzwijgend over te slaan.

Stel policy.jsonc handmatig op; het wordt niet gegenereerd uit de huidige instellingen. Elke sectie op het hoogste niveau is een naamruimte voor regels: een controle wordt alleen uitgevoerd wanneer er een concrete regel in staat (niet-ondersteunde secties of sleutels mislukken met policy/policy-jsonc-invalid in plaats van stilzwijgend te worden genegeerd). Minimaal voorbeeld dat elke ondersteunde sectie omvat:

{  "channels": {    "denyRules": [      {        "id": "no-telegram",        "when": { "provider": "telegram" },        "reason": "Telegram is not approved for this workspace.",      },    ],  },  "mcp": {    "servers": {      "allow": ["docs"],      "deny": ["untrusted"],    },  },  "models": {    "providers": {      "allow": ["openai", "anthropic"],      "deny": ["openrouter"],    },  },  "network": {    "privateNetwork": {      "allow": false,    },  },  "ingress": {    "session": {      "requireDmScope": "per-channel-peer",    },    "channels": {      "allowDmPolicies": ["pairing", "allowlist", "disabled"],      "denyOpenGroups": true,      "requireMentionInGroups": true,    },  },  "gateway": {    "exposure": {      "allowNonLoopbackBind": false,      "allowTailscaleFunnel": false,    },    "auth": {      "requireAuth": true,      "requireExplicitRateLimit": true,    },    "controlUi": {      "allowInsecure": false,    },    "remote": {      "allow": false,    },    "http": {      "denyEndpoints": ["chatCompletions", "responses"],      "requireUrlAllowlists": true,    },    "nodes": {      "denyCommands": ["system.run"],    },  },  "agents": {    "workspace": {      "allowedAccess": ["none", "ro"],      "denyTools": ["exec", "process", "write", "edit", "apply_patch"],    },  },  "dataHandling": {    "sensitiveLogging": {      "requireRedaction": true,    },    "telemetry": {      "denyContentCapture": true,    },    "retention": {      "requireSessionMaintenance": true,    },    "memory": {      "denySessionTranscriptIndexing": true,    },  },  "secrets": {    "requireManagedProviders": true,    "denySources": ["exec"],    "allowInsecureProviders": false,  },  "auth": {    "profiles": {      "requireMetadata": ["provider", "mode"],      "allowModes": ["api_key", "token"],    },  },  "execApprovals": {    "requireFile": true,    "defaults": { "allowSecurity": ["deny"] },    "agents": {      "allowSecurity": ["deny", "allowlist"],      "allowAutoAllowSkills": false,      "allowlist": { "expected": ["deploy", "status"] },    },  },  "tools": {    "requireMetadata": ["risk", "sensitivity", "owner"],    "profiles": {      "allow": ["messaging", "minimal"],    },    "fs": {      "requireWorkspaceOnly": true,    },    "exec": {      "allowSecurity": ["deny", "allowlist"],      "requireAsk": ["always"],      "allowHosts": ["sandbox"],    },    "elevated": {      "allow": false,    },    "denyTools": ["group:runtime", "group:fs"],  },}

Overkoepelende opmerkingen die niet duidelijk blijken uit de onderstaande regeltabellen:

• Als u gateway.bind weglaat terwijl u niet-loopbackbindingen weigert, accepteert u de standaardwaarde van de runtime; stel gateway.bind: "loopback" in voor strikte conformiteit.
• Stel voor een alleen-lezenagent de sandbox-mode in op all of non-main bij de toepasselijke standaardwaarden of agent en stel workspaceAccess in op none of ro. Een ontbrekende sandboxmodus of de modus off voldoet niet aan beleid voor alleen-lezengebruik.
• agents.workspace.denyTools accepteert exec, process, write, edit, apply_patch. De groepen voor het weigeren van configuratietools group:fs (bestandswijziging) en group:runtime (shell/proces) voldoen aan de gelijkwaardige houding.
• Controles voor uitvoeringsgoedkeuringen lezen het actieve artefact exec-approvals.json alleen wanneer een execApprovals-regel aanwezig is; een ontbrekend of ongeldig artefact is niet-observeerbaar bewijs, geen kunstmatig geslaagde controle.
• Bewijs voor geheimen en authenticatieprofielen registreert alleen de houding van providers/bronnen en SecretRef-metagegevens, nooit onbewerkte waarden. Policy leest of attesteert geen referentieopslagen per agent, zoals auth-profiles.json.
• Bewijs voor gegevensverwerking betreft alleen de houding op configuratieniveau (redactiemodus, schakelaar voor telemetrieverzameling, modus voor sessieonderhoud en instelling voor transcriptindexering). Het inspecteert geen logboeken, telemetrie-exports, transcripten of geheugenbestanden. Een schoon resultaat bewijst niet dat deze geen persoonsgegevens of geheimen bevatten.

Naslag voor Policy-regels

Elke onderstaande regel is optioneel; een controle wordt alleen uitgevoerd wanneer de regel aanwezig is. De geobserveerde status bestaat uit de bestaande OpenClaw-configuratie of werkruimtemetagegevens.

Bereikgebonden overlays

Gebruik scopes.<scopeName> wanneer specifieke agents of kanalen strenger beleid nodig hebben dan de basislijn op het hoogste niveau. De bereiknaam is slechts een label; de overeenkomst gebruikt de selector binnen het bereik. Overlays zijn additief: de globale regel blijft actief en de bereikgebonden regel kan een eigen bevinding toevoegen voor hetzelfde bewijs.

Als een agentIds-vermelding niet aanwezig is in agents.list[], evalueert OpenClaw de bereikgebonden regel aan de hand van de overgenomen globale of standaardhouding voor die runtimeagent-id, in plaats van deze over te slaan.

{  "tools": {    "exec": {      "allowHosts": ["sandbox", "node"],    },  },  "sandbox": {    "requireMode": ["all", "non-main"],  },  "scopes": {    "release-workspace": {      "agentIds": ["release-agent", "review-agent"],      "agents": {        "workspace": {          "allowedAccess": ["none", "ro"],        },      },    },    "release-lockdown": {      "agentIds": ["release-agent"],      "tools": {        "exec": {          "allowHosts": ["sandbox"],          "allowSecurity": ["deny", "allowlist"],          "requireAsk": ["always"],        },        "denyTools": ["exec", "process", "write", "edit", "apply_patch"],      },      "sandbox": {        "requireMode": ["all"],        "allowBackends": ["docker"],      },      "dataHandling": {        "memory": {          "denySessionTranscriptIndexing": true,        },      },    },    "shell-sandbox": {      "agentIds": ["shell-agent"],      "sandbox": {        "allowBackends": ["openshell"],        "containers": {          "requireReadOnlyMounts": false,        },      },    },    "telegram-ingress": {      "channelIds": ["telegram"],      "ingress": {        "channels": {          "allowDmPolicies": ["pairing"],          "denyOpenGroups": true,          "requireMentionInGroups": true,        },      },    },  },}

Dezelfde agent kan in meerdere bereiken voorkomen als elk bereik een ander veld beheert, zoals hierboven. Een herhaald bereikgebonden veld voor dezelfde agent moet even streng of strenger zijn; een zwakkere dubbele claim wordt afgewezen (toestemmingslijsten zijn deelverzamelingen, weigeringslijsten zijn superverzamelingen en vereiste booleaanse waarden staan vast).

Regels voor de containerhouding (sandbox.containers.*) worden alleen gecontroleerd aan de hand van bewijs dat de sandboxbackend van de overeenkomende agent beschikbaar kan maken. Als een backend een regel die u ervoor hebt ingeschakeld niet kan observeren, meldt Policy policy/sandbox-container-posture-unobservable in plaats van de controle te laten slagen; beperk containerregels tot de agentgroepen die een backend gebruiken welke deze beschikbaar kan maken.

ingress.session.requireDmScope op het hoogste niveau blijft globaal; session.dmScope is geen bewijs dat aan een kanaal kan worden toegeschreven en kan daarom niet via channelIds tot een bereik worden beperkt.

Elk bereik in policy.jsonc moet geldig en afdwingbaar zijn.

Kanalen

MCP-servers

Modelproviders

Netwerk

Inkomende toegang en kanaaltoegang

Gateway

gateway.nodes.denyCommands is een exacte, hoofdlettergevoelige regel waarbij de weigerlijst een bovenverzameling moet zijn. Gebruik deze wanneer het beleid moet aantonen dat bevoorrechte Node-opdrachten expliciet door de OpenClaw-configuratie worden geweigerd. Voor een implementatie die opzettelijk een bevoorrechte Node-opdracht toestaat, moet policy.jsonc na beoordeling worden bijgewerkt in plaats van uitsluitend op gateway.nodes.allowCommands te vertrouwen.

Agentwerkruimte

Sandboxhouding

Het beleid behandelt een ontbrekende sandbox.mode als de impliciete standaardwaarde off. Daardoor rapporteert sandbox.requireMode een nieuwe of niet-geconfigureerde sandbox als buiten een toestaanlijst zoals ["all"].

Gegevensverwerking

Geheimen

Exec-goedkeuringen

Controles voor exec-goedkeuringen lezen het runtime-artefact exec-approvals.json: standaard ~/.openclaw/exec-approvals.json, of $OPENCLAW_STATE_DIR/exec-approvals.json wanneer OPENCLAW_STATE_DIR is ingesteld. Houdingsregels onder execApprovals.defaults.* of execApprovals.agents.* vereisen leesbaar bewijs uit het artefact; een ontbrekend of ongeldig artefact wordt gerapporteerd als niet-waarneembaar bewijs en niet als een best-effortgoedkeuring. Zodra het artefact leesbaar is, nemen weggelaten velden de runtime-standaardwaarden over: ontbrekende defaults.security is full en ontbrekende agentbeveiliging neemt die standaardwaarde over. Het bewijs omvat defaults, agents.*, agents.*.allowlist[].pattern, optioneel argPattern, de effectieve houding voor autoAllowSkills en de bron van de vermelding — nooit het socketpad/token, commandText, lastUsedCommand, opgeloste paden of tijdstempels.

Voorbeeld: vereis het goedkeuringsartefact, weiger permissieve standaardwaarden en sta voor geselecteerde agents alleen een beoordeelde houding voor exec-goedkeuringen toe.

{  "execApprovals": {    "requireFile": true,    "defaults": {      // Beveiligingsmodi: "deny", "allowlist" of "full".      // Deze standaardinstelling staat alleen de strikt vergrendelde deny-houding toe.      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // Geselecteerde agents mogen een beoordeelde allowlist-houding gebruiken, maar niet "full".          "allowSecurity": ["allowlist"],          // false betekent dat CLI's van Skills in de beoordeelde allowlist moeten staan in plaats van          // impliciet te worden goedgekeurd door autoAllowSkills.          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // Eenvoudige vermelding: exact beoordeeld uitvoerbaar patroon zonder argPattern.              "travel-hub",              // Beperkte vermelding: patroon plus beoordeelde reguliere expressie voor argumenten.              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

Authenticatieprofielen

Toolmetadata

Toolhouding

Controles uitvoeren

Voer tijdens het opstellen alleen beleidscontroles uit:

openclaw policy checkopenclaw policy check --jsonopenclaw policy check --severity-min error

policy check voert alleen de verzameling beleidscontroles uit en geeft bewijsmateriaal, bevindingen en attestatiehashes weer. Dezelfde bevindingen verschijnen ook in openclaw doctor --lint wanneer de Policy-plugin is ingeschakeld.

Vergelijk een beleidsbestand van een beheerder met een opgestelde basislijn:

openclaw policy compare --baseline official.policy.jsoncopenclaw policy compare --baseline official.policy.jsonc --policy policy.jsonc --json

policy compare controleert de syntaxis van een beleidsbestand ten opzichte van de syntaxis van een beleidsbestand; het inspecteert geen runtimestatus, bewijsmateriaal, aanmeldgegevens of geheimen. Het gebruikt dezelfde regelmetadata die beheerde overschrijvingen per bereik regelt: allowlists moeten gelijk of beperkter blijven, denylists moeten gelijk of ruimer blijven, verplichte booleaanse waarden moeten hun waarde behouden, geordende tekenreeksen mogen alleen naar het strengere einde van de geconfigureerde volgorde verschuiven en exacte lijsten moeten overeenkomen. De basislijn kan een door een organisatie opgesteld beleid zijn; het gecontroleerde beleid mag strengere waarden of extra regels toevoegen. Een gecontroleerde regel op het hoogste niveau kan voldoen aan een regel met bereik in de basislijn wanneer deze even restrictief of restrictiever is. Bereiknamen hoeven tussen bestanden niet overeen te komen; vergelijking gebeurt op selector (agentIds/channelIds) en veld.

Schone vergelijking (--json):

{  "ok": true,  "baselinePath": "official.policy.jsonc",  "policyPath": "policy.jsonc",  "rulesChecked": 3,  "findings": []}

Schone uitvoer van policy check --json bevat stabiele hashes die een beheerder of toezichthouder kan vastleggen:

{  "ok": true,  "attestation": {    "policy": {      "path": "policy.jsonc",      "hash": "sha256:..."    },    "workspace": {      "scope": "policy",      "hash": "sha256:..."    },    "findingsHash": "sha256:...",    "attestationHash": "sha256:..."  },  "checksRun": 5,  "checksSkipped": 0,  "findings": []}

Beleid configureren

De beleidsconfiguratie staat onder plugins.entries.policy.config.

{  "plugins": {    "entries": {      "policy": {        "enabled": true,        "config": {          "enabled": true,          "path": "policy.jsonc",          "workspaceRepairs": false,          "expectedHash": "sha256:...",          "expectedAttestationHash": "sha256:...",        },      },    },  },}

Stel plugins.entries.policy.config.enabled in op false om beleidscontroles voor een werkruimte uit te schakelen terwijl de plugin geïnstalleerd blijft.

Beleidsstatus accepteren

Voorbeeld van JSON-uitvoer:

{  "ok": true,  "attestation": {    "checkedAt": "2026-05-10T20:00:00.000Z",    "policy": {      "path": "policy.jsonc",      "hash": "sha256:..."    },    "workspace": {      "scope": "policy",      "hash": "sha256:..."    },    "findingsHash": "sha256:...",    "attestationHash": "sha256:..."  },  "evidence": {    "channels": [      {        "id": "telegram",        "provider": "telegram",        "source": "oc://openclaw.config/channels/telegram",        "enabled": false      }    ],    "mcpServers": [      {        "id": "docs",        "transport": "stdio",        "source": "oc://openclaw.config/mcp/servers/docs",        "command": "npx"      }    ],    "modelProviders": [      {        "id": "openai",        "source": "oc://openclaw.config/models/providers/openai"      }    ],    "modelRefs": [      {        "ref": "openai/gpt-5.6-sol",        "provider": "openai",        "model": "gpt-5.6-sol",        "source": "oc://openclaw.config/agents/defaults/model"      }    ],    "network": [      {        "id": "browser-private-network",        "source": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",        "value": false      }    ],    "gatewayExposure": [      {        "id": "gateway-bind",        "kind": "bind",        "source": "oc://openclaw.config/gateway/bind",        "value": "loopback",        "nonLoopback": false,        "explicit": true      }    ],    "agentWorkspace": [      {        "id": "agents-defaults-workspace-access",        "kind": "workspaceAccess",        "source": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",        "scope": "defaults",        "value": "ro",        "sandboxMode": "all",        "sandboxModeSource": "oc://openclaw.config/agents/defaults/sandbox/mode",        "sandboxEnabled": true,        "explicit": true      },      {        "id": "agents-defaults-tool-exec",        "kind": "toolDeny",        "source": "oc://openclaw.config/tools/deny",        "scope": "defaults",        "tool": "exec",        "denied": true,        "explicit": true      }    ],    "secrets": [      {        "id": "vault",        "kind": "provider",        "source": "oc://openclaw.config/secrets/providers/vault",        "providerSource": "env"      },      {        "id": "oc://openclaw.config/models/providers/openai/apiKey",        "kind": "input",        "source": "oc://openclaw.config/models/providers/openai/apiKey",        "provenance": "secretRef",        "refSource": "env",        "refProvider": "vault"      }    ],    "authProfiles": [      {        "id": "github",        "source": "oc://openclaw.config/auth/profiles/github",        "validMetadata": true,        "provider": "github",        "mode": "token"      }    ],    "tools": [      {        "id": "deploy",        "source": "oc://TOOLS.md/tools/deploy",        "line": 12,        "risk": "critical",        "sensitivity": "restricted",        "capabilities": ["IRREVERSIBLE_EXTERNAL"]      }    ]  },  "checksRun": 30,  "checksSkipped": 0,  "findings": []}

attestation.policy.hash identificeert het opgestelde regelartefact. evidence legt de waargenomen OpenClaw-status vast die door de controles is gebruikt, en workspace.hash identificeert die bewijslast. findingsHash identificeert de exacte verzameling bevindingen. checkedAt legt vast wanneer de controle is uitgevoerd. attestationHash identificeert de stabiele verklaring (beleidshash, bewijshash, bevindingenhash en schone/vervuilde status) en sluit checkedAt bewust uit, zodat dezelfde beleidsstatus altijd dezelfde attestatiehash oplevert. Samen vormen deze vier waarden de audittuple voor één beleidscontrole.

Als een Gateway of toezichthouder beleid gebruikt om een runtimeactie te blokkeren, goed te keuren of van een annotatie te voorzien, moet deze de attestatiehash van de laatste schone controle vastleggen. checkedAt blijft voor auditlogboeken in de JSON-uitvoer staan, maar maakt geen deel uit van de stabiele hash.

Levenscyclus voor het accepteren van de beleidsstatus:

1. Stel policy.jsonc op of beoordeel het.
2. Voer openclaw policy check --json uit.
3. Leg bij een schone controle attestation.policy.hash vast als expectedHash.
4. Leg attestation.attestationHash vast als expectedAttestationHash.
5. Voer openclaw doctor --lint opnieuw uit in CI- of releasepoorten.

Als beleidsregels bewust worden gewijzigd, werk dan beide geaccepteerde hashes bij op basis van een schone controle. Als alleen werkruimte-instellingen worden gewijzigd (het beleid blijft hetzelfde), verandert doorgaans alleen expectedAttestationHash.

Als u regels voor agents.workspace inschakelt of bijwerkt, wordt agentWorkspace-bewijs toegevoegd aan de werkruimtehash en attestatiehash; beoordeel het nieuwe bewijs en vernieuw de geaccepteerde attestatiehashes na het inschakelen. Als u regels voor de toolpostuur inschakelt of bijwerkt, wordt op dezelfde manier toolPosture-bewijs toegevoegd.

openclaw policy watch voert de controle opnieuw uit en meldt wanneer het huidige bewijs niet meer overeenkomt met expectedAttestationHash:

openclaw policy watch --json

Gebruik --once in CI of scripts die één driftbeoordeling nodig hebben. Zonder --once wordt standaard elke twee seconden gecontroleerd; gebruik --interval-ms om het interval te wijzigen.

Bevindingen

Een bevinding kan zowel target (het waargenomen werkruimteonderdeel dat niet voldoet) als requirement (de opgestelde regel waardoor het een bevinding werd) bevatten. Beide zijn momenteel oc://-adresreeksen, maar de veldnamen beschrijven de beleidsrol en niet de adresindeling.

Voorbeelden van bevindingen:

{  "checkId": "policy/channels-denied-provider",  "severity": "error",  "message": "Channel 'telegram' uses denied provider 'telegram'.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/channels/telegram",  "target": "oc://openclaw.config/channels/telegram",  "requirement": "oc://policy.jsonc/channels/denyRules/#0",  "fixHint": "Telegram is not approved for this workspace."}

{  "checkId": "policy/tools-missing-risk-level",  "severity": "error",  "message": "TOOLS.md tool 'deploy' has no explicit risk classification.",  "source": "policy",  "path": "TOOLS.md",  "line": 12,  "ocPath": "oc://TOOLS.md/tools/deploy",  "target": "oc://TOOLS.md/tools/deploy",  "requirement": "oc://policy.jsonc/tools/requireMetadata"}

{  "checkId": "policy/mcp-unapproved-server",  "severity": "error",  "message": "MCP-server 'remote' staat niet op de acceptatielijst van het beleid.",  "source": "policy",  "path": "openclaw-configuratie",  "ocPath": "oc://openclaw.config/mcp/servers/remote",  "target": "oc://openclaw.config/mcp/servers/remote",  "requirement": "oc://policy.jsonc/mcp/servers/allow"}

{  "checkId": "policy/models-unapproved-provider",  "severity": "error",  "message": "Modelverwijzing 'anthropic/claude-sonnet-4.7' gebruikt de niet-goedgekeurde provider 'anthropic'.",  "source": "policy",  "path": "openclaw-configuratie",  "ocPath": "oc://openclaw.config/agents/defaults/model/fallbacks/#0",  "target": "oc://openclaw.config/agents/defaults/model/fallbacks/#0",  "requirement": "oc://policy.jsonc/models/providers/allow"}

{  "checkId": "policy/network-private-access-enabled",  "severity": "error",  "message": "Netwerkinstelling 'browser-private-network' staat toegang tot het privénetwerk toe.",  "source": "policy",  "path": "openclaw-configuratie",  "ocPath": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",  "target": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",  "requirement": "oc://policy.jsonc/network/privateNetwork/allow"}

{  "checkId": "policy/gateway-non-loopback-bind",  "severity": "error",  "message": "Gateway-bindingsinstelling 'gateway-bind' staat blootstelling buiten local loopback toe.",  "source": "policy",  "path": "openclaw-configuratie",  "ocPath": "oc://openclaw.config/gateway/bind",  "target": "oc://openclaw.config/gateway/bind",  "requirement": "oc://policy.jsonc/gateway/exposure/allowNonLoopbackBind"}

{  "checkId": "policy/gateway-node-command-denied",  "severity": "error",  "message": "Gateway-nodeopdracht 'system.run' wordt door het beleid geweigerd, maar niet door de OpenClaw-configuratie.",  "source": "policy",  "path": "openclaw-configuratie",  "ocPath": "oc://openclaw.config/gateway/nodes/denyCommands",  "target": "oc://openclaw.config/gateway/nodes/denyCommands",  "requirement": "oc://policy.jsonc/gateway/nodes/denyCommands",  "fixHint": "Voeg 'system.run' toe aan gateway.nodes.denyCommands of werk het beleid na controle bij."}

{  "checkId": "policy/agents-workspace-access-denied",  "severity": "error",  "message": "De sandbox-werkruimtetoegang 'rw' van agents.defaults is volgens het beleid niet toegestaan.",  "source": "policy",  "path": "openclaw-configuratie",  "ocPath": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "target": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "requirement": "oc://policy.jsonc/agents/workspace/allowedAccess"}

Herstel

doctor --lint en policy check zijn alleen-lezen.

doctor --fix bewerkt alleen door beleid beheerde werkruimte-instellingen wanneer workspaceRepairs expliciet is ingeschakeld; anders melden controles wat ze zouden herstellen en blijven de instellingen ongewijzigd.

In deze versie kan herstel kanalen uitschakelen die door channels.denyRules worden geweigerd en de onderstaande automatische beperkingsreparaties toepassen. Schakel workspaceRepairs pas in nadat het beleidsbestand is gecontroleerd, omdat een geldige regel de werkruimteconfiguratie kan wijzigen:

• stel tools.elevated.enabled=false in wanneer algemeen beleid verhoogde hulpmiddelen verbiedt
• voeg ontbrekende, verplicht te weigeren hulpmiddel-id's toe aan tools.deny of agents.list[].tools.deny wanneer het beleid vereist dat die hulpmiddelen worden geweigerd
• stel onveilige gateway.controlUi.*-schakelaars in op false
• stel gateway.mode=local in wanneer het beleid de externe Gateway-modus weigert
• stel gemelde gateway.http.endpoints.*.enabled-paden in op false wanneer het beleid Gateway HTTP-API-eindpunten weigert
• stel gemelde groupPolicy-paden voor inkomend kanaalverkeer in op allowlist wanneer het beleid open inkomend groepsverkeer weigert
• stel gemelde requireMention-paden voor inkomend kanaalverkeer in op true wanneer het beleid vermeldingen in groepen vereist
• stel logging.redactSensitive=tools in wanneer het beleid anonimisering van gevoelige loggegevens vereist
• stel diagnostics.otel.captureContent=false in, of diagnostics.otel.captureContent.enabled=false voor telemetrie- opname-instellingen in objectvorm, wanneer het beleid de opname van telemetrie-inhoud weigert

Herstel van verhoogde hulpmiddelen met een beperkt bereik wordt alleen gedetecteerd. Herstel van gegevensverwerking met een beperkt bereik wordt eveneens overgeslagen wanneer de bevinding gedeelde logboek- of telemetrieconfiguratie meldt, omdat het wijzigen van de gedeelde instelling meer zou beïnvloeden dan het beleidsdoel met beperkt bereik.

Herstel van verplichte weigeringen met een beperkt bereik wordt overgeslagen wanneer de bevinding overgenomen tools.deny op hoofdniveau meldt, omdat het toevoegen van het vereiste hulpmiddel aan de hoofdconfiguratie meer zou beïnvloeden dan het beleidsdoel met beperkt bereik. Herstel van verplichte weigeringen op agentniveau kan het gemelde pad agents.list[].tools.deny bijwerken.

Herstel van inkomend kanaalverkeer met een beperkt bereik wordt overgeslagen wanneer de bevinding overgenomen channels.defaults.* meldt, omdat het wijzigen van de gedeelde kanaalstandaard meer zou beïnvloeden dan het beleidsdoel met beperkt bereik. Bevindingen over acceptatielijsten voor het ophalen van URL's via Gateway HTTP blijven handmatig, omdat automatisch herstel niet de juiste acceptatielijstwaarden voor eindpunt-URL's kan kiezen.

Bevindingen voor Gateway-bindingen en nodeopdrachten blijven een controle vereisen. Wanneer policy/gateway-non-loopback-bind of policy/gateway-node-command-denied aan een configuratiepad kan worden gekoppeld, meldt doctor --fix de voorgestelde wijziging van gateway.bind of gateway.nodes.denyCommands als overgeslagen voorbeeldrichtlijn. De wijziging wordt niet toegepast en de bevinding geldt pas als hersteld nadat een beheerder de configuratie of het beleid heeft gecontroleerd en bijgewerkt.

{  "plugins": {    "entries": {      "policy": {        "config": {          "workspaceRepairs": true,        },      },    },  },}

Afsluitcodes

Gerelateerd

• Lintmodus van Doctor
• Pad-CLI