openclaw policy

openclaw policy được cung cấp bởi Plugin Policy đi kèm. Đây là một lớp tuân thủ dành cho doanh nghiệp áp dụng trên các thiết lập OpenClaw hiện có, không phải một hệ thống cấu hình thứ hai. Bạn soạn các yêu cầu trong policy.jsonc; OpenClaw quan sát không gian làm việc đang hoạt động để làm bằng chứng; policy báo cáo sai lệch thông qua doctor --lint. Policy không thực thi bắt buộc các lệnh gọi công cụ hoặc viết lại hành vi thời gian chạy tại thời điểm yêu cầu, và không chứng thực các kho thông tin xác thực riêng của từng tác nhân như auth-profiles.json.

Policy kiểm tra các kênh đã cấu hình, máy chủ MCP, nhà cung cấp mô hình, trạng thái bảo vệ SSRF mạng, quyền truy cập đầu vào/kênh, mức độ phơi bày của Gateway và trạng thái lệnh Node, quyền truy cập không gian làm việc của tác nhân, trạng thái sandbox, trạng thái xử lý dữ liệu, trạng thái nhà cung cấp bí mật/hồ sơ xác thực và siêu dữ liệu công cụ chịu quản trị (TOOLS.md). Hãy sử dụng tính năng này khi một không gian làm việc cần một tuyên bố lâu dài, có thể kiểm tra, chẳng hạn như "Không được bật Telegram" hoặc "các công cụ chịu quản trị phải khai báo siêu dữ liệu về rủi ro và chủ sở hữu." Nếu bạn chỉ cần hành vi cục bộ mà không cần chứng thực hoặc phát hiện sai lệch, cấu hình thông thường là đủ.

Bắt đầu nhanh

openclaw plugins enable policy

Plugin vẫn được bật ngay cả khi thiếu policy.jsonc, nhờ đó doctor có thể báo cáo thành phần bị thiếu thay vì âm thầm bỏ qua các bước kiểm tra.

Hãy tự soạn policy.jsonc; tệp này không được tạo từ các thiết lập hiện tại. Mỗi phần cấp cao nhất là một không gian tên quy tắc: một bước kiểm tra chỉ chạy khi có quy tắc cụ thể bên trong phần đó (các phần hoặc khóa không được hỗ trợ sẽ gây lỗi policy/policy-jsonc-invalid thay vì bị âm thầm bỏ qua). Ví dụ tối thiểu bao quát mọi phần được hỗ trợ:

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

Các lưu ý xuyên suốt không thể hiện rõ trong những bảng quy tắc bên dưới:

• Việc bỏ qua gateway.bind trong khi cấm liên kết không phải local loopback có nghĩa là bạn chấp nhận giá trị mặc định của thời gian chạy; hãy đặt gateway.bind: "loopback" để tuân thủ nghiêm ngặt.
• Đối với tác nhân chỉ đọc, hãy đặt mode của sandbox thành all hoặc non-main trong phần mặc định/tác nhân áp dụng, đồng thời đặt workspaceAccess thành none hoặc ro. Chế độ sandbox bị thiếu hoặc là off không đáp ứng policy chỉ đọc.
• agents.workspace.denyTools chấp nhận exec, process, write, edit, apply_patch. Các nhóm từ chối công cụ trong cấu hình là group:fs (thay đổi tệp) và group:runtime (shell/tiến trình) đáp ứng trạng thái tương đương.
• Các bước kiểm tra phê duyệt thực thi chỉ đọc thành phần exec-approvals.json đang hoạt động khi có quy tắc execApprovals; thành phần bị thiếu hoặc không hợp lệ là bằng chứng không thể quan sát, không phải kết quả đạt được tạo ra nhân tạo.
• Bằng chứng về bí mật và hồ sơ xác thực chỉ ghi lại trạng thái nhà cung cấp/nguồn và siêu dữ liệu SecretRef, tuyệt đối không ghi lại giá trị thô. Policy không đọc hoặc chứng thực các kho thông tin xác thực riêng của từng tác nhân như auth-profiles.json.
• Bằng chứng xử lý dữ liệu chỉ là trạng thái ở cấp cấu hình (chế độ biên tập, nút bật/tắt thu thập dữ liệu đo từ xa, chế độ bảo trì phiên, thiết lập lập chỉ mục bản chép lời phiên). Bằng chứng này không kiểm tra nhật ký, dữ liệu đo từ xa đã xuất, bản chép lời hoặc tệp bộ nhớ, và kết quả sạch không chứng minh rằng chúng không chứa dữ liệu cá nhân hoặc bí mật.

Tham chiếu quy tắc policy

Mọi quy tắc bên dưới đều là tùy chọn; một bước kiểm tra chỉ chạy khi có quy tắc đó. Trạng thái được quan sát là cấu hình OpenClaw hoặc siêu dữ liệu không gian làm việc hiện có.

Lớp phủ theo phạm vi

Sử dụng scopes.<scopeName> khi các tác nhân hoặc kênh cụ thể cần policy nghiêm ngặt hơn đường cơ sở cấp cao nhất. Tên phạm vi chỉ là một nhãn; việc đối sánh sử dụng bộ chọn bên trong phạm vi. Các lớp phủ mang tính cộng dồn: quy tắc toàn cục vẫn chạy và quy tắc theo phạm vi có thể thêm phát hiện riêng đối với cùng một bằng chứng.

Nếu một mục agentIds không có trong agents.list[], OpenClaw đánh giá quy tắc theo phạm vi dựa trên trạng thái toàn cục/mặc định được kế thừa cho mã định danh tác nhân thời gian chạy đó thay vì bỏ qua.

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

Cùng một tác nhân có thể xuất hiện trong nhiều phạm vi nếu mỗi phạm vi quản lý một trường khác nhau, như trên. Trường theo phạm vi lặp lại cho cùng một tác nhân phải có mức hạn chế tương đương hoặc cao hơn; khai báo trùng lặp ít hạn chế hơn sẽ bị từ chối (danh sách cho phép phải là tập con, danh sách từ chối phải là tập cha, các giá trị Boolean bắt buộc phải cố định).

Các quy tắc trạng thái vùng chứa (sandbox.containers.*) chỉ được kiểm tra dựa trên bằng chứng mà phần phụ trợ sandbox của tác nhân được đối sánh có thể cung cấp. Nếu phần phụ trợ không thể quan sát một quy tắc mà bạn đã bật cho nó, policy sẽ báo cáo policy/sandbox-container-posture-unobservable thay vì coi là đạt; hãy giới hạn phạm vi các quy tắc vùng chứa cho những nhóm tác nhân sử dụng phần phụ trợ có khả năng cung cấp bằng chứng đó.

ingress.session.requireDmScope cấp cao nhất vẫn mang tính toàn cục; session.dmScope không phải bằng chứng có thể quy cho kênh, vì vậy không thể giới hạn phạm vi bằng channelIds.

Mọi phạm vi có trong policy.jsonc đều phải hợp lệ và có thể thực thi.

Kênh

Máy chủ MCP

Nhà cung cấp mô hình

Mạng

Quyền truy cập đầu vào và kênh

Gateway

gateway.nodes.denyCommands là quy tắc tập bao từ chối chính xác, phân biệt chữ hoa chữ thường. Sử dụng quy tắc này khi chính sách phải chứng minh rằng các lệnh node đặc quyền bị từ chối rõ ràng trong cấu hình OpenClaw. Một bản triển khai chủ ý cho phép lệnh node đặc quyền nên cập nhật policy.jsonc sau khi xem xét thay vì chỉ dựa vào gateway.nodes.allowCommands.

Không gian làm việc của tác nhân

Trạng thái sandbox

Chính sách coi sandbox.mode bị thiếu là giá trị mặc định ngầm định off, vì vậy sandbox.requireMode báo cáo sandbox mới hoặc chưa được cấu hình là nằm ngoài danh sách cho phép như ["all"].

Xử lý dữ liệu

Bí mật

Phê duyệt thực thi

Các kiểm tra phê duyệt thực thi đọc cấu phần exec-approvals.json thời gian chạy: mặc định là ~/.openclaw/exec-approvals.json, hoặc $OPENCLAW_STATE_DIR/exec-approvals.json khi OPENCLAW_STATE_DIR được đặt. Các quy tắc trạng thái trong execApprovals.defaults.* hoặc execApprovals.agents.* yêu cầu bằng chứng cấu phần có thể đọc được; cấu phần bị thiếu hoặc không hợp lệ được báo cáo là bằng chứng không thể quan sát thay vì được thông qua theo nguyên tắc nỗ lực tối đa. Sau khi có thể đọc, các trường bị bỏ qua sẽ kế thừa giá trị mặc định thời gian chạy: thiếu defaults.security sẽ là full, và bảo mật tác nhân bị thiếu sẽ kế thừa giá trị mặc định đó. Bằng chứng bao gồm defaults, agents.*, agents.*.allowlist[].pattern, argPattern tùy chọn, trạng thái autoAllowSkills có hiệu lực và nguồn mục nhập — tuyệt đối không bao gồm đường dẫn socket/token, commandText, lastUsedCommand, đường dẫn đã phân giải hoặc dấu thời gian.

Ví dụ: yêu cầu cấu phần phê duyệt, từ chối các giá trị mặc định dễ dãi và chỉ cho phép trạng thái phê duyệt thực thi đã được xem xét cho các tác nhân được chọn.

{  "execApprovals": {    "requireFile": true,    "defaults": {      // Chế độ bảo mật: "deny", "allowlist" hoặc "full".      // Giá trị mặc định này chỉ cho phép tư thế từ chối được khóa chặt.      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // Các tác nhân được chọn có thể sử dụng tư thế danh sách cho phép đã qua xét duyệt, nhưng không được dùng "full".          "allowSecurity": ["allowlist"],          // false có nghĩa là các CLI của skill phải xuất hiện trong danh sách cho phép đã qua xét duyệt thay vì          // được autoAllowSkills phê duyệt ngầm.          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // Mục đơn giản: mẫu tệp thực thi chính xác đã qua xét duyệt, không có argPattern.              "travel-hub",              // Mục bị ràng buộc: mẫu cùng biểu thức chính quy đối số đã qua xét duyệt.              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

Hồ sơ xác thực

Siêu dữ liệu công cụ

Tư thế công cụ

Chạy kiểm tra

Chỉ chạy các kiểm tra chính sách trong quá trình biên soạn:

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

policy check chỉ chạy tập kiểm tra chính sách và xuất ra bằng chứng, phát hiện và hàm băm chứng thực. Các phát hiện tương tự cũng xuất hiện trong openclaw doctor --lint khi Plugin Policy được bật.

So sánh tệp chính sách của đơn vị vận hành với đường cơ sở đã biên soạn:

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

policy compare kiểm tra cú pháp tệp chính sách so với cú pháp tệp chính sách; lệnh này không kiểm tra trạng thái thời gian chạy, bằng chứng, thông tin xác thực hoặc bí mật. Lệnh sử dụng cùng siêu dữ liệu quy tắc chi phối các lớp phủ theo phạm vi: danh sách cho phép phải giữ nguyên hoặc hẹp hơn, danh sách từ chối phải giữ nguyên hoặc rộng hơn, các giá trị boolean bắt buộc phải giữ nguyên giá trị, chuỗi có thứ tự chỉ có thể di chuyển về phía nghiêm ngặt hơn trong thứ tự đã cấu hình và các danh sách chính xác phải khớp. Đường cơ sở có thể là chính sách do tổ chức biên soạn; chính sách được kiểm tra có thể thêm các giá trị nghiêm ngặt hơn hoặc các quy tắc bổ sung. Một quy tắc cấp cao nhất được kiểm tra có thể đáp ứng quy tắc đường cơ sở theo phạm vi khi nó có mức hạn chế tương đương hoặc cao hơn. Tên phạm vi không cần phải khớp giữa các tệp; phép so sánh được định khóa theo bộ chọn (agentIds/channelIds) và trường.

Kết quả so sánh sạch (--json):

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

Đầu ra sạch của policy check --json bao gồm các hàm băm ổn định mà đơn vị vận hành hoặc bộ giám sát có thể ghi lại:

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

Cấu hình chính sách

Cấu hình chính sách nằm trong plugins.entries.policy.config.

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

Đặt plugins.entries.policy.config.enabled thành false để vô hiệu hóa các kiểm tra chính sách cho một không gian làm việc trong khi vẫn giữ Plugin được cài đặt.

Chấp nhận trạng thái chính sách

Ví dụ đầu ra 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 xác định hiện vật quy tắc đã biên soạn. evidence ghi lại trạng thái OpenClaw quan sát được mà các kiểm tra sử dụng và workspace.hash xác định tải trọng bằng chứng đó. findingsHash xác định chính xác tập phát hiện. checkedAt ghi lại thời điểm kiểm tra được chạy. attestationHash xác định tuyên bố ổn định (hàm băm chính sách, hàm băm bằng chứng, hàm băm phát hiện và trạng thái sạch/bẩn) và chủ ý loại trừ checkedAt, vì vậy cùng một trạng thái chính sách luôn tạo ra cùng một hàm băm chứng thực. Khi kết hợp, bốn giá trị này tạo thành bộ kiểm toán cho một lần kiểm tra chính sách.

Nếu Gateway hoặc bộ giám sát sử dụng chính sách để chặn, phê duyệt hoặc chú giải một hành động thời gian chạy, thành phần đó nên ghi lại hàm băm chứng thực từ lần kiểm tra sạch gần nhất. checkedAt vẫn nằm trong đầu ra JSON dành cho nhật ký kiểm toán nhưng không phải là một phần của hàm băm ổn định.

Vòng đời chấp nhận trạng thái chính sách:

1. Biên soạn hoặc xét duyệt policy.jsonc.
2. Chạy openclaw policy check --json.
3. Nếu sạch, ghi lại attestation.policy.hash làm expectedHash.
4. Ghi lại attestation.attestationHash làm expectedAttestationHash.
5. Chạy lại openclaw doctor --lint trong CI hoặc các cổng phát hành.

Nếu các quy tắc chính sách được thay đổi có chủ đích, hãy cập nhật cả hai hàm băm được chấp nhận từ một lần kiểm tra sạch. Nếu chỉ các thiết lập không gian làm việc thay đổi (chính sách không đổi), thông thường chỉ expectedAttestationHash thay đổi.

Việc bật hoặc nâng cấp các quy tắc agents.workspace sẽ thêm bằng chứng agentWorkspace vào hàm băm không gian làm việc và hàm băm chứng thực; hãy xem xét bằng chứng mới và làm mới các hàm băm chứng thực được chấp nhận sau khi bật. Việc bật hoặc nâng cấp các quy tắc trạng thái công cụ cũng thêm bằng chứng toolPosture theo cách tương tự.

openclaw policy watch chạy lại bước kiểm tra và báo cáo khi bằng chứng hiện tại không còn khớp với expectedAttestationHash:

openclaw policy watch --json

Sử dụng --once trong CI hoặc các tập lệnh cần đánh giá độ lệch một lần. Nếu không có --once, theo mặc định lệnh sẽ thăm dò mỗi hai giây; sử dụng --interval-ms để thay đổi khoảng thời gian.

Các phát hiện

Một phát hiện có thể bao gồm cả target (thành phần được quan sát trong không gian làm việc không tuân thủ) và requirement (quy tắc được soạn thảo khiến thành phần đó trở thành một phát hiện). Hiện tại cả hai đều là chuỗi địa chỉ oc://, nhưng tên trường mô tả vai trò trong chính sách thay vì định dạng địa chỉ.

Ví dụ về các phát hiện:

{  "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": "Máy chủ MCP 'remote' không nằm trong danh sách cho phép của chính sách.",  "source": "policy",  "path": "cấu hình 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": "Tham chiếu mô hình 'anthropic/claude-sonnet-4.7' sử dụng nhà cung cấp chưa được phê duyệt 'anthropic'.",  "source": "policy",  "path": "cấu hình 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": "Thiết lập mạng 'browser-private-network' cho phép truy cập mạng riêng.",  "source": "policy",  "path": "cấu hình 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": "Thiết lập liên kết Gateway 'gateway-bind' cho phép công khai qua địa chỉ không phải local loopback.",  "source": "policy",  "path": "cấu hình openclaw",  "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": "Lệnh Node Gateway 'system.run' bị chính sách từ chối nhưng không bị cấu hình OpenClaw từ chối.",  "source": "policy",  "path": "cấu hình openclaw",  "ocPath": "oc://openclaw.config/gateway/nodes/denyCommands",  "target": "oc://openclaw.config/gateway/nodes/denyCommands",  "requirement": "oc://policy.jsonc/gateway/nodes/denyCommands",  "fixHint": "Thêm 'system.run' vào gateway.nodes.denyCommands hoặc cập nhật chính sách sau khi xem xét."}

{  "checkId": "policy/agents-workspace-access-denied",  "severity": "error",  "message": "Quyền workspaceAccess 'rw' của hộp cát agents.defaults không được chính sách cho phép.",  "source": "policy",  "path": "cấu hình openclaw",  "ocPath": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "target": "oc://openclaw.config/agents/defaults/sandbox/workspaceAccess",  "requirement": "oc://policy.jsonc/agents/workspace/allowedAccess"}

Sửa chữa

doctor --lint và policy check chỉ đọc.

doctor --fix chỉ chỉnh sửa các thiết lập không gian làm việc do chính sách quản lý khi workspaceRepairs được bật rõ ràng; nếu không, các lượt kiểm tra sẽ báo cáo những gì chúng sẽ sửa chữa và giữ nguyên các thiết lập.

Trong phiên bản này, chức năng sửa chữa có thể vô hiệu hóa các kênh bị channels.denyRules từ chối và áp dụng các biện pháp tự động thu hẹp quyền được liệt kê bên dưới. Chỉ bật workspaceRepairs sau khi đã xem xét tệp chính sách, vì một quy tắc hợp lệ có thể thay đổi cấu hình không gian làm việc:

• đặt tools.elevated.enabled=false khi chính sách toàn cục cấm các công cụ có đặc quyền nâng cao
• thêm các mã định danh công cụ bắt buộc phải từ chối còn thiếu vào tools.deny hoặc agents.list[].tools.deny khi chính sách yêu cầu từ chối các công cụ đó
• đặt các tùy chọn bật/tắt gateway.controlUi.* không an toàn thành false
• đặt gateway.mode=local khi chính sách từ chối chế độ Gateway từ xa
• đặt các đường dẫn gateway.http.endpoints.*.enabled được báo cáo thành false khi chính sách từ chối các điểm cuối API HTTP của Gateway
• đặt các đường dẫn groupPolicy tiếp nhận kênh được báo cáo thành allowlist khi chính sách từ chối tiếp nhận nhóm mở
• đặt các đường dẫn requireMention tiếp nhận kênh được báo cáo thành true khi chính sách yêu cầu đề cập trong nhóm
• đặt logging.redactSensitive=tools khi chính sách yêu cầu che thông tin nhạy cảm trong nhật ký
• đặt diagnostics.otel.captureContent=false, hoặc diagnostics.otel.captureContent.enabled=false đối với các thiết lập thu thập dữ liệu đo từ xa ở dạng đối tượng, khi chính sách từ chối thu thập nội dung dữ liệu đo từ xa

Các biện pháp sửa chữa công cụ có đặc quyền nâng cao theo phạm vi chỉ được phát hiện, không được áp dụng. Các biện pháp sửa chữa xử lý dữ liệu theo phạm vi cũng bị bỏ qua khi phát hiện báo cáo cấu hình ghi nhật ký hoặc dữ liệu đo từ xa dùng chung, vì việc thay đổi thiết lập dùng chung sẽ ảnh hưởng đến nhiều đối tượng hơn mục tiêu chính sách theo phạm vi.

Các biện pháp sửa chữa bắt buộc từ chối theo phạm vi bị bỏ qua khi phát hiện báo cáo tools.deny gốc được kế thừa, vì việc thêm công cụ bắt buộc vào cấu hình gốc sẽ ảnh hưởng đến nhiều đối tượng hơn mục tiêu chính sách theo phạm vi. Các biện pháp sửa chữa bắt buộc từ chối cục bộ cho tác nhân có thể cập nhật đường dẫn agents.list[].tools.deny được báo cáo.

Các biện pháp sửa chữa tiếp nhận kênh theo phạm vi bị bỏ qua khi phát hiện báo cáo channels.defaults.* được kế thừa, vì việc thay đổi giá trị mặc định dùng chung của kênh sẽ ảnh hưởng đến nhiều đối tượng hơn mục tiêu chính sách theo phạm vi. Các phát hiện về danh sách cho phép tìm nạp URL qua HTTP của Gateway vẫn cần xử lý thủ công vì chức năng sửa chữa tự động không thể chọn đúng các giá trị danh sách URL cho phép của điểm cuối.

Các phát hiện về liên kết Gateway và lệnh Node vẫn yêu cầu xem xét. Khi policy/gateway-non-loopback-bind hoặc policy/gateway-node-command-denied có thể được ánh xạ tới một đường dẫn cấu hình, doctor --fix sẽ báo cáo thay đổi gateway.bind hoặc gateway.nodes.denyCommands được đề xuất dưới dạng hướng dẫn xem trước đã bỏ qua. Lệnh không áp dụng thay đổi và phát hiện không được tính là đã sửa chữa cho đến khi người vận hành xem xét và cập nhật cấu hình hoặc chính sách.

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

Mã thoát

Liên quan

• Chế độ lint của Doctor
• CLI đường dẫn