`openclaw policy`

openclaw policy, paketle gelen Policy plugin tarafından sağlanır. Mevcut OpenClaw ayarları üzerinde çalışan kurumsal bir uyumluluk 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, tanımlanmış mesaj yönlendirme yoklamalarını, ajan çalışma alanı erişimini, korumalı alan duruşunu, veri işleme duruşunu, gizli bilgi sağlayıcısı/kimlik doğrulama profili duruşunu ve yönetişim altındaki araç meta verilerini (TOOLS.md) denetler. Bir çalışma alanında “Telegram etkinleştirilmemelidir” veya “yönetişim altındaki araçlar risk ve sahip meta verilerini bildirmelidir” gibi kalıcı ve denetlenebilir bir beyan gerektiğinde bunu kullanın. Tasdik veya sapma algılama olmadan yalnızca yerel davranış gerekiyorsa düz yapılandırma yeterlidir.

Hızlı başlangıç

openclaw plugins enable policy

Plugin, policy.jsonc eksik olduğunda bile etkin kalır; böylece doctor, denetimleri sessizce atlamak yerine eksik yapıtı bildirebilir. policy.jsonc dosyasını elle oluşturun; mevcut ayarlardan oluşturulmaz. Her üst düzey bölüm bir kural ad alanıdır: bir 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 olarak başarısız olur). Desteklenen tüm bölümleri kapsayan asgari örnek:

{
  "channels": {
    "denyRules": [
      {
        "id": "no-telegram",
        "when": { "provider": "telegram" },
        "reason": "Telegram bu çalışma alanı için onaylanmamıştır.",
      },
    ],
  },
  "mcp": {
    "servers": {
      "allow": ["docs"],
      "deny": ["untrusted"],
    },
  },
  "models": {
    "providers": {
      "allow": ["openai", "anthropic"],
      "deny": ["openrouter"],
    },
  },
  "network": {
    "privateNetwork": {
      "allow": false,
    },
  },
  "routing": {
    "requireBindings": true,
    "requireConfiguredChannels": true,
    "probes": [
      {
        "id": "family-dm",
        "route": {
          "channel": "imessage",
          "peer": { "kind": "direct", "id": "+15555550123" },
        },
        "expect": {
          "agentId": "family",
          "matchedBy": ["binding.peer"],
        },
      },
    ],
  },
  "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 kolayca anlaşılamayan genel notlar:

Geri döngü dışı bağlamaları reddederken gateway.bind değerini belirtmemek, çalışma zamanı varsayılanını kabul ettiğiniz anlamına gelir; katı uyumluluk için gateway.bind: "loopback" değerini ayarlayın.
Salt okunur bir ajan için geçerli varsayılanlarda/ajanda korumalı alan mode değerini all veya non-main, workspaceAccess değerini ise none veya ro olarak ayarlayın. Eksik veya off korumalı alan modu, salt okunur bir politikayı karşılamaz.
agents.workspace.denyTools; exec, process, write, edit ve 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.
Yürütme 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ıtları yalnızca sağlayıcı/kaynak duruşunu ve SecretRef meta verilerini kaydeder; ham değerleri asla 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, transkript dizinleme ayarı). Günlükleri, telemetri dışa aktarımlarını, transkriptleri veya bellek dosyalarını incelemez ve temiz bir sonuç, bunlarda kişisel veri veya gizli bilgi bulunmadığını kanıtlamaz.
Yönlendirme yoklamaları, OpenClaw’ın çalışma zamanı bağlama çözümleyicisini yeniden kullanır. Yönlendirme kanıtı yalnızca yoklama kimliğini, çözümlenen ajanı, eşleşme türünü ve maskelenmiş bağlama meta verilerini kaydeder. Eş, hesap, lonca, takım veya rol tanımlayıcılarını asla kaydetmez. Bir yönlendirme bölümü eklemek, politika ve tasdik karmalarını bilinçli olarak değiştirir; yönlendirme içermeyen politikalar mevcut kanıt biçimlerini korur.

Politika kuralı başvurusu

Aşağıdaki her kural isteğe bağlıdır; bir 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 temel çizgiden daha katı bir politikaya ihtiyaç duyduğunda scopes.<scopeName> kullanın. Kapsam adı yalnızca bir etikettir; eşleştirme, kapsam içindeki seçiciyi kullanır. Katmanlar birikimlidir: genel kural çalışmaya devam eder ve kapsamlı kural aynı kanıta karşı kendi bulgusunu ekleyebilir.

Seçici	Desteklenen bölümler	Kullanım amacı
`agentIds`	`tools`, `agents.workspace`, `sandbox`, `dataHandling.memory`, `execApprovals`	Bir veya daha fazla çalışma zamanı ajanı daha katı kurallara ihtiyaç duyduğunda.
`channelIds`	`ingress.channels`	Bir veya daha fazla kanal daha katı giriş kurallarına ihtiyaç duyduğunda.

Bir agentIds girdisi agents.entries.* içinde mevcut değilse OpenClaw, kapsamlı kuralı atlamak yerine söz konusu ç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 iddia reddedilir (izin listeleri alt kümeler, ret listeleri üst kümelerdir; gerekli Boole değerleri sabittir). Kapsayıcı duruş kuralları (sandbox.containers.*) yalnızca eşleşen ajanın korumalı alan 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 sınırlayın. Üst düzey ingress.session.requireDmScope genel kalır; session.dmScope, kanala atfedilebilir bir kanıt değildir, bu nedenle channelIds ile kapsamlandırılamaz. policy.jsonc içinde bulunan her kapsam geçerli ve uygulanabilir olmalıdır.

Kanallar

Politika alanı	Gözlemlenen durum	Kullanım amacı
`channels.denyRules[].when.provider`	`channels.*` sağlayıcısı ve etkin durumu	`telegram` gibi bir sağlayıcının yapılandırılmış kanallarını reddetmek için.
`channels.denyRules[].reason`	Bulgu iletisi ve düzeltme ipucu bağlamı	Sağlayıcının neden reddedildiğini açıklamak için.

MCP sunucuları

Politika alanı	Gözlemlenen durum	Kullanım amacı
`mcp.servers.allow`	`mcp.servers.*` kimlikleri	Yapılandırılmış her MCP sunucusunun bir izin listesinde bulunmasını zorunlu kılmak için.
`mcp.servers.deny`	`mcp.servers.*` kimlikleri	Yapılandırılmış belirli MCP sunucusu kimliklerini reddetmek için.

Model sağlayıcıları

Politika alanı	Gözlemlenen durum	Kullanım amacı
`models.providers.allow`	`models.providers.*` kimlikleri ve seçilen model başvuruları	Yapılandırılmış sağlayıcıların ve seçilen model başvurularının onaylı sağlayıcıları kullanmasını zorunlu kılmak için.
`models.providers.deny`	`models.providers.*` kimlikleri ve seçilen model başvuruları	Yapılandırılmış sağlayıcıları ve seçilen model başvurularını sağlayıcı kimliğine göre reddetmek için.

Ağ

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`network.privateNetwork.allow`	Özel ağ SSRF kaçış yolları	Özel ağ erişiminin devre dışı kalmasını zorunlu kılmak için `false` olarak ayarlayın.

İleti yönlendirme

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`routing.requireBindings`	ACP bağlamaları hariç kanal rota bağlamaları	En az bir ileti yönlendirme bağlamasını zorunlu kılın.
`routing.requireConfiguredChannels`	Bağlama kanal kimlikleri ve yapılandırılmış `channels.*` kimlikleri	Eski veya yanlış yazılmış bağlama kanal kimliklerini tespit edin.
`routing.probes[].route`	Genel OpenClaw rota çözümleyicisi	İleti göndermeden temsili bir gelen rotayı açıklayın.
`routing.probes[].expect.agentId`	Çözümlenen aracı kimliği	Rotanın incelenen aracıya ulaşmasını zorunlu kılın.
`routing.probes[].expect.matchedBy`	Çözümleyici eşleşme türü	Eş, hesap, kanal veya incelenen başka bir bağlama özgüllüğünü zorunlu kılın.

Yoklama kimlikleri benzersiz olmalıdır. Bir rota channel, isteğe bağlı accountId, peer, parentPeer, guildId, teamId ve memberRoleIds öğelerini destekler. Eş türleri direct, group ve channel şeklindedir. matchedBy, binding.peer, binding.account, binding.channel veya default dahil olmak üzere bir ya da daha fazla çalışma zamanı eşleşme türü içerebilir. Yönlendirme denetimleri yalnızca uygunluk denetimleridir. Başlatma, ileti teslimi, bağlama önceliği veya geri dönüş davranışını değiştirmezler. Bir bağlamanın otomatik olarak değiştirilmesi özel iletileri yeniden yönlendirebileceğinden bulgular operatör incelemesi gerektirir.

Giriş ve kanal erişimi

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`ingress.session.requireDmScope`	`session.dmScope`	İncelenmiş bir doğrudan ileti yalıtım kapsamını zorunlu kılın.
`ingress.channels.allowDmPolicies`	`channels.*.dmPolicy` ve eski kanal DM ilkesi alanları	Yalnızca incelenmiş doğrudan ileti kanal ilkelerine izin verin.
`ingress.channels.denyOpenGroups`	Kanal, hesap ve grup giriş ilkesi	Yapılandırılmış kanallar ve hesaplar için açık grup girişini reddedin.
`ingress.channels.requireMentionInGroups`	Kanal, hesap, grup, sunucu ve iç içe bahsetme kapısı yapılandırması	Grup girişi açık veya bahsetme kapılı olduğunda bahsetme kapılarını zorunlu kılın.

Gateway

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`gateway.exposure.allowNonLoopbackBind`	`gateway.bind`	Geri döngü Gateway bağlamasını zorunlu kılmak için `false` olarak ayarlayın.
`gateway.exposure.allowTailscaleFunnel`	Tailscale sunma/tünelleme Gateway duruşu	Tailscale Funnel erişimini reddetmek için `false` olarak ayarlayın.
`gateway.auth.requireAuth`	`gateway.auth.mode`	Devre dışı bırakılmış Gateway kimlik doğrulamasını reddetmek için `true` olarak ayarlayın.
`gateway.auth.requireExplicitRateLimit`	`gateway.auth.rateLimit`	Açık kimlik doğrulama hız sınırı yapılandırmasını zorunlu kılmak için `true` olarak ayarlayın.
`gateway.controlUi.allowInsecure`	Control UI güvenli olmayan kimlik doğrulama/cihaz/kaynak geçişleri	Güvenli olmayan Control UI erişim geçişlerini reddetmek için `false` olarak ayarlayın.
`gateway.remote.allow`	Uzak Gateway modu/yapılandırması	Uzak Gateway modunu reddetmek için `false` olarak ayarlayın.
`gateway.http.denyEndpoints`	Gateway HTTP API uç noktaları	`chatCompletions` veya `responses` gibi uç nokta kimliklerini reddedin.
`gateway.http.requireUrlAllowlists`	Gateway HTTP URL getirme girdileri	URL getirme girdilerinde URL izin listelerini zorunlu kılmak için `true` olarak ayarlayın.
`gateway.nodes.denyCommands`	`gateway.nodes.commands.deny`	`system.run` gibi tam Node komut kimliklerinin OpenClaw yapılandırmasında reddedilmesini zorunlu kılın.

gateway.nodes.denyCommands, tam ve büyük/küçük harfe duyarlı bir ilke 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.commands.allow öğesine güvenmek yerine incelemeden sonra policy.jsonc öğesini güncellemelidir.

Aracı çalışma alanı

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`agents.workspace.allowedAccess`	`agents.defaults.sandbox.workspaceAccess` ve `agents.entries.*.sandbox.workspaceAccess`	Yalnızca `none` veya `ro` gibi korumalı alan çalışma alanı erişim değerlerine izin verin.
`agents.workspace.denyTools`	Genel ve aracı başına araç reddetme yapılandırması	Değişiklik araçlarının (`exec`, `process`, `write`, `edit`, `apply_patch`) reddedilmesini zorunlu kılın.

Korumalı alan duruşu

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`sandbox.requireMode`	`agents.defaults.sandbox.mode` ve aracı başına mod	Yalnızca `all` veya `non-main` gibi incelenmiş korumalı alan modlarına izin verin.
`sandbox.allowBackends`	`agents.defaults.sandbox.backend` ve aracı başına arka uç	Yalnızca `docker` gibi incelenmiş korumalı alan arka uçlarına izin verin.
`sandbox.containers.denyHostNetwork`	Kapsayıcı destekli korumalı alan/tarayıcı ağ modu	Ana makine ağ modunu reddedin.
`sandbox.containers.denyContainerNamespaceJoin`	Kapsayıcı destekli korumalı alan/tarayıcı ağ modu	Başka bir kapsayıcının ağ ad alanına katılmayı reddedin.
`sandbox.containers.requireReadOnlyMounts`	Kapsayıcı destekli korumalı alan/tarayıcı bağlama modu	Bağlamaların salt okunur olmasını zorunlu kılın.
`sandbox.containers.denyContainerRuntimeSocketMounts`	Kapsayıcı destekli korumalı alan/tarayıcı bağlama hedefleri	Kapsayıcı çalışma zamanı yuvası bağlamalarını reddedin.
`sandbox.containers.denyUnconfinedProfiles`	Kapsayıcı güvenlik profili duruşu	Sınırlandırılmamış kapsayıcı güvenlik profillerini reddedin.
`sandbox.browser.requireCdpSourceRange`	Korumalı alan tarayıcısı CDP kaynak aralığı	Tarayıcı CDP erişiminin bir kaynak aralığı bildirmesini zorunlu kılın.

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

Veri İşleme

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`dataHandling.sensitiveLogging.requireRedaction`	`logging.redactSensitive`	`logging.redactSensitive: "off"` öğesini reddetmek için `true` olarak ayarlayın.
`dataHandling.telemetry.denyContentCapture`	`diagnostics.otel.captureContent`	Telemetri içerik yakalamayı reddetmek için `true` olarak ayarlayın.
`dataHandling.retention.requireSessionMaintenance`	`session.maintenance.mode`	Etkin oturum bakım modu `enforce` öğesini zorunlu kılmak için `true` olarak ayarlayın.
`dataHandling.memory.denySessionTranscriptIndexing`	`memory.qmd.sessions.enabled`, `memory.search.experimental.sessionMemory` ve aracı başına geçersiz kılmalar	Oturum dökümü belleğe dizinlemeyi reddetmek için `true` olarak ayarlayın.

Gizli bilgiler

İlke alanı	Gözlemlenen durum	Kullanılacağı durum
`secrets.requireManagedProviders`	Yapılandırma SecretRef’leri ve `secrets.providers.*` bildirimleri	SecretRef’lerin bildirilmiş sağlayıcılara işaret etmesini zorunlu kılmak için `true` olarak ayarlayın.
`secrets.denySources`	Gizli bilgi sağlayıcı kaynakları ve SecretRef kaynakları	`exec`, `file` veya yapılandırılmış başka bir kaynak adı gibi kaynakları reddedin.
`secrets.allowInsecureProviders`	Güvenli olmayan gizli bilgi sağlayıcı duruş bayrakları	Güvenli olmayan duruşu tercih eden sağlayıcıları reddetmek için `false` olarak ayarlayın.

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 çabayla geçiş yerine gözlemlenemeyen kanıt olarak bildirilir. Okunabilir olduğunda, belirtilmeyen alanlar çalışma zamanı varsayılanlarını devralır: eksik defaults.security, 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 girdi kaynağını içerir; yuva yolu/belirteci, commandText, lastUsedCommand, çözümlenmiş yollar veya zaman damgalarını asla içermez.

İlke alanı	Gözlemlenen durum	Kullanım amacı
`execApprovals.requireFile`	Etkin çalışma zamanı `exec-approvals.json` yolu	Onaylar yapıtının mevcut olmasını ve ayrıştırılabilmesini zorunlu kılmak için `true` olarak ayarlayın.
`execApprovals.defaults.allowSecurity`	`defaults.security`, varsayılan olarak `full`	Yalnızca onaylanmış varsayılan onay güvenliği modlarına izin verin.
`execApprovals.agents.allowSecurity`	`agents.*.security`, varsayılanları devralır	Yalnızca aracı başına onaylanmış etkin onay güvenliği modlarına izin verin.
`execApprovals.agents.allowAutoAllowSkills`	`defaults.autoAllowSkills` ve `agents.*.autoAllowSkills`, çalışma zamanı varsayılanlarını devralır	Örtük beceri CLI onayı olmadan katı manuel izin listelerini zorunlu kılmak için `false` olarak ayarlayın.
`execApprovals.agents.allowlist.expected`	Toplu `agents.*.allowlist[]` kalıbı ve isteğe bağlı argPattern girdileri	Onaylar izin listesinin incelenen kalıp kümesiyle eşleşmesini zorunlu kılın.

Örnek: Onaylar yapıtını zorunlu kılın, esnek varsayılanları reddedin ve seçili aracılar için yalnızca incelenmiş yürütme 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ış reddetme duruşuna izin verir.
      "allowSecurity": ["deny"],
    },
  },
  "scopes": {
    "restricted-shell": {
      "agentIds": ["family-agent", "groups-agent"],
      "execApprovals": {
        "agents": {
          // Seçili aracılar incelenmiş izin listesi duruşunu kullanabilir, ancak "full" kullanamaz.
          "allowSecurity": ["allowlist"],
          // false, beceri CLI'larının autoAllowSkills tarafından örtük olarak
          // onaylanmak yerine incelenen izin listesinde bulunması gerektiği anlamına gelir.
          "allowAutoAllowSkills": false,
          "allowlist": {
            "expected": [
              // Basit girdi: argPattern içermeyen, tam olarak incelenmiş yürütülebilir dosya kalıbı.
              "travel-hub",
              // Kısıtlı girdi: kalıp ve incelenmiş bağımsız değişken düzenli ifadesi.
              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },
              "/bin/date",
            ],
          },
        },
      },
    },
  },
}

Kimlik doğrulama profilleri

İlke alanı	Gözlemlenen durum	Kullanım amacı
`auth.profiles.requireMetadata`	`auth.profiles.*` sağlayıcı ve mod meta verileri	Yapılandırma kimlik doğrulama profillerinde `provider` ve `mode` gibi meta veri anahtarlarını zorunlu kılın.
`auth.profiles.allowModes`	`auth.profiles.*.mode`	Yalnızca `api_key`, `aws-sdk`, `oauth` veya `token` gibi desteklenen kimlik doğrulama profili modlarına izin verin.

Araç meta verileri

İlke alanı	Gözlemlenen durum	Kullanım amacı
`tools.requireMetadata`	Yönetilen `TOOLS.md` bildirimleri	Yönetilen araçların `risk`, `sensitivity` veya `owner` gibi meta veri anahtarlarını bildirmesini zorunlu kılın.

Araç duruşu

İlke alanı	Gözlemlenen durum	Kullanım amacı
`tools.profiles.allow`	`tools.profile` ve `agents.entries.*.tools.profile`	Yalnızca `minimal`, `messaging` veya `coding` gibi araç profili kimliklerine izin verin.
`tools.fs.requireWorkspaceOnly`	`tools.fs.workspaceOnly` ve aracı başına `tools.fs` geçersiz kılmaları	Yalnızca çalışma alanıyla sınırlı dosya sistemi aracı duruşunu zorunlu kılmak için `true` olarak ayarlayın.
`tools.exec.allowSecurity`	`tools.exec.security` ve aracı başına yürütme güvenliği	Yalnızca `deny` veya `allowlist` gibi yürütme güvenliği modlarına izin verin.
`tools.exec.requireAsk`	`tools.exec.ask` ve aracı başına yürütme sorma modu	`always` gibi bir onay duruşunu zorunlu kılın.
`tools.exec.allowHosts`	`tools.exec.host` ve aracı başına yürütme ana makine yönlendirmesi	Yalnızca `sandbox` gibi yürütme ana makine yönlendirme modlarına izin verin.
`tools.elevated.allow`	`tools.elevated.enabled` ve aracı başına yükseltilmiş duruş	Yükseltilmiş araç modunun devre dışı kalmasını zorunlu kılmak için `false` olarak ayarlayın.
`tools.alsoAllow.expected`	`tools.alsoAllow` ve aracı başına `tools.alsoAllow`	Tam `alsoAllow` girdilerini zorunlu kılın ve eksik ya da beklenmeyen ek araç izinlerini bildirin.
`tools.denyTools`	`tools.deny` ve `agents.entries.*.tools.deny`	Yapılandırılmış araç reddetme listelerinin `group:runtime` ve `group:fs` gibi araç kimliklerini veya gruplarını içermesini zorunlu kılın.

Denetimleri çalıştırma

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

openclaw policy check
openclaw policy check --json
openclaw 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ı yayımlar. Aynı bulgular, İlke Plugin’i 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.jsonc
openclaw policy compare --baseline official.policy.jsonc --policy policy.jsonc --json

policy compare, ilke dosyası söz dizimini ilke dosyası söz dizimine göre denetler; çalışma zamanı durumunu, kanıtları, kimlik bilgilerini veya gizli değerleri incelemez. Kapsamlı katmanları yöneten aynı kural meta verilerini kullanır: izin listeleri eşit veya daha dar kalmalı, reddetme listeleri eşit veya daha geniş kalmalı, zorunlu Boole değerleri 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 ya da daha kısıtlayıcı olduğunda 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. Yönlendirme yoklamalarında, her temel değer yoklama kimliği aynı rota ve beklenen aracıyla kalmalıdır. Denetlenen bir ilke yoklamalar ekleyebilir veya matchedBy değerini daraltabilir, ancak bir yoklamayı kaldırmak, rotasını ya da aracısını değiştirmek veya kabul edilen eşleşme türlerini genişletmek daha zayıftı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:...",
        },
      },
    },
  },
}

Ayar	Amaç
`enabled`	`policy.jsonc` mevcut olmadan önce bile ilke denetimlerini etkinleştirin.
`workspaceRepairs`	`doctor --fix` komutunun ilke tarafından yönetilen çalışma alanı ayarlarını düzenlemesine izin verin.
`expectedHash`	Onaylanmış ilke yapıtı için isteğe bağlı karma kilidi.
`expectedAttestationHash`	Son kabul edilen temiz ilke denetimi için isteğe bağlı karma kilidi.
`path`	İlke yapıtının çalışma alanına göre konumu.

Plugin yüklü kalırken bir çalışma alanının 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ılan kural yapıtını tanımlar. evidence denetimlerin kullandığı gözlemlenen OpenClaw durumunu kaydeder ve workspace.hash bu kanıt yükünü tanımlar. findingsHash kesin 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 durumu) tanımlar ve checkedAt değerini bilinçli olarak hariç tutar; böylece aynı ilke durumu her zaman aynı tasdik karmasını üretir. Bu dört değer birlikte tek bir ilke denetiminin denetim izini oluşturan dörtlüyü meydana getirir. Bir Gateway veya denetleyici, bir çalışma zamanı eylemini engellemek, onaylamak ya da açıklamayla işaretlemek için ilke kullanıyorsa son temiz denetimin tasdik karmasını kaydetmelidir. checkedAt denetim günlükları 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ü:

policy.jsonc öğesini yazın veya inceleyin.
openclaw policy check --json komutunu çalıştırın.
Temizse attestation.policy.hash değerini expectedHash olarak kaydedin.
attestation.attestationHash değerini expectedAttestationHash olarak kaydedin.
openclaw doctor --lint komutunu CI veya sürüm geçitlerinde yeniden çalıştırın.

İlke kuralları kasıtlı olarak değişirse temiz bir denetimdeki kabul edilmiş iki karmayı da güncelleyin. Yalnızca çalışma alanı ayarları değişirse (ilke aynı kalırsa), genellikle yalnızca expectedAttestationHash değişir. agents.workspace kurallarını etkinleştirmek veya yükseltmek, çalışma alanı karmasına ve tasdik karmasına agentWorkspace kanıtı ekler; etkinleştirdikten sonra yeni kanıtı inceleyin ve kabul edilmiş tasdik karmalarını yenileyin. Araç duruşu kurallarını etkinleştirmek veya yükseltmek de toolPosture kanıtını aynı şekilde 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ğerlendirmesine ihtiyaç duyan CI veya betiklerde --once kullanın. --once olmadan varsayılan olarak her iki saniyede bir yoklama yapar; aralığı değiştirmek için --interval-ms kullanın.

Bulgular

Denetim kimliği	Bulgu
`policy/policy-jsonc-missing`	İlke etkin ancak `policy.jsonc` eksik.
`policy/policy-jsonc-invalid`	İlke ayrıştırılamıyor veya hatalı biçimlendirilmiş kural girdileri içeriyor.
`policy/policy-hash-mismatch`	İlke, yapılandırılmış `expectedHash` ile eşleşmiyor.
`policy/attestation-hash-mismatch`	Mevcut ilke kanıtı artık kabul edilen tasdikle eşleşmiyor.
`policy/policy-conformance-invalid`	Bir temel veya denetlenen ilke dosyasında geçersiz karşılaştırma söz dizimi var.
`policy/policy-conformance-missing`	Denetlenen bir ilke dosyasında, temel ilke dosyasının gerektirdiği bir kural eksik.
`policy/policy-conformance-weaker`	Denetlenen bir ilke dosyasında, temel ilke dosyasındakinden daha zayıf bir değer var.
`policy/channels-denied-provider`	Etkin bir kanal, kanal ret kuralıyla eşleşiyor.
`policy/mcp-denied-server`	Yapılandırılmış bir MCP sunucusu ilke tarafından reddediliyor.
`policy/mcp-unapproved-server`	Yapılandırılmış bir MCP sunucusu izin listesinin dışında.
`policy/models-denied-provider`	Yapılandırılmış bir model sağlayıcısı veya model başvurusu, reddedilen bir sağlayıcı kullanıyor.
`policy/models-unapproved-provider`	Yapılandırılmış bir model sağlayıcısı veya model başvurusu izin listesinin dışında.
`policy/network-private-access-enabled`	İlke reddettiği hâlde özel ağ SSRF kaçış mekanizması etkin.
`policy/routing-bindings-required`	İlke bir kanal rota bağlaması gerektiriyor ancak hiçbiri yapılandırılmamış.
`policy/routing-binding-channel-unconfigured`	Bir rota bağlaması, `channels.*` içinde bulunmayan bir kanalı adlandırıyor.
`policy/routing-agent-mismatch`	Yazılmış bir rota farklı bir ajana çözümleniyor.
`policy/routing-match-kind-mismatch`	Yazılmış bir rota, beklenmeyen bir bağlama özgüllüğünde eşleşiyor.
`policy/ingress-dm-policy-unapproved`	Bir kanal DM ilkesi, ilke izin listesinin dışında.
`policy/ingress-dm-scope-unapproved`	`session.dmScope`, ilkenin gerektirdiği DM yalıtım kapsamıyla eşleşmiyor.
`policy/ingress-open-groups-denied`	İlke açık grup girişini reddettiği hâlde bir kanal grup ilkesi `open`.
`policy/ingress-group-mention-required`	İlke gerektirdiği hâlde bir kanal veya grup girdisi bahsetme geçitlerini devre dışı bırakıyor.
`policy/gateway-non-loopback-bind`	İlke reddettiği hâlde Gateway bağlama duruşu, geri döngü dışı açığa çıkmaya izin veriyor.
`policy/gateway-auth-disabled`	İlke kimlik doğrulaması gerektirdiği hâlde Gateway kimlik doğrulaması devre dışı.
`policy/gateway-rate-limit-missing`	İlke gerektirdiği hâlde Gateway kimlik doğrulama hız sınırı duruşu açıkça belirtilmemiş.
`policy/gateway-control-ui-insecure`	Gateway Denetim Arayüzü’nün güvenli olmayan açığa çıkma geçişleri etkin.
`policy/gateway-tailscale-funnel`	İlke reddettiği hâlde Gateway Tailscale Funnel açığa çıkması etkin.
`policy/gateway-remote-enabled`	İlke reddettiği hâlde Gateway uzak modu etkin.
`policy/gateway-http-endpoint-enabled`	İlke tarafından reddedilmesine rağmen bir Gateway HTTP API uç noktası etkin.
`policy/gateway-http-url-fetch-unrestricted`	Gateway HTTP URL getirme girdisinde gerekli URL izin listesi yok.
`policy/gateway-node-command-denied`	İlke tarafından reddedilen bir Node komutu, OpenClaw yapılandırması tarafından reddedilmiyor.
`policy/agents-workspace-access-denied`	Ajan korumalı alan modu veya çalışma alanı erişimi, ilke izin listesinin dışında.
`policy/agents-tool-not-denied`	Bir ajan veya varsayılan yapılandırma, ilkenin gerektirdiği bir aracı reddetmiyor.
`policy/tools-profile-unapproved`	Yapılandırılmış genel veya ajan bazlı araç profili izin listesinin dışında.
`policy/tools-fs-workspace-only-required`	Dosya sistemi araçları yalnızca çalışma alanı yolu duruşuyla yapılandırılmamış.
`policy/tools-exec-security-unapproved`	Yürütme güvenlik modu, ilke izin listesinin dışında.
`policy/tools-exec-ask-unapproved`	Yürütme sorma modu, ilke izin listesinin dışında.
`policy/tools-exec-host-unapproved`	Yürütme ana makine yönlendirmesi, ilke izin listesinin dışında.
`policy/tools-elevated-enabled`	İlke reddettiği hâlde yükseltilmiş araç modu etkin.
`policy/tools-also-allow-missing`	Yapılandırılmış bir `alsoAllow` listesinde ilkenin gerektirdiği bir girdi eksik.
`policy/tools-also-allow-unexpected`	Yapılandırılmış bir `alsoAllow` listesi, ilkenin beklemediği bir girdi içeriyor.
`policy/tools-required-deny-missing`	Genel veya ajan bazlı araç ret listesi, reddedilmesi gereken bir aracı içermiyor.
`policy/sandbox-mode-unapproved`	Korumalı alan modu, ilke izin listesinin dışında.
`policy/sandbox-backend-unapproved`	Korumalı alan arka ucu, ilke izin listesinin dışında.
`policy/sandbox-container-posture-unobservable`	Bir kapsayıcı duruş kuralı, bunu gözlemleyemeyen bir arka uç için etkinleştirilmiş.
`policy/sandbox-container-host-network-denied`	Kapsayıcı destekli bir korumalı alan veya tarayıcı, ana makine ağ modunu kullanıyor.
`policy/sandbox-container-namespace-join-denied`	Kapsayıcı destekli bir korumalı alan veya tarayıcı, başka bir kapsayıcının ad alanına katılıyor.
`policy/sandbox-container-mount-mode-required`	Kapsayıcı destekli bir korumalı alan veya tarayıcı bağlaması salt okunur değil.
`policy/sandbox-container-runtime-socket-mount`	Kapsayıcı destekli bir korumalı alan veya tarayıcı bağlaması, kapsayıcı çalışma zamanı yuvasını açığa çıkarıyor.
`policy/sandbox-container-unconfined-profile`	İlke reddettiği hâlde kapsayıcı korumalı alan profili sınırsız.
`policy/sandbox-browser-cdp-source-range-missing`	İlke gerektirdiği hâlde korumalı alan tarayıcısının CDP kaynak aralığı eksik.
`policy/data-handling-redaction-disabled`	İlke gerektirdiği hâlde hassas günlük kaydı maskelemesi devre dışı.
`policy/data-handling-telemetry-content-capture`	İlke reddettiği hâlde telemetri içerik yakalama etkin.
`policy/data-handling-session-retention-not-enforced`	İlke gerektirdiği hâlde oturum saklama bakımı zorunlu tutulmuyor.
`policy/data-handling-session-transcript-memory-enabled`	İlke reddettiği hâlde oturum dökümü bellek indeksleme etkin.
`policy/secrets-unmanaged-provider`	Bir yapılandırma SecretRef’i, `secrets.providers` altında bildirilmemiş bir sağlayıcıya başvuruyor.
`policy/secrets-denied-provider-source`	Bir yapılandırma gizli bilgi sağlayıcısı veya SecretRef, ilke tarafından reddedilen bir kaynak kullanıyor.
`policy/secrets-insecure-provider`	İlke reddettiği hâlde bir gizli bilgi sağlayıcısı güvenli olmayan duruşu kabul ediyor.
`policy/auth-profile-invalid-metadata`	Bir yapılandırma kimlik doğrulama profilinde geçerli sağlayıcı veya mod meta verileri eksik.
`policy/auth-profile-unapproved-mode`	Bir yapılandırma kimlik doğrulama profili modu, ilke izin listesinin dışında.
`policy/exec-approvals-missing`	İlke `exec-approvals.json` gerektiriyor ancak yapıt eksik.
`policy/exec-approvals-invalid`	Yapılandırılmış yürütme onayları yapıtı ayrıştırılamıyor.
`policy/exec-approvals-default-security-unapproved`	Yürütme onayı varsayılanları, ilke izin listesinin dışında bir güvenlik modu kullanıyor.
`policy/exec-approvals-agent-security-unapproved`	Ajan bazlı etkin yürütme onayı güvenlik modu izin listesinin dışında.
`policy/exec-approvals-auto-allow-skills-enabled`	İlke reddettiği hâlde bir yürütme onayı ajanı, beceri CLI’larına örtük olarak otomatik izin veriyor.
`policy/exec-approvals-allowlist-missing`	Onaylar izin listesinde ilkenin gerektirdiği bir örüntü eksik.
`policy/exec-approvals-allowlist-unexpected`	Onaylar izin listesi, ilkenin beklemediği bir örüntü içeriyor.
`policy/tools-missing-risk-level`	Yönetilen bir araç bildiriminde risk meta verileri eksik.
`policy/tools-unknown-risk-level`	Yönetilen bir araç bildirimi, bilinmeyen bir risk değeri kullanıyor.
`policy/tools-missing-sensitivity-token`	Yönetilen bir araç bildiriminde hassasiyet meta verileri eksik.
`policy/tools-missing-owner`	Yönetilen bir araç bildiriminde sahip meta verileri eksik.
`policy/tools-unknown-sensitivity-token`	Yönetilen bir araç bildirimi, bilinmeyen bir hassasiyet değeri kullanıyor.

Bir bulgu hem target (uyumsuzluk gösteren, gözlemlenen çalışma alanı öğesi) hem de requirement (bunun bir bulgu olmasına neden olan yazılmış kural) içerebilir. Her ikisi de bugün oc:// adres dizeleridir ancak alan adları adres biçimini değil, ilke rolünü tanımlar. Örnek bulgular:

{
  "checkId": "policy/channels-denied-provider",
  "severity": "error",
  "message": "'telegram' kanalı, reddedilen 'telegram' sağlayıcısını kullanıyor.",
  "source": "policy",
  "path": "openclaw yapılandırması",
  "ocPath": "oc://openclaw.config/channels/telegram",
  "target": "oc://openclaw.config/channels/telegram",
  "requirement": "oc://policy.jsonc/channels/denyRules/#0",
  "fixHint": "Telegram bu çalışma alanı için onaylanmamıştır."
}

{
  "checkId": "policy/tools-missing-risk-level",
  "severity": "error",
  "message": "TOOLS.md içindeki 'deploy' aracının açık bir risk sınıflandırması yok.",
  "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": "'remote' MCP sunucusu ilke izin listesinde değil.",
  "source": "policy",
  "path": "openclaw yapılandırması",
  "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": "'anthropic/claude-sonnet-4.7' model başvurusu, onaylanmamış 'anthropic' sağlayıcısını kullanıyor.",
  "source": "policy",
  "path": "openclaw yapılandırması",
  "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": "'browser-private-network' ağ ayarı, özel ağ erişimine izin veriyor.",
  "source": "policy",
  "path": "openclaw yapılandırması",
  "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 bağlama ayarı 'gateway-bind', geri döngü dışı erişime izin veriyor.",
  "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 komutu 'system.run' ilke tarafından reddediliyor ancak OpenClaw yapılandırması tarafından reddedilmiyor.",
  "source": "policy",
  "path": "openclaw config",
  "ocPath": "oc://openclaw.config/gateway/nodes/commands/deny",
  "target": "oc://openclaw.config/gateway/nodes/commands/deny",
  "requirement": "oc://policy.jsonc/gateway/nodes/denyCommands",
  "fixHint": "'system.run' değerini gateway.nodes.commands.deny listesine ekleyin veya incelemeden sonra ilkeyi güncelleyin."
}

{
  "checkId": "policy/agents-workspace-access-denied",
  "severity": "error",
  "message": "agents.defaults sandbox workspaceAccess değeri 'rw' ilke tarafından izin verilmiyor.",
  "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 ilke 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 ilke dosyası incelendikten sonra etkinleştirin:

genel bir ilke yükseltilmiş araçları yasakladığında tools.elevated.enabled=false değerini ayarla
ilke bu araçların reddedilmesini gerektirdiğinde eksik zorunlu ret araç kimliklerini tools.deny veya agents.entries.*.tools.deny öğesine ekle
güvenli olmayan gateway.controlUi.* anahtarlarını false olarak ayarla
ilke uzak Gateway modunu reddettiğinde gateway.mode=local değerini ayarla
ilke Gateway HTTP API uç noktalarını reddettiğinde bildirilen gateway.http.endpoints.*.enabled yollarını false olarak ayarla
ilke açık grup girişini reddettiğinde bildirilen kanal girişi groupPolicy yollarını allowlist olarak ayarla
ilke grup bahsetmelerini gerektirdiğinde bildirilen kanal girişi requireMention yollarını true olarak ayarla
ilke hassas günlük kaydı redaksiyonunu gerektirdiğinde logging.redactSensitive=tools değerini ayarla
ilke telemetri içeriği yakalamayı reddettiğinde diagnostics.otel.captureContent=false değerini veya nesne biçimindeki telemetri yakalama ayarları için diagnostics.otel.captureContent.enabled=false değerini 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ı ilke hedefinden daha fazlasını etkiler. Bulgu devralınan kök tools.deny değerini bildirdiğinde kapsamlı zorunlu ret onarımları atlanır; çünkü gerekli aracın kök yapılandırmasına eklenmesi, kapsamlı ilke hedefinden daha fazlasını etkiler. Aracıya özgü zorunlu ret onarımları, bildirilen agents.entries.*.tools.deny yolunu güncelleyebilir. Bulgu devralınan channels.defaults.* değerini bildirdiğinde kapsamlı kanal girişi onarımları atlanır; çünkü paylaşılan kanal varsayılanının değiştirilmesi, kapsamlı ilke hedefinden daha fazlasını etkiler. Otomatik onarım doğru uç nokta URL izin listesi değerlerini seçemediğinden, Gateway HTTP URL getirme izin listesi bulguları manuel olarak kalır. 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.commands.deny değişikliğini atlanmış önizleme rehberliği olarak bildirir. Değişikliği uygulamaz ve bir operatör yapılandırmayı veya ilkeyi inceleyip güncelleyene kadar bulgu onarılmış sayılmaz.

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

Çıkış kodları

Komut	`0`	`1`	`2`
`policy check`	Eşikte bulgu yok.	Bir veya daha fazla bulgu eşiği karşıladı.	Bağımsız değişken veya çalışma zamanı hatası.
`policy compare`	İlke dosyası en az temel çizgi kadar katıdır.	İlke dosyası geçersiz, eksik veya temel çizgi kurallarından daha zayıf.	Bağımsız değişken veya çalışma zamanı hatası.
`policy watch`	Bulgu yok ve kabul edilen karma güncel.	Bulgular mevcut veya kabul edilen tasdik güncel değil.	Bağımsız değişken veya çalışma zamanı hatası.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Politika

`openclaw policy`

Hızlı başlangıç

Politika kuralı başvurusu

Kapsamlı katmanlar

Kanallar

MCP sunucuları

Model sağlayıcıları

Ağ

İleti yönlendirme

Giriş ve kanal erişimi

Gateway

Aracı çalışma alanı

Korumalı alan duruşu

Veri İşleme

Gizli bilgiler

Exec onayları

Kimlik doğrulama profilleri

Araç meta verileri

Araç duruşu

Denetimleri çalıştırma

İlkeyi yapılandırma

İlke durumunu kabul etme

Bulgular

Onarım

Çıkış kodları

İlgili

​openclaw policy

​Hızlı başlangıç

​Politika kuralı başvurusu

​Kapsamlı katmanlar

​Kanallar

​MCP sunucuları

​Model sağlayıcıları

​Ağ

​İleti yönlendirme

​Giriş ve kanal erişimi

​Gateway

​Aracı çalışma alanı

​Korumalı alan duruşu

​Veri İşleme

​Gizli bilgiler

​Exec onayları

​Kimlik doğrulama profilleri

​Araç meta verileri

​Araç duruşu

​Denetimleri çalıştırma

​İlkeyi yapılandırma

​İlke durumunu kabul etme

​Bulgular

​Onarım

​Çıkış kodları

​İlgili

`openclaw policy`

Hızlı başlangıç

Politika kuralı başvurusu

Kapsamlı katmanlar

Kanallar

MCP sunucuları

Model sağlayıcıları

Ağ

İleti yönlendirme

Giriş ve kanal erişimi

Gateway

Aracı çalışma alanı

Korumalı alan duruşu

Veri İşleme

Gizli bilgiler

Exec onayları

Kimlik doğrulama profilleri

Araç meta verileri

Araç duruşu

Denetimleri çalıştırma

İlkeyi yapılandırma

İlke durumunu kabul etme

Bulgular

Onarım

Çıkış kodları

İlgili