openclaw policy

openclaw policy, paketle birlikte sunulan Policy Plugin tarafından sağlanır. Mevcut OpenClaw ayarlarının üzerinde çalışan kurumsal bir uygunluk katmanıdır; ikinci bir yapılandırma sistemi değildir. Gereksinimleri policy.jsonc içinde tanımlarsınız; OpenClaw etkin çalışma alanını kanıt olarak gözlemler; policy, sapmaları doctor --lint aracılığıyla bildirir. Policy, araç çağrılarını zorunlu kılmaz veya istek sırasında çalışma zamanı davranışını yeniden yazmaz ve auth-profiles.json gibi ajan başına kimlik bilgisi depolarını tasdik etmez.

Policy; yapılandırılmış kanalları, MCP sunucularını, model sağlayıcılarını, ağ SSRF duruşunu, giriş/kanal erişimini, Gateway erişilebilirliğini ve node komut duruşunu, ajan çalışma alanı erişimini, sandbox duruşunu, veri işleme duruşunu, gizli bilgi sağlayıcısı/kimlik doğrulama profili duruşunu ve yönetilen araç meta verilerini (TOOLS.md) denetler. Bir çalışma alanının "Telegram etkinleştirilmemelidir" veya "yönetilen araçlar risk ve sahip meta verilerini belirtmelidir" gibi kalıcı ve denetlenebilir bir beyana ihtiyaç duyduğu durumlarda kullanın. Tasdik veya sapma algılama olmadan yalnızca yerel davranışa ihtiyacınız varsa normal yapılandırma yeterlidir.

Hızlı başlangıç

openclaw plugins enable policy

Plugin, policy.jsonc bulunmadığında da etkin kalır; böylece doctor, denetimleri sessizce atlamak yerine eksik yapıtı bildirebilir.

policy.jsonc dosyasını elle oluşturun; mevcut ayarlardan üretilmez. Her üst düzey bölüm bir kural ad alanıdır: denetim yalnızca altında somut bir kural bulunduğunda çalışır (desteklenmeyen bölümler veya anahtarlar sessizce yok sayılmak yerine policy/policy-jsonc-invalid hatasıyla başarısız olur). Desteklenen tüm bölümleri kapsayan en küçük örnek:

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

Aşağıdaki kural tablolarından açıkça anlaşılmayan, birden fazla alanı ilgilendiren notlar:

• Geri döngü dışı bağlamaları reddederken gateway.bind öğesini atlamak, çalışma zamanı varsayılanını kabul ettiğiniz anlamına gelir; katı uygunluk için gateway.bind: "loopback" ayarını yapın.
• Salt okunur bir ajan için ilgili varsayılanlarda/ajanda sandbox mode değerini all veya non-main, workspaceAccess değerini ise none veya ro olarak ayarlayın. Eksik veya off sandbox modu, salt okunur policy gereksinimini karşılamaz.
• agents.workspace.denyTools; exec, process, write, edit, apply_patch değerlerini kabul eder. Yapılandırmadaki araç reddetme grupları group:fs (dosya değiştirme) ve group:runtime (kabuk/işlem), eşdeğer duruşu karşılar.
• Çalıştırma onayı denetimleri, yalnızca bir execApprovals kuralı mevcut olduğunda canlı exec-approvals.json yapıtını okur; eksik veya geçersiz bir yapıt, yapay bir başarılı sonuç değil, gözlemlenemeyen kanıttır.
• Gizli bilgi ve kimlik doğrulama profili kanıt kayıtları yalnızca sağlayıcı/kaynak duruşunu ve SecretRef meta verilerini kaydeder; ham değerleri hiçbir zaman kaydetmez. Policy, auth-profiles.json gibi ajan başına kimlik bilgisi depolarını okumaz veya tasdik etmez.
• Veri işleme kanıtı yalnızca yapılandırma düzeyindeki duruştur (maskeleme modu, telemetri yakalama anahtarı, oturum bakım modu, döküm indeksleme ayarı). Günlükleri, telemetri dışa aktarımlarını, dökümleri veya bellek dosyalarını incelemez ve temiz bir sonuç bunlarda kişisel veri veya gizli bilgi bulunmadığını kanıtlamaz.

Policy kural başvurusu

Aşağıdaki her kural isteğe bağlıdır; denetim yalnızca kural mevcut olduğunda çalışır. Gözlemlenen durum, mevcut OpenClaw yapılandırması veya çalışma alanı meta verileridir.

Kapsamlı katmanlar

Belirli ajanlar veya kanallar üst düzey taban çizgisinden daha katı bir policy gerektirdiğinde scopes.<scopeName> kullanın. Kapsam adı yalnızca bir etikettir; eşleştirme, kapsam içindeki seçiciyi kullanır. Katmanlar eklemelidir: genel kural çalışmaya devam eder ve kapsamlı kural aynı kanıta karşı kendi bulgusunu ekleyebilir.

Bir agentIds girdisi agents.list[] içinde yoksa OpenClaw kapsamlı kuralı atlamak yerine o çalışma zamanı ajan kimliği için devralınan genel/varsayılan duruşa göre değerlendirir.

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

Yukarıdaki gibi, her kapsam farklı bir alanı yönetiyorsa aynı ajan birden fazla kapsamda yer alabilir. Aynı ajan için yinelenen kapsamlı bir alan eşit derecede veya daha kısıtlayıcı olmalıdır; daha zayıf bir yinelenen beyan reddedilir (izin listeleri alt kümeler, ret listeleri üst kümeler olmalı; zorunlu Boolean değerleri sabittir).

Kapsayıcı duruş kuralları (sandbox.containers.*) yalnızca eşleşen ajanın sandbox arka ucunun sunabildiği kanıtlara göre denetlenir. Bir arka uç, kendisi için etkinleştirdiğiniz bir kuralı gözlemleyemiyorsa policy başarılı saymak yerine policy/sandbox-container-posture-unobservable bildirir; kapsayıcı kurallarını, bunları sunabilen bir arka uç kullanan ajan gruplarıyla kapsamlandırın.

Üst düzey ingress.session.requireDmScope genel kalır; session.dmScope kanala atfedilebilir bir kanıt olmadığından channelIds ile kapsamlandırılamaz.

policy.jsonc içinde bulunan her kapsam geçerli ve uygulanabilir olmalıdır.

Kanallar

MCP sunucuları

Model sağlayıcıları

Ağ

Giriş ve kanal erişimi

Gateway

gateway.nodes.denyCommands, tam eşleşmeye ve büyük/küçük harfe duyarlı bir reddetme üst kümesi kuralıdır. İlkenin, ayrıcalıklı Node komutlarının OpenClaw yapılandırması tarafından açıkça reddedildiğini kanıtlaması gerektiğinde bunu kullanın. Ayrıcalıklı bir Node komutuna kasıtlı olarak izin veren bir dağıtım, yalnızca gateway.nodes.allowCommands seçeneğine güvenmek yerine inceleme sonrasında policy.jsonc dosyasını güncellemelidir.

Aracı çalışma alanı

Sandbox duruşu

İlke, eksik sandbox.mode değerini örtük varsayılanı olan off şeklinde ele alır; bu nedenle sandbox.requireMode, yeni veya yapılandırılmamış bir sandbox'ı ["all"] gibi bir izin listesinin dışında olarak bildirir.

Veri İşleme

Gizli değerler

Exec onayları

Exec onayı denetimleri, çalışma zamanı exec-approvals.json yapıtını okur: varsayılan olarak ~/.openclaw/exec-approvals.json veya OPENCLAW_STATE_DIR ayarlandığında $OPENCLAW_STATE_DIR/exec-approvals.json. execApprovals.defaults.* veya execApprovals.agents.* altındaki duruş kuralları, okunabilir yapıt kanıtı gerektirir; eksik veya geçersiz bir yapıt, en iyi çabaya dayalı bir başarı yerine gözlemlenemeyen kanıt olarak bildirilir. Yapıt okunabilir olduğunda, atlanmış alanlar çalışma zamanı varsayılanlarını devralır: eksik defaults.security değeri full olur ve eksik aracı güvenliği bu varsayılanı devralır. Kanıt; defaults, agents.*, agents.*.allowlist[].pattern, isteğe bağlı argPattern, etkin autoAllowSkills duruşu ve giriş kaynağını içerir; soket yolu/belirteci, commandText, lastUsedCommand, çözümlenmiş yollar veya zaman damgalarını asla içermez.

Örnek: onay yapıtını zorunlu kılın, izin verici varsayılanları reddedin ve yalnızca seçilen aracılar için incelenmiş Exec onayı duruşuna izin verin.

{  "execApprovals": {    "requireFile": true,    "defaults": {      // Güvenlik modları: "deny", "allowlist" veya "full".      // Bu varsayılan yalnızca sıkı biçimde kısıtlanmış deny duruşuna izin verir.      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // Seçilen aracılar, gözden geçirilmiş allowlist duruşunu kullanabilir ancak "full" kullanamaz.          "allowSecurity": ["allowlist"],          // false, Skills CLI'larının autoAllowSkills tarafından örtük olarak onaylanmak yerine          // gözden geçirilmiş allowlist içinde bulunması gerektiği anlamına gelir.          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // Basit girdi: argPattern içermeyen, gözden geçirilmiş tam çalıştırılabilir dosya kalıbı.              "travel-hub",              // Kısıtlı girdi: kalıp ile gözden geçirilmiş bağımsız değişken düzenli ifadesi.              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

Kimlik doğrulama profilleri

Araç meta verileri

Araç duruşu

Denetimleri çalıştırma

Yazım sırasında yalnızca ilke denetimlerini çalıştırın:

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

policy check yalnızca ilke denetimi kümesini çalıştırır ve kanıtları, bulguları ve doğrulama karmalarını üretir. Aynı bulgular, Policy Plugin etkinleştirildiğinde openclaw doctor --lint içinde de görünür.

Bir operatör ilke dosyasını yazılmış bir temel değerle karşılaştırın:

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

policy compare, ilke dosyası sözdizimini ilke dosyası sözdizimiyle karşılaştırır; çalışma zamanı durumunu, kanıtları, kimlik bilgilerini veya gizli bilgileri incelemez. Kapsamlı katmanları yöneten aynı kural meta verilerini kullanır: izin listeleri aynı kalmalı veya daralmalı, engelleme listeleri aynı kalmalı veya genişlemeli, zorunlu Boole değerleri kendi değerlerini korumalı, sıralı dizeler yalnızca yapılandırılmış sıranın daha katı ucuna doğru ilerleyebilmeli ve tam listeler eşleşmelidir. Temel değer, kuruluş tarafından yazılmış bir ilke olabilir; denetlenen ilke daha katı değerler veya ek kurallar ekleyebilir. Üst düzey bir denetlenen kural, eşit veya daha kısıtlayıcıysa kapsamlı bir temel değer kuralını karşılayabilir. Kapsam adlarının dosyalar arasında eşleşmesi gerekmez; karşılaştırma, seçiciye (agentIds/channelIds) ve alana göre anahtarlanır.

Temiz karşılaştırma (--json):

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

Temiz policy check --json çıktısı, bir operatörün veya denetleyicinin kaydedebileceği kararlı karmaları içerir:

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

İlkeyi yapılandırma

İlke yapılandırması plugins.entries.policy.config altında bulunur.

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

Plugin kurulu kalırken bir çalışma alanındaki ilke denetimlerini devre dışı bırakmak için plugins.entries.policy.config.enabled değerini false olarak ayarlayın.

İlke durumunu kabul etme

Örnek JSON çıktısı:

{  "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, yazılmış kural yapıtını tanımlar. evidence, denetimler tarafından kullanılan gözlemlenmiş OpenClaw durumunu kaydeder ve workspace.hash bu kanıt yükünü tanımlar. findingsHash, tam bulgu kümesini tanımlar. checkedAt, denetimin ne zaman çalıştığını kaydeder. attestationHash, kararlı iddiayı (ilke karması, kanıt karması, bulgular karması ve temiz/kirli durum) tanımlar ve checkedAt değerini bilerek hariç tutar; böylece aynı ilke durumu her zaman aynı doğrulama karmasını üretir. Bu dört değer birlikte tek bir ilke denetiminin denetim demetini oluşturur.

Bir Gateway veya denetleyici, çalışma zamanı eylemini engellemek, onaylamak veya açıklama eklemek için ilke kullanıyorsa son temiz denetimin doğrulama karmasını kaydetmelidir. checkedAt, denetim günlükleri için JSON çıktısında kalır ancak kararlı karmanın parçası değildir.

İlke durumunu kabul etme yaşam döngüsü:

1. policy.jsonc dosyasını yazın veya gözden geçirin.
2. openclaw policy check --json komutunu çalıştırın.
3. Temizse attestation.policy.hash değerini expectedHash olarak kaydedin.
4. attestation.attestationHash değerini expectedAttestationHash olarak kaydedin.
5. CI veya sürüm kapılarında openclaw doctor --lint komutunu yeniden çalıştırın.

Politika kuralları kasıtlı olarak değişirse temiz bir denetimden elde edilen kabul edilmiş iki hash'i de güncelleyin. Yalnızca çalışma alanı ayarları değişirse (politika aynı kalırsa), genellikle yalnızca expectedAttestationHash değişir.

agents.workspace kurallarını etkinleştirmek veya yükseltmek, çalışma alanı hash'ine ve tasdik hash'ine agentWorkspace kanıtı ekler; etkinleştirdikten sonra yeni kanıtı inceleyin ve kabul edilmiş tasdik hash'lerini yenileyin. Araç duruşu kurallarını etkinleştirmek veya yükseltmek de aynı şekilde toolPosture kanıtı ekler.

openclaw policy watch, denetimi yeniden çalıştırır ve mevcut kanıt artık expectedAttestationHash ile eşleşmediğinde bunu bildirir:

openclaw policy watch --json

Tek bir sapma değerlendirmesi gerektiren CI veya betiklerde --once kullanın. --once olmadan varsayılan olarak iki saniyede bir yoklama yapar; aralığı değiştirmek için --interval-ms kullanın.

Bulgular

Bir bulgu hem target (uyumsuzluk gösteren gözlemlenmiş çalışma alanı öğesi) hem de requirement (bunun bulgu sayılmasına neden olan yazılmış kural) içerebilir. Günümüzde ikisi de oc:// adres dizeleridir ancak alan adları, adres biçiminden ziyade politika rolünü tanımlar.

Örnek bulgular:

{  "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' is not in the policy allowlist.",  "source": "policy",  "path": "openclaw config",  "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": "Model ref 'anthropic/claude-sonnet-4.7' uses unapproved provider 'anthropic'.",  "source": "policy",  "path": "openclaw config",  "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": "Network setting 'browser-private-network' allows private-network access.",  "source": "policy",  "path": "openclaw config",  "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 bind setting 'gateway-bind' permits non-loopback exposure.",  "source": "policy",  "path": "openclaw config",  "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 node command 'system.run' is denied by policy but not denied by OpenClaw config.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/gateway/nodes/denyCommands",  "target": "oc://openclaw.config/gateway/nodes/denyCommands",  "requirement": "oc://policy.jsonc/gateway/nodes/denyCommands",  "fixHint": "Add 'system.run' to gateway.nodes.denyCommands or update policy after review."}

{  "checkId": "policy/agents-workspace-access-denied",  "severity": "error",  "message": "agents.defaults sandbox workspaceAccess 'rw' is not allowed by policy.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "target": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "requirement": "oc://policy.jsonc/agents/workspace/allowedAccess"}

Onarım

doctor --lint ve policy check salt okunurdur.

doctor --fix, yalnızca workspaceRepairs açıkça etkinleştirildiğinde politika tarafından yönetilen çalışma alanı ayarlarını düzenler; aksi takdirde denetimler neleri onaracaklarını bildirir ve ayarları değiştirmeden bırakır.

Bu sürümde onarım, channels.denyRules tarafından reddedilen kanalları devre dışı bırakabilir ve aşağıda listelenen otomatik daraltma onarımlarını uygulayabilir. Geçerli bir kural çalışma alanı yapılandırmasını değiştirebileceğinden, workspaceRepairs seçeneğini yalnızca politika dosyası incelendikten sonra etkinleştirin:

• genel bir politika yükseltilmiş araçları yasakladığında tools.elevated.enabled=false olarak ayarla
• politika bu araçların reddedilmesini gerektirdiğinde eksik zorunlu ret aracı kimliklerini tools.deny veya agents.list[].tools.deny öğesine ekle
• güvenli olmayan gateway.controlUi.* anahtarlarını false olarak ayarla
• politika uzak Gateway modunu reddettiğinde gateway.mode=local olarak ayarla
• politika Gateway HTTP API uç noktalarını reddettiğinde bildirilen gateway.http.endpoints.*.enabled yollarını false olarak ayarla
• politika açık grup girişini reddettiğinde bildirilen kanal girişi groupPolicy yollarını allowlist olarak ayarla
• politika grup bahsetmelerini gerektirdiğinde bildirilen kanal girişi requireMention yollarını true olarak ayarla
• politika hassas günlük kaydı verilerinin gizlenmesini gerektirdiğinde logging.redactSensitive=tools olarak ayarla
• politika telemetri içeriği yakalamayı reddettiğinde diagnostics.otel.captureContent=false veya nesne biçimindeki telemetri yakalama ayarları için diagnostics.otel.captureContent.enabled=false olarak ayarla

Kapsamlı yükseltilmiş araç onarımları yalnızca algılama amaçlıdır. Bulgu paylaşılan günlük kaydı veya telemetri yapılandırmasını bildirdiğinde kapsamlı veri işleme onarımları da atlanır; çünkü paylaşılan ayarın değiştirilmesi, kapsamlı politika hedefinden daha fazlasını etkiler.

Bulgu devralınan kök tools.deny öğesini bildirdiğinde kapsamlı zorunlu ret onarımları atlanır; çünkü gerekli aracın kök yapılandırmasına eklenmesi, kapsamlı politika hedefinden daha fazlasını etkiler. Aracıya özgü zorunlu ret onarımları, bildirilen agents.list[].tools.deny yolunu güncelleyebilir.

Bulgu devralınan channels.defaults.* öğesini bildirdiğinde kapsamlı kanal girişi onarımları atlanır; çünkü paylaşılan kanal varsayılanının değiştirilmesi, kapsamlı politika hedefinden daha fazlasını etkiler. Gateway HTTP URL getirme izin listesi bulguları manuel olarak kalır; çünkü otomatik onarım doğru uç nokta URL izin listesi değerlerini seçemez.

Gateway bağlama ve Node komutu bulguları inceleme gerektirmeye devam eder. policy/gateway-non-loopback-bind veya policy/gateway-node-command-denied bir yapılandırma yoluyla eşleştirilebildiğinde, doctor --fix önerilen gateway.bind veya gateway.nodes.denyCommands değişikliğini atlanmış önizleme rehberliği olarak bildirir. Değişikliği uygulamaz ve bir operatör yapılandırmayı veya politikayı inceleyip güncelleyene kadar bulgu onarılmış sayılmaz.

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

Çıkış kodları

İlgili

• Doctor lint modu
• Yol CLI'si