openclaw policy

openclaw policy disediakan oleh Plugin Policy bawaan. Ini merupakan lapisan kesesuaian perusahaan di atas pengaturan OpenClaw yang sudah ada, bukan sistem konfigurasi kedua. Anda menulis persyaratan di policy.jsonc; OpenClaw mengamati ruang kerja aktif sebagai bukti; Policy melaporkan penyimpangan melalui doctor --lint. Policy tidak memberlakukan panggilan alat atau menulis ulang perilaku runtime pada saat permintaan, dan tidak mengesahkan penyimpanan kredensial per agen seperti auth-profiles.json.

Policy memeriksa saluran yang dikonfigurasi, server MCP, penyedia model, postur SSRF jaringan, akses ingress/saluran, eksposur Gateway dan postur perintah node, probe perutean pesan yang ditulis, akses ruang kerja agen, postur sandbox, postur penanganan data, postur penyedia rahasia/profil autentikasi, dan metadata alat yang diatur (TOOLS.md). Gunakan ini ketika ruang kerja memerlukan pernyataan yang tahan lama dan dapat diperiksa seperti "Telegram tidak boleh diaktifkan" atau "alat yang diatur harus mendeklarasikan metadata risiko dan pemilik." Jika Anda hanya memerlukan perilaku lokal tanpa pengesahan atau deteksi penyimpangan, konfigurasi biasa sudah cukup.

Mulai cepat

openclaw plugins enable policy

Plugin tetap aktif meskipun policy.jsonc tidak ada, sehingga doctor dapat melaporkan artefak yang hilang alih-alih melewati pemeriksaan secara diam-diam.

Tulis policy.jsonc secara manual; ini tidak dihasilkan dari pengaturan saat ini. Setiap bagian tingkat atas merupakan namespace aturan: pemeriksaan hanya berjalan ketika ada aturan konkret di bawahnya (bagian atau kunci yang tidak didukung gagal sebagai policy/policy-jsonc-invalid alih-alih diabaikan secara diam-diam). Contoh minimal yang mencakup setiap bagian yang didukung:

{  "channels": {    "denyRules": [      {        "id": "no-telegram",        "when": { "provider": "telegram" },        "reason": "Telegram tidak disetujui untuk ruang kerja ini.",      },    ],  },  "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"],  },}

Catatan lintas bagian yang tidak terlihat jelas dari tabel aturan di bawah:

• Menghilangkan gateway.bind saat melarang pengikatan non-loopback berarti Anda menerima nilai default runtime; tetapkan gateway.bind: "loopback" untuk kesesuaian ketat.
• Untuk agen hanya-baca, tetapkan mode sandbox ke all atau non-main pada default/agen yang berlaku dan workspaceAccess ke none atau ro. Mode sandbox yang tidak ada atau off tidak memenuhi kebijakan hanya-baca.
• agents.workspace.denyTools menerima exec, process, write, edit, apply_patch. Grup penolakan alat konfigurasi group:fs (mutasi file) dan group:runtime (shell/proses) memenuhi postur yang setara.
• Pemeriksaan persetujuan eksekusi membaca artefak exec-approvals.json aktif hanya ketika ada aturan execApprovals; artefak yang hilang atau tidak valid merupakan bukti yang tidak dapat diamati, bukan kelulusan sintetis.
• Bukti rahasia dan profil autentikasi hanya mencatat postur penyedia/sumber dan metadata SecretRef, tidak pernah nilai mentah. Policy tidak membaca atau mengesahkan penyimpanan kredensial per agen seperti auth-profiles.json.
• Bukti penanganan data hanya berupa postur tingkat konfigurasi (mode redaksi, tombol pengambilan telemetri, mode pemeliharaan sesi, pengaturan pengindeksan transkrip). Ini tidak memeriksa log, ekspor telemetri, transkrip, atau file memori, dan hasil bersih tidak membuktikan bahwa tidak ada data pribadi atau rahasia di dalamnya.
• Probe perutean menggunakan kembali resolver pengikatan runtime OpenClaw. Bukti perutean hanya mencatat id probe, agen yang diresolusi, jenis kecocokan, dan metadata pengikatan yang disunting. Bukti ini tidak pernah mencatat pengidentifikasi rekan, akun, guild, tim, atau peran. Menambahkan bagian perutean secara sengaja mengubah hash kebijakan dan pengesahan; kebijakan tanpa perutean mempertahankan bentuk bukti yang ada.

Referensi aturan Policy

Setiap aturan di bawah bersifat opsional; pemeriksaan hanya berjalan ketika aturan tersebut ada. Status yang diamati adalah konfigurasi OpenClaw atau metadata ruang kerja yang sudah ada.

Overlay tercakup

Gunakan scopes.<scopeName> ketika agen atau saluran tertentu memerlukan kebijakan yang lebih ketat daripada garis dasar tingkat atas. Nama cakupan hanyalah label; pencocokan menggunakan selektor di dalam cakupan. Overlay bersifat aditif: aturan global tetap berjalan, dan aturan tercakup dapat menambahkan temuannya sendiri terhadap bukti yang sama.

Jika entri agentIds tidak ada di agents.list[], OpenClaw mengevaluasi aturan tercakup terhadap postur global/default yang diwarisi untuk id agen runtime tersebut alih-alih melewatinya.

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

Agen yang sama dapat muncul dalam beberapa cakupan jika setiap cakupan mengatur bidang yang berbeda, seperti di atas. Bidang tercakup yang berulang untuk agen yang sama harus sama ketatnya atau lebih ketat; klaim duplikat yang lebih lemah ditolak (daftar izin merupakan subset, daftar penolakan merupakan superset, boolean yang diwajibkan bersifat tetap).

Aturan postur kontainer (sandbox.containers.*) hanya diperiksa terhadap bukti yang dapat diekspos oleh backend sandbox agen yang cocok. Jika backend tidak dapat mengamati aturan yang Anda aktifkan untuknya, Policy melaporkan policy/sandbox-container-posture-unobservable alih-alih meluluskannya; cakupkan aturan kontainer ke grup agen yang menggunakan backend yang dapat mengeksposnya.

ingress.session.requireDmScope tingkat atas tetap global; session.dmScope bukan bukti yang dapat diatribusikan ke saluran, sehingga tidak dapat dicakup oleh channelIds.

Setiap cakupan yang ada di policy.jsonc harus valid dan dapat diberlakukan.

Saluran

Server MCP

Penyedia model

Jaringan

Perutean pesan

ID probe harus unik. Sebuah rute mendukung channel, accountId opsional, peer, parentPeer, guildId, teamId, dan memberRoleIds. Jenis peer adalah direct, group, dan channel. matchedBy dapat berisi satu atau beberapa jenis kecocokan runtime, termasuk binding.peer, binding.account, binding.channel, atau default.

Pemeriksaan perutean hanya merupakan pemeriksaan kesesuaian. Pemeriksaan ini tidak mengubah startup, pengiriman pesan, prioritas pengikatan, atau perilaku fallback. Temuan memerlukan peninjauan operator karena perubahan pengikatan secara otomatis dapat mengalihkan pesan privat.

Akses masuk dan saluran

Gateway

gateway.nodes.denyCommands adalah aturan superset penolakan yang persis dan peka huruf besar-kecil. Gunakan saat kebijakan harus membuktikan bahwa perintah node berhak istimewa secara eksplisit ditolak oleh konfigurasi OpenClaw. Deployment yang sengaja mengizinkan perintah node berhak istimewa harus memperbarui policy.jsonc setelah peninjauan, alih-alih hanya mengandalkan gateway.nodes.allowCommands.

Ruang kerja agen

Postur sandbox

Kebijakan memperlakukan sandbox.mode yang tidak ada sebagai nilai default implisitnya, off, sehingga sandbox.requireMode melaporkan sandbox baru atau belum dikonfigurasi sebagai berada di luar daftar izin seperti ["all"].

Penanganan data

Rahasia

Persetujuan eksekusi

Pemeriksaan persetujuan eksekusi membaca artefak runtime exec-approvals.json: ~/.openclaw/exec-approvals.json secara default, atau $OPENCLAW_STATE_DIR/exec-approvals.json ketika OPENCLAW_STATE_DIR ditetapkan. Aturan postur di bawah execApprovals.defaults.* atau execApprovals.agents.* mewajibkan bukti artefak yang dapat dibaca; artefak yang tidak ada atau tidak valid dilaporkan sebagai bukti yang tidak dapat diamati, bukan kelulusan berdasarkan upaya terbaik. Setelah dapat dibaca, bidang yang dihilangkan mewarisi default runtime: defaults.security yang tidak ada adalah full, dan keamanan agen yang tidak ada mewarisi default tersebut. Bukti mencakup defaults, agents.*, agents.*.allowlist[].pattern, argPattern opsional, postur efektif autoAllowSkills, dan sumber entri — tidak pernah berupa jalur/token soket, commandText, lastUsedCommand, jalur yang di-resolve, atau stempel waktu.

Contoh: wajibkan artefak persetujuan, tolak nilai bawaan yang permisif, dan izinkan hanya postur persetujuan exec yang telah direview untuk agen tertentu.

{  "execApprovals": {    "requireFile": true,    "defaults": {      // Mode keamanan: "deny", "allowlist", atau "full".      // Nilai bawaan ini hanya mengizinkan postur penolakan yang dikunci ketat.      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // Agen yang dipilih dapat menggunakan postur daftar izin yang telah direview, tetapi bukan "full".          "allowSecurity": ["allowlist"],          // false berarti CLI skill harus tercantum dalam daftar izin yang telah direview, bukan          // disetujui secara implisit oleh autoAllowSkills.          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // Entri sederhana: pola executable persis yang telah direview tanpa argPattern.              "travel-hub",              // Entri terbatas: pola beserta regex argumen yang telah direview.              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

Profil autentikasi

Metadata alat

Postur alat

Jalankan pemeriksaan

Jalankan pemeriksaan khusus kebijakan selama penulisan:

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

policy check hanya menjalankan kumpulan pemeriksaan kebijakan dan menghasilkan bukti, temuan, serta hash atestasi. Temuan yang sama juga muncul dalam openclaw doctor --lint ketika Plugin Policy diaktifkan.

Bandingkan berkas kebijakan operator dengan garis dasar yang telah ditulis:

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

policy compare memeriksa sintaks berkas kebijakan terhadap sintaks berkas kebijakan; perintah ini tidak memeriksa status runtime, bukti, kredensial, atau rahasia. Perintah ini menggunakan metadata aturan yang sama dengan yang mengatur overlay tercakup: daftar izin harus tetap sama atau lebih sempit, daftar penolakan harus tetap sama atau lebih luas, boolean wajib harus mempertahankan nilainya, string berurutan hanya boleh bergerak menuju ujung yang lebih ketat dari urutan yang dikonfigurasi, dan daftar persis harus cocok. Garis dasar dapat berupa kebijakan yang ditulis organisasi; kebijakan yang diperiksa boleh menambahkan nilai yang lebih ketat atau aturan tambahan. Aturan tingkat teratas yang diperiksa dapat memenuhi aturan garis dasar tercakup ketika sama ketat atau lebih ketat. Nama cakupan tidak harus cocok antarberkas; perbandingan dikunci berdasarkan pemilih (agentIds/channelIds) dan bidang. Untuk probe perutean, setiap id probe garis dasar harus dipertahankan dengan rute dan agen yang diharapkan yang sama. Kebijakan yang diperiksa boleh menambahkan probe atau mempersempit matchedBy, tetapi menghapus probe, mengubah rute atau agennya, atau memperluas jenis kecocokan yang diterima merupakan kebijakan yang lebih lemah.

Perbandingan bersih (--json):

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

Keluaran policy check --json yang bersih menyertakan hash stabil yang dapat dicatat oleh operator atau pengawas:

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

Konfigurasikan kebijakan

Konfigurasi kebijakan berada di bawah plugins.entries.policy.config.

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

Atur plugins.entries.policy.config.enabled ke false untuk menonaktifkan pemeriksaan kebijakan bagi suatu ruang kerja tanpa menghapus Plugin.

Terima status kebijakan

Contoh keluaran JSON:

{  "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 mengidentifikasi artefak aturan yang dibuat. evidence mencatat status OpenClaw yang diamati dan digunakan oleh pemeriksaan, serta workspace.hash mengidentifikasi payload bukti tersebut. findingsHash mengidentifikasi kumpulan temuan yang tepat. checkedAt mencatat waktu pemeriksaan dijalankan. attestationHash mengidentifikasi klaim stabil (hash kebijakan, hash bukti, hash temuan, dan status bersih/kotor) dan sengaja mengecualikan checkedAt, sehingga status kebijakan yang sama selalu menghasilkan hash pengesahan yang sama. Bersama-sama, keempat nilai ini membentuk tuple audit untuk satu pemeriksaan kebijakan.

Jika Gateway atau supervisor menggunakan kebijakan untuk memblokir, menyetujui, atau memberi anotasi pada tindakan runtime, komponen tersebut harus mencatat hash pengesahan dari pemeriksaan bersih terakhir. checkedAt tetap berada dalam output JSON untuk log audit, tetapi bukan bagian dari hash stabil.

Siklus hidup untuk menerima status kebijakan:

1. Buat atau tinjau policy.jsonc.
2. Jalankan openclaw policy check --json.
3. Jika bersih, catat attestation.policy.hash sebagai expectedHash.
4. Catat attestation.attestationHash sebagai expectedAttestationHash.
5. Jalankan kembali openclaw doctor --lint dalam CI atau gerbang rilis.

Jika aturan kebijakan sengaja diubah, perbarui kedua hash yang diterima berdasarkan pemeriksaan bersih. Jika hanya pengaturan ruang kerja yang berubah (kebijakan tetap sama), biasanya hanya expectedAttestationHash yang berubah.

Mengaktifkan atau meningkatkan versi aturan agents.workspace menambahkan bukti agentWorkspace ke hash ruang kerja dan hash pengesahan; tinjau bukti baru dan perbarui hash pengesahan yang diterima setelah mengaktifkannya. Mengaktifkan atau meningkatkan versi aturan postur alat menambahkan bukti toolPosture dengan cara yang sama.

openclaw policy watch menjalankan kembali pemeriksaan dan melaporkan saat bukti saat ini tidak lagi cocok dengan expectedAttestationHash:

openclaw policy watch --json

Gunakan --once dalam CI atau skrip yang memerlukan satu evaluasi penyimpangan. Tanpa --once, secara default pemeriksaan dilakukan setiap dua detik; gunakan --interval-ms untuk mengubah interval.

Temuan

Sebuah temuan dapat menyertakan target (hal yang diamati di ruang kerja dan tidak sesuai) maupun requirement (aturan yang ditulis yang menjadikannya temuan). Keduanya saat ini merupakan string alamat oc://, tetapi nama bidang menjelaskan peran kebijakan, bukan format alamat.

Contoh temuan:

{  "checkId": "policy/channels-denied-provider",  "severity": "error",  "message": "Kanal 'telegram' menggunakan penyedia 'telegram' yang ditolak.",  "source": "policy",  "path": "konfigurasi openclaw",  "ocPath": "oc://openclaw.config/channels/telegram",  "target": "oc://openclaw.config/channels/telegram",  "requirement": "oc://policy.jsonc/channels/denyRules/#0",  "fixHint": "Telegram tidak disetujui untuk ruang kerja ini."}

{  "checkId": "policy/tools-missing-risk-level",  "severity": "error",  "message": "Alat 'deploy' dalam TOOLS.md tidak memiliki klasifikasi risiko eksplisit.",  "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": "Server MCP 'remote' tidak ada dalam daftar izin kebijakan.",  "source": "policy",  "path": "konfigurasi openclaw",  "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": "Referensi model 'anthropic/claude-sonnet-4.7' menggunakan penyedia 'anthropic' yang tidak disetujui.",  "source": "policy",  "path": "konfigurasi openclaw",  "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": "Pengaturan jaringan 'browser-private-network' mengizinkan akses jaringan privat.",  "source": "policy",  "path": "konfigurasi openclaw",  "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": "Pengaturan bind Gateway 'gateway-bind' mengizinkan paparan non-loopback.",  "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": "Perintah node Gateway 'system.run' ditolak oleh kebijakan, tetapi tidak ditolak oleh konfigurasi OpenClaw.",  "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": "Tambahkan 'system.run' ke gateway.nodes.denyCommands atau perbarui kebijakan setelah ditinjau."}

{  "checkId": "policy/agents-workspace-access-denied",  "severity": "error",  "message": "workspaceAccess sandbox agents.defaults 'rw' tidak diizinkan oleh kebijakan.",  "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"}

Perbaikan

doctor --lint dan policy check bersifat hanya-baca.

doctor --fix hanya mengedit pengaturan ruang kerja yang dikelola kebijakan ketika workspaceRepairs diaktifkan secara eksplisit; jika tidak, pemeriksaan melaporkan apa yang akan diperbaiki dan membiarkan pengaturan tidak berubah.

Dalam versi ini, perbaikan dapat menonaktifkan saluran yang ditolak oleh channels.denyRules dan menerapkan perbaikan penyempitan otomatis yang tercantum di bawah. Aktifkan workspaceRepairs hanya setelah berkas kebijakan ditinjau, karena aturan yang valid dapat mengubah konfigurasi ruang kerja:

• tetapkan tools.elevated.enabled=false ketika kebijakan global melarang alat dengan hak istimewa
• tambahkan ID alat wajib-tolak yang hilang ke tools.deny atau agents.list[].tools.deny ketika kebijakan mengharuskan alat tersebut ditolak
• tetapkan tombol alih gateway.controlUi.* yang tidak aman ke false
• tetapkan gateway.mode=local ketika kebijakan menolak mode Gateway jarak jauh
• tetapkan jalur gateway.http.endpoints.*.enabled yang dilaporkan ke false ketika kebijakan menolak titik akhir API HTTP Gateway
• tetapkan jalur groupPolicy masuk saluran yang dilaporkan ke allowlist ketika kebijakan menolak masuknya grup terbuka
• tetapkan jalur requireMention masuk saluran yang dilaporkan ke true ketika kebijakan mewajibkan penyebutan grup
• tetapkan logging.redactSensitive=tools ketika kebijakan mewajibkan penyamaran pencatatan sensitif
• tetapkan diagnostics.otel.captureContent=false, atau diagnostics.otel.captureContent.enabled=false untuk pengaturan pengambilan telemetri berbentuk objek, ketika kebijakan menolak pengambilan konten telemetri

Perbaikan alat dengan hak istimewa terbatas cakupan hanya bersifat deteksi. Perbaikan penanganan data terbatas cakupan juga dilewati ketika temuan melaporkan konfigurasi pencatatan atau telemetri bersama, karena mengubah pengaturan bersama akan memengaruhi lebih dari target kebijakan terbatas cakupan.

Perbaikan wajib-tolak terbatas cakupan dilewati ketika temuan melaporkan tools.deny root yang diwarisi, karena menambahkan alat wajib tersebut ke konfigurasi root akan memengaruhi lebih dari target kebijakan terbatas cakupan. Perbaikan wajib-tolak lokal agen dapat memperbarui jalur agents.list[].tools.deny yang dilaporkan.

Perbaikan masuk saluran terbatas cakupan dilewati ketika temuan melaporkan channels.defaults.* yang diwarisi, karena mengubah pengaturan bawaan saluran bersama akan memengaruhi lebih dari target kebijakan terbatas cakupan. Temuan daftar yang diizinkan untuk pengambilan URL HTTP Gateway tetap harus ditangani secara manual karena perbaikan otomatis tidak dapat memilih nilai daftar URL titik akhir yang diizinkan dengan benar.

Temuan bind Gateway dan perintah node tetap memerlukan peninjauan. Ketika policy/gateway-non-loopback-bind atau policy/gateway-node-command-denied dapat dipetakan ke jalur konfigurasi, doctor --fix melaporkan usulan perubahan gateway.bind atau gateway.nodes.denyCommands sebagai panduan pratinjau yang dilewati. Perubahan tersebut tidak diterapkan, dan temuan tidak dianggap telah diperbaiki sampai operator meninjau dan memperbarui konfigurasi atau kebijakan.

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

Kode keluar

Terkait

• Mode lint Doctor
• CLI jalur