Chính sách

​

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 nằm trên các cài đặt 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 các lệnh gọi công cụ hoặc viết lại hành vi runtime 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 theo từng agent 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 SSRF mạng, quyền truy cập đầu vào/kênh, mức độ phơi bày Gateway và trạng thái lệnh Node, các phép kiểm tra định tuyến thông điệp đã soạn, quyền truy cập không gian làm việc của agent, 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ụ được quản trị (TOOLS.md). Hãy sử dụng khi một không gian làm việc cần một tuyên bố bền vững, có thể kiểm tra, chẳng hạn như “Không được bật Telegram” hoặc “các công cụ được quản trị phải khai báo siêu dữ liệu về rủi ro và chủ sở hữu”. Nếu 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, để doctor có thể báo cáo cấu phần bị thiếu thay vì âm thầm bỏ qua các bước kiểm tra.

Hãy soạn policy.jsonc thủ công; tệp này không được tạo từ các cài đặt 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ó một quy tắc cụ thể bên dưới phần đó (các phần hoặc khóa không được hỗ trợ sẽ thất bại vớ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 không được phê duyệt cho không gian làm việc này.",
      },
    ],
  },
  "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": "[phone]" },
        },
        "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"],
  },
}

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

• Việc bỏ qua gateway.bind trong khi từ chối liên kết không phải loopback có nghĩa là bạn chấp nhận giá trị mặc định của runtime; hãy đặt gateway.bind: "loopback" để tuân thủ nghiêm ngặt.
• Đối với agent chỉ đọc, hãy đặt mode của sandbox thành all hoặc non-main trong phần mặc định/agent áp dụng và workspaceAccess thành none hoặc ro. Chế độ sandbox bị thiếu hoặc 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 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 cấu phần exec-approvals.json đang hoạt động khi có quy tắc execApprovals; cấu 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 một kết quả đạt giả lập.
• 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, không bao giờ 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 theo từng agent 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ế độ che dữ liệu, nút bật/tắt thu thập từ xa, chế độ bảo trì phiên, cài đặt lập chỉ mục bản chép lời phiên). Nó không kiểm tra nhật ký, dữ liệu xuất thu thập từ xa, 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.
• Các phép kiểm tra định tuyến tái sử dụng trình phân giải liên kết runtime của OpenClaw. Bằng chứng định tuyến chỉ ghi lại id phép kiểm tra, agent được phân giải, loại khớp và siêu dữ liệu liên kết đã được che. Nó không bao giờ ghi lại mã định danh của đối tác, tài khoản, guild, nhóm hoặc vai trò. Việc thêm một phần định tuyến chủ ý thay đổi các hàm băm policy và chứng thực; các policy không có định tuyến giữ nguyên hình dạng bằng chứng hiện có.

​

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 quan sát được là cấu hình hoặc siêu dữ liệu không gian làm việc OpenClaw hiện có.

​

Lớp phủ theo phạm vi

Sử dụng scopes.<scopeName> khi các agent 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 khớp sử dụng bộ chọn bên trong phạm vi. Các lớp phủ mang tính bổ sung: 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 dựa trên cùng bằng chứng.

Bộ chọn	Các phần được hỗ trợ	Sử dụng khi
agentIds	tools, agents.workspace, sandbox, dataHandling.memory, execApprovals	Một hoặc nhiều agent runtime cần quy tắc nghiêm ngặt hơn.
channelIds	ingress.channels	Một hoặc nhiều kênh cần quy tắc đầu vào nghiêm ngặt hơn.

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 id agent runtime đó 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 agent có thể xuất hiện trong nhiều phạm vi nếu mỗi phạm vi quản trị một trường khác nhau, như trên. Một trường theo phạm vi lặp lại cho cùng một agent phải nghiêm ngặt tương đương hoặc hơn; một khai báo trùng lặp yếu hơn sẽ bị từ chối (danh sách cho phép là tập con, danh sách từ chối là tập cha, các giá trị boolean bắt buộc là cố định).

Các quy tắc trạng thái container (sandbox.containers.*) chỉ được kiểm tra dựa trên bằng chứng mà backend sandbox của agent được khớp có thể cung cấp. Nếu một backend không thể quan sát quy tắc bạn đã bật cho nó, policy sẽ báo cáo policy/sandbox-container-posture-unobservable thay vì đạt; hãy giới hạn quy tắc container trong phạm vi các nhóm agent sử dụng backend có thể 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ể đặt 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

Trường policy	Trạng thái quan sát được	Sử dụng khi
channels.denyRules[].when.provider	Nhà cung cấp channels.* và trạng thái bật	Từ chối các kênh đã cấu hình từ một nhà cung cấp như telegram.
channels.denyRules[].reason	Thông báo phát hiện và ngữ cảnh gợi ý khắc phục	Giải thích lý do nhà cung cấp bị từ chối.

​

Máy chủ MCP

Trường policy	Trạng thái quan sát được	Sử dụng khi
mcp.servers.allow	Các id mcp.servers.*	Yêu cầu mọi máy chủ MCP đã cấu hình phải nằm trong danh sách cho phép.
mcp.servers.deny	Các id mcp.servers.*	Từ chối các id máy chủ MCP cụ thể đã cấu hình.

​

Nhà cung cấp mô hình

Trường policy	Trạng thái quan sát được	Sử dụng khi
models.providers.allow	Các id models.providers.* và tham chiếu mô hình đã chọn	Yêu cầu các nhà cung cấp đã cấu hình và tham chiếu mô hình đã chọn sử dụng nhà cung cấp được phê duyệt.
models.providers.deny	Các id models.providers.* và tham chiếu mô hình đã chọn	Từ chối các nhà cung cấp đã cấu hình và tham chiếu mô hình đã chọn theo id nhà cung cấp.

​

Mạng

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
network.privateNetwork.allow	Các cơ chế ngoại lệ cho phép SSRF truy cập mạng riêng	Đặt thành false để yêu cầu luôn vô hiệu hóa quyền truy cập mạng riêng.

​

Định tuyến tin nhắn

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
routing.requireBindings	Các liên kết định tuyến kênh, không bao gồm liên kết ACP	Yêu cầu ít nhất một liên kết định tuyến tin nhắn.
routing.requireConfiguredChannels	ID kênh của liên kết và các ID channels.* đã cấu hình	Phát hiện các ID kênh liên kết đã lỗi thời hoặc bị viết sai.
routing.probes[].route	Bộ phân giải định tuyến công khai của OpenClaw	Mô tả một tuyến đến đại diện mà không gửi tin nhắn.
routing.probes[].expect.agentId	ID tác tử đã phân giải	Yêu cầu tuyến đến được tác tử đã được review.
routing.probes[].expect.matchedBy	Loại khớp của bộ phân giải	Yêu cầu mức độ cụ thể của liên kết đã được review theo đối tác, tài khoản, kênh hoặc loại khác.

ID đầu dò phải là duy nhất. Một tuyến hỗ trợ channel, accountId tùy chọn, peer, parentPeer, guildId, teamId và memberRoleIds. Các loại đối tác là direct, group và channel. matchedBy có thể chứa một hoặc nhiều loại khớp thời gian chạy, bao gồm binding.peer, binding.account, binding.channel hoặc default.

Các kiểm tra định tuyến chỉ là kiểm tra tính tuân thủ. Chúng không thay đổi quá trình khởi động, phân phối tin nhắn, thứ tự ưu tiên liên kết hoặc hành vi dự phòng. Các phát hiện yêu cầu người vận hành review vì việc tự động thay đổi một liên kết có thể chuyển hướng tin nhắn riêng tư.

​

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

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
ingress.session.requireDmScope	session.dmScope	Yêu cầu phạm vi cô lập tin nhắn trực tiếp đã được review.
ingress.channels.allowDmPolicies	channels.*.dmPolicy và các trường chính sách DM kênh cũ	Chỉ cho phép các chính sách kênh tin nhắn trực tiếp đã được review.
ingress.channels.denyOpenGroups	Chính sách đầu vào của kênh, tài khoản và nhóm	Từ chối đầu vào nhóm mở đối với các kênh và tài khoản đã cấu hình.
ingress.channels.requireMentionInGroups	Cấu hình cổng đề cập cho kênh, tài khoản, nhóm, guild và các cấp lồng nhau	Yêu cầu cổng đề cập khi đầu vào nhóm mở hoặc bị kiểm soát bằng đề cập.

​

Gateway

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
gateway.exposure.allowNonLoopbackBind	gateway.bind	Đặt thành false để yêu cầu liên kết Gateway với loopback.
gateway.exposure.allowTailscaleFunnel	Trạng thái Gateway serve/funnel của Tailscale	Đặt thành false để từ chối việc phơi bày qua Tailscale Funnel.
gateway.auth.requireAuth	gateway.auth.mode	Đặt thành true để từ chối xác thực Gateway bị vô hiệu hóa.
gateway.auth.requireExplicitRateLimit	gateway.auth.rateLimit	Đặt thành true để yêu cầu cấu hình giới hạn tốc độ xác thực rõ ràng.
gateway.controlUi.allowInsecure	Các nút bật/tắt xác thực, thiết bị hoặc nguồn không an toàn của giao diện điều khiển	Đặt thành false để từ chối các nút bật/tắt phơi bày giao diện điều khiển không an toàn.
gateway.remote.allow	Chế độ/cấu hình Gateway từ xa	Đặt thành false để từ chối chế độ Gateway từ xa.
gateway.http.denyEndpoints	Các điểm cuối API HTTP của Gateway	Từ chối các ID điểm cuối như chatCompletions hoặc responses.
gateway.http.requireUrlAllowlists	Đầu vào tìm nạp URL qua HTTP của Gateway	Đặt thành true để yêu cầu danh sách cho phép URL trên các đầu vào tìm nạp URL.
gateway.nodes.denyCommands	gateway.nodes.denyCommands	Yêu cầu các ID lệnh Node chính xác như system.run bị từ chối trong cấu hình OpenClaw.

gateway.nodes.denyCommands là quy tắc tập cha 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 được cấu hình OpenClaw từ chối rõ ràng. Một bản triển khai cố ý cho phép một lệnh Node đặc quyền nên cập nhật policy.jsonc sau khi review thay vì chỉ dựa vào gateway.nodes.allowCommands.

​

Không gian làm việc của tác tử

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
agents.workspace.allowedAccess	agents.defaults.sandbox.workspaceAccess và agents.list[].sandbox.workspaceAccess	Chỉ cho phép các giá trị truy cập không gian làm việc sandbox như none hoặc ro.
agents.workspace.denyTools	Cấu hình từ chối công cụ toàn cục và theo từng tác tử	Yêu cầu từ chối các công cụ thay đổi (exec, process, write, edit, apply_patch).

​

Trạng thái sandbox

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
sandbox.requireMode	agents.defaults.sandbox.mode và chế độ theo từng tác tử	Chỉ cho phép các chế độ sandbox đã được review như all hoặc non-main.
sandbox.allowBackends	agents.defaults.sandbox.backend và backend theo từng tác tử	Chỉ cho phép các backend sandbox đã được review như docker.
sandbox.containers.denyHostNetwork	Chế độ mạng của sandbox/trình duyệt dựa trên container	Từ chối chế độ mạng máy chủ.
sandbox.containers.denyContainerNamespaceJoin	Chế độ mạng của sandbox/trình duyệt dựa trên container	Từ chối tham gia không gian tên mạng của container khác.
sandbox.containers.requireReadOnlyMounts	Chế độ gắn kết của sandbox/trình duyệt dựa trên container	Yêu cầu các điểm gắn kết ở chế độ chỉ đọc.
sandbox.containers.denyContainerRuntimeSocketMounts	Đích gắn kết của sandbox/trình duyệt dựa trên container	Từ chối gắn kết socket của runtime container.
sandbox.containers.denyUnconfinedProfiles	Trạng thái hồ sơ bảo mật container	Từ chối các hồ sơ bảo mật container không bị giới hạn.
sandbox.browser.requireCdpSourceRange	Dải nguồn CDP của trình duyệt sandbox	Yêu cầu việc phơi bày CDP của trình duyệt phải khai báo một dải nguồn.

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 một 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

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
dataHandling.sensitiveLogging.requireRedaction	logging.redactSensitive	Đặt thành true để từ chối logging.redactSensitive: "off".
dataHandling.telemetry.denyContentCapture	diagnostics.otel.captureContent	Đặt thành true để từ chối việc thu thập nội dung từ xa.
dataHandling.retention.requireSessionMaintenance	session.maintenance.mode	Đặt thành true để yêu cầu chế độ bảo trì phiên có hiệu lực là enforce.
dataHandling.memory.denySessionTranscriptIndexing	memory.qmd.sessions.enabled và agents.*.memorySearch.experimental.sessionMemory	Đặt thành true để từ chối lập chỉ mục bản ghi phiên vào bộ nhớ.

​

Bí mật

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
secrets.requireManagedProviders	SecretRef trong cấu hình và các khai báo secrets.providers.*	Đặt thành true để yêu cầu SecretRef trỏ đến các nhà cung cấp đã khai báo.
secrets.denySources	Nguồn nhà cung cấp bí mật và nguồn SecretRef	Từ chối các nguồn như exec, file hoặc một tên nguồn đã cấu hình khác.
secrets.allowInsecureProviders	Các cờ trạng thái nhà cung cấp bí mật không an toàn	Đặt thành false để từ chối các nhà cung cấp chọn sử dụng trạng thái không an toàn.

​

Phê duyệt thực thi

Các kiểm tra phê duyệt thực thi đọc cấu phần runtime exec-approvals.json: mặc định là ~/.openclaw/exec-approvals.json, hoặc $OPENCLAW_STATE_DIR/exec-approvals.json khi đặt OPENCLAW_STATE_DIR. 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 cho qua theo nỗ lực tối đa. Sau khi có thể đọc, các trường bị bỏ qua kế thừa giá trị mặc định của runtime: defaults.security bị thiếu là full, và bảo mật tác tử bị thiếu 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 — không bao giờ bao gồm đường dẫn socket/token, commandText, lastUsedCommand, đường dẫn đã phân giải hoặc dấu thời gian.

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
execApprovals.requireFile	Đường dẫn exec-approvals.json của môi trường chạy đang hoạt động	Đặt thành true để yêu cầu cấu phần phê duyệt phải tồn tại và có thể được phân tích cú pháp.
execApprovals.defaults.allowSecurity	defaults.security, mặc định là full	Chỉ cho phép các chế độ bảo mật phê duyệt mặc định đã được chấp thuận.
execApprovals.agents.allowSecurity	agents.*.security, kế thừa các giá trị mặc định	Chỉ cho phép các chế độ bảo mật phê duyệt hiệu lực theo từng tác nhân đã được chấp thuận.
execApprovals.agents.allowAutoAllowSkills	defaults.autoAllowSkills và agents.*.autoAllowSkills, kế thừa các giá trị mặc định của môi trường chạy	Đặt thành false để yêu cầu danh sách cho phép thủ công nghiêm ngặt mà không ngầm phê duyệt CLI của skill.
execApprovals.agents.allowlist.expected	Mẫu agents.*.allowlist[] tổng hợp và các mục argPattern tùy chọn	Yêu cầu danh sách cho phép phê duyệt khớp với tập mẫu đã được review.

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 review đối với các tác nhân được chọn.

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

​

Hồ sơ xác thực

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
auth.profiles.requireMetadata	Siêu dữ liệu nhà cung cấp và chế độ auth.profiles.*	Yêu cầu các khóa siêu dữ liệu như provider và mode trên hồ sơ xác thực cấu hình.
auth.profiles.allowModes	auth.profiles.*.mode	Chỉ cho phép các chế độ hồ sơ xác thực được hỗ trợ như api_key, aws-sdk, oauth hoặc token.

​

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

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
tools.requireMetadata	Các khai báo TOOLS.md chịu sự quản lý	Yêu cầu các công cụ chịu sự quản lý khai báo các khóa siêu dữ liệu như risk, sensitivity hoặc owner.

​

Trạng thái công cụ

Trường chính sách	Trạng thái quan sát được	Sử dụng khi
tools.profiles.allow	tools.profile và agents.list[].tools.profile	Chỉ cho phép các mã định danh hồ sơ công cụ như minimal, messaging hoặc coding.
tools.fs.requireWorkspaceOnly	tools.fs.workspaceOnly và các giá trị ghi đè tools.fs theo từng tác nhân	Đặt thành true để yêu cầu trạng thái công cụ hệ thống tệp chỉ giới hạn trong không gian làm việc.
tools.exec.allowSecurity	tools.exec.security và bảo mật thực thi theo từng tác nhân	Chỉ cho phép các chế độ bảo mật thực thi như deny hoặc allowlist.
tools.exec.requireAsk	tools.exec.ask và chế độ hỏi khi thực thi theo từng tác nhân	Yêu cầu trạng thái phê duyệt như always.
tools.exec.allowHosts	tools.exec.host và định tuyến máy chủ thực thi theo từng tác nhân	Chỉ cho phép các chế độ định tuyến máy chủ thực thi như sandbox.
tools.elevated.allow	tools.elevated.enabled và trạng thái đặc quyền theo từng tác nhân	Đặt thành false để yêu cầu chế độ công cụ đặc quyền luôn bị vô hiệu hóa.
tools.alsoAllow.expected	tools.alsoAllow và tools.alsoAllow theo từng tác nhân	Yêu cầu các mục alsoAllow khớp chính xác và báo cáo các quyền cấp công cụ bổ sung bị thiếu hoặc ngoài dự kiến.
tools.denyTools	tools.deny và agents.list[].tools.deny	Yêu cầu danh sách từ chối công cụ đã cấu hình bao gồm các mã định danh hoặc nhóm công cụ như group:runtime và group:fs.

​

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 check
openclaw policy check --json
openclaw policy check --severity-min error

policy check chỉ chạy tập kiểm tra chính sách và xuất bằng chứng, phát hiện cùng các 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 người vận hành với đường cơ sở đã biên soạn:

openclaw policy compare --baseline official.policy.jsonc
openclaw 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 môi trường 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ủ có 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ị, các chuỗi có thứ tự chỉ được 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 một quy tắc đường cơ sở có phạm vi khi nó hạn chế tương đương hoặc nghiêm ngặt hơn. Tên phạm vi không cần khớp giữa các tệp; phép so sánh được lập khóa theo bộ chọn (agentIds/channelIds) và trường. Đối với các phép thăm dò định tuyến, mọi mã định danh phép thăm dò trong đường cơ sở phải được giữ lại với cùng tuyến và tác nhân dự kiến. Chính sách được kiểm tra có thể thêm phép thăm dò hoặc thu hẹp matchedBy, nhưng việc xóa một phép thăm dò, thay đổi tuyến hoặc tác nhân của nó hay mở rộng các loại khớp được chấp nhận đều làm chính sách yếu hơn.

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

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

Đầu ra policy check --json sạch bao gồm các hàm băm ổn định mà người vận hành hoặc người 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:...",
        },
      },
    },
  },
}

Cài đặt	Mục đích
enabled	Bật kiểm tra chính sách ngay cả trước khi policy.jsonc tồn tại.
workspaceRepairs	Cho phép doctor --fix chỉnh sửa các cài đặt không gian làm việc do chính sách quản lý.
expectedHash	Khóa hàm băm tùy chọn cho cấu phần chính sách đã được phê duyệt.
expectedAttestationHash	Khóa hàm băm tùy chọn cho lần kiểm tra chính sách sạch được chấp nhận gần nhất.
path	Vị trí tương đối với không gian làm việc của cấu phần chính sách.

Đặ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ụ về đầ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 cấu phần quy tắc đã được biên soạn. evidence ghi lại trạng thái OpenClaw quan sát được mà các bướ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 hợp phát hiện. checkedAt ghi lại thời điểm chạy kiểm tra. 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, để 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. Kết hợp lại, bốn giá trị này tạo thành bộ giá trị kiểm toán cho một lần kiểm tra chính sách.

Nếu Gateway hoặc trình giám sát dùng chính sách để chặn, phê duyệt hoặc chú thích một hành động khi chạy, 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 thuộc 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 review policy.jsonc.
2. Chạy openclaw policy check --json.
3. Nếu sạch, ghi attestation.policy.hash dưới dạng expectedHash.
4. Ghi attestation.attestationHash dưới dạng 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 chủ ý thay đổi, hãy cập nhật cả hai hàm băm đã chấp nhận từ một lần kiểm tra sạch. Nếu chỉ các cài đặt không gian làm việc thay đổi (chính sách giữ nguyên), 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 review bằng chứng mới và làm mới các hàm băm chứng thực đã chấp nhận sau khi bật. Việc bật hoặc nâng cấp các quy tắc về 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 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 một lần đánh giá độ lệch duy nhất. Khi 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

ID kiểm tra	Phát hiện
policy/policy-jsonc-missing	Chính sách đã được bật nhưng thiếu policy.jsonc.
policy/policy-jsonc-invalid	Không thể phân tích cú pháp chính sách hoặc chính sách chứa các mục quy tắc sai định dạng.
policy/policy-hash-mismatch	Chính sách không khớp với expectedHash đã cấu hình.
policy/attestation-hash-mismatch	Bằng chứng chính sách hiện tại không còn khớp với chứng thực đã được chấp nhận.
policy/policy-conformance-invalid	Tệp chính sách đường cơ sở hoặc tệp được kiểm tra có cú pháp so sánh không hợp lệ.
policy/policy-conformance-missing	Tệp chính sách được kiểm tra thiếu một quy tắc bắt buộc theo tệp chính sách đường cơ sở.
policy/policy-conformance-weaker	Tệp chính sách được kiểm tra có giá trị yếu hơn tệp chính sách đường cơ sở.
policy/channels-denied-provider	Một kênh đã bật khớp với quy tắc từ chối kênh.
policy/mcp-denied-server	Một máy chủ MCP đã cấu hình bị chính sách từ chối.
policy/mcp-unapproved-server	Một máy chủ MCP đã cấu hình nằm ngoài danh sách cho phép.
policy/models-denied-provider	Một nhà cung cấp mô hình hoặc tham chiếu mô hình đã cấu hình sử dụng nhà cung cấp bị từ chối.
policy/models-unapproved-provider	Một nhà cung cấp mô hình hoặc tham chiếu mô hình đã cấu hình nằm ngoài danh sách cho phép.
policy/network-private-access-enabled	Một cơ chế thoát SSRF cho mạng riêng được bật trong khi chính sách từ chối cơ chế đó.
policy/routing-bindings-required	Chính sách yêu cầu liên kết tuyến kênh nhưng chưa có liên kết nào được cấu hình.
policy/routing-binding-channel-unconfigured	Một liên kết tuyến chỉ định một kênh không có trong channels.*.
policy/routing-agent-mismatch	Một tuyến đã khai báo phân giải thành một tác nhân khác.
policy/routing-match-kind-mismatch	Một tuyến đã khai báo khớp ở độ đặc hiệu liên kết không như mong đợi.
policy/ingress-dm-policy-unapproved	Chính sách DM của một kênh nằm ngoài danh sách cho phép của chính sách.
policy/ingress-dm-scope-unapproved	session.dmScope không khớp với phạm vi cô lập DM mà chính sách yêu cầu.
policy/ingress-open-groups-denied	Chính sách nhóm của một kênh là open trong khi chính sách từ chối lưu lượng nhóm mở đi vào.
policy/ingress-group-mention-required	Một mục kênh hoặc nhóm vô hiệu hóa cổng đề cập trong khi chính sách yêu cầu các cổng này.
policy/gateway-non-loopback-bind	Trạng thái liên kết Gateway cho phép phơi bày ngoài loopback trong khi chính sách từ chối điều đó.
policy/gateway-auth-disabled	Xác thực Gateway bị vô hiệu hóa trong khi chính sách yêu cầu xác thực.
policy/gateway-rate-limit-missing	Trạng thái giới hạn tốc độ xác thực Gateway không được chỉ định rõ trong khi chính sách yêu cầu.
policy/gateway-control-ui-insecure	Các tùy chọn phơi bày không an toàn của Giao diện điều khiển Gateway đang được bật.
policy/gateway-tailscale-funnel	Phơi bày Gateway qua Tailscale Funnel được bật trong khi chính sách từ chối điều đó.
policy/gateway-remote-enabled	Chế độ từ xa của Gateway đang hoạt động trong khi chính sách từ chối chế độ này.
policy/gateway-http-endpoint-enabled	Một điểm cuối API HTTP của Gateway được bật dù bị chính sách từ chối.
policy/gateway-http-url-fetch-unrestricted	Đầu vào tìm nạp URL qua HTTP của Gateway thiếu danh sách URL cho phép bắt buộc.
policy/gateway-node-command-denied	Một lệnh Node bị chính sách từ chối nhưng không bị cấu hình OpenClaw từ chối.
policy/agents-workspace-access-denied	Chế độ sandbox hoặc quyền truy cập không gian làm việc của tác nhân nằm ngoài danh sách cho phép của chính sách.
policy/agents-tool-not-denied	Cấu hình tác nhân hoặc cấu hình mặc định không từ chối một công cụ mà chính sách yêu cầu phải từ chối.
policy/tools-profile-unapproved	Hồ sơ công cụ toàn cục hoặc theo tác nhân đã cấu hình nằm ngoài danh sách cho phép.
policy/tools-fs-workspace-only-required	Các công cụ hệ thống tệp chưa được cấu hình với trạng thái đường dẫn chỉ dành cho không gian làm việc.
policy/tools-exec-security-unapproved	Chế độ bảo mật thực thi nằm ngoài danh sách cho phép của chính sách.
policy/tools-exec-ask-unapproved	Chế độ hỏi khi thực thi nằm ngoài danh sách cho phép của chính sách.
policy/tools-exec-host-unapproved	Định tuyến máy chủ thực thi nằm ngoài danh sách cho phép của chính sách.
policy/tools-elevated-enabled	Chế độ công cụ nâng cao được bật trong khi chính sách từ chối chế độ này.
policy/tools-also-allow-missing	Danh sách alsoAllow đã cấu hình thiếu một mục mà chính sách yêu cầu.
policy/tools-also-allow-unexpected	Danh sách alsoAllow đã cấu hình chứa một mục mà chính sách không mong đợi.
policy/tools-required-deny-missing	Danh sách từ chối công cụ toàn cục hoặc theo tác nhân không chứa một công cụ bắt buộc phải từ chối.
policy/sandbox-mode-unapproved	Chế độ sandbox nằm ngoài danh sách cho phép của chính sách.
policy/sandbox-backend-unapproved	Phần phụ trợ sandbox nằm ngoài danh sách cho phép của chính sách.
policy/sandbox-container-posture-unobservable	Một quy tắc trạng thái vùng chứa được bật cho phần phụ trợ không thể quan sát quy tắc đó.
policy/sandbox-container-host-network-denied	Sandbox hoặc trình duyệt dựa trên vùng chứa sử dụng chế độ mạng máy chủ.
policy/sandbox-container-namespace-join-denied	Sandbox hoặc trình duyệt dựa trên vùng chứa tham gia không gian tên của vùng chứa khác.
policy/sandbox-container-mount-mode-required	Một điểm gắn kết của sandbox hoặc trình duyệt dựa trên vùng chứa không ở chế độ chỉ đọc.
policy/sandbox-container-runtime-socket-mount	Một điểm gắn kết của sandbox hoặc trình duyệt dựa trên vùng chứa làm lộ socket thời gian chạy vùng chứa.
policy/sandbox-container-unconfined-profile	Hồ sơ sandbox vùng chứa không bị giới hạn trong khi chính sách từ chối điều đó.
policy/sandbox-browser-cdp-source-range-missing	Thiếu dải nguồn CDP của trình duyệt sandbox trong khi chính sách yêu cầu một dải.
policy/data-handling-redaction-disabled	Tính năng che thông tin nhạy cảm trong nhật ký bị vô hiệu hóa trong khi chính sách yêu cầu.
policy/data-handling-telemetry-content-capture	Tính năng thu thập nội dung đo từ xa được bật trong khi chính sách từ chối điều đó.
policy/data-handling-session-retention-not-enforced	Việc bảo trì thời gian lưu giữ phiên không được thực thi trong khi chính sách yêu cầu.
policy/data-handling-session-transcript-memory-enabled	Tính năng lập chỉ mục bộ nhớ bản chép lời phiên được bật trong khi chính sách từ chối điều đó.
policy/secrets-unmanaged-provider	Một SecretRef trong cấu hình tham chiếu đến nhà cung cấp không được khai báo trong secrets.providers.
policy/secrets-denied-provider-source	Một nhà cung cấp bí mật hoặc SecretRef trong cấu hình sử dụng nguồn bị chính sách từ chối.
policy/secrets-insecure-provider	Một nhà cung cấp bí mật chọn sử dụng trạng thái không an toàn trong khi chính sách từ chối điều đó.
policy/auth-profile-invalid-metadata	Một hồ sơ xác thực trong cấu hình thiếu siêu dữ liệu hợp lệ về nhà cung cấp hoặc chế độ.
policy/auth-profile-unapproved-mode	Chế độ hồ sơ xác thực trong cấu hình nằm ngoài danh sách cho phép của chính sách.
policy/exec-approvals-missing	Chính sách yêu cầu exec-approvals.json, nhưng thiếu hiện vật này.
policy/exec-approvals-invalid	Không thể phân tích cú pháp hiện vật phê duyệt thực thi đã cấu hình.
policy/exec-approvals-default-security-unapproved	Giá trị phê duyệt thực thi mặc định sử dụng chế độ bảo mật nằm ngoài danh sách cho phép của chính sách.
policy/exec-approvals-agent-security-unapproved	Chế độ bảo mật phê duyệt thực thi có hiệu lực theo tác nhân nằm ngoài danh sách cho phép.
policy/exec-approvals-auto-allow-skills-enabled	Một tác nhân phê duyệt thực thi ngầm tự động cho phép các CLI của skill trong khi chính sách từ chối điều đó.
policy/exec-approvals-allowlist-missing	Danh sách phê duyệt cho phép thiếu một mẫu mà chính sách yêu cầu.
policy/exec-approvals-allowlist-unexpected	Danh sách phê duyệt cho phép chứa một mẫu mà chính sách không mong đợi.
policy/tools-missing-risk-level	Một khai báo công cụ được quản trị thiếu siêu dữ liệu rủi ro.
policy/tools-unknown-risk-level	Một khai báo công cụ được quản trị sử dụng giá trị rủi ro không xác định.
policy/tools-missing-sensitivity-token	Một khai báo công cụ được quản trị thiếu siêu dữ liệu về độ nhạy cảm.
policy/tools-missing-owner	Một khai báo công cụ được quản trị thiếu siêu dữ liệu chủ sở hữu.
policy/tools-unknown-sensitivity-token	Một khai báo công cụ được quản trị sử dụng giá trị độ nhạy cảm không xác định.

Một phát hiện có thể bao gồm cả target (đối tượng quan sát được trong không gian làm việc không tuân thủ) và requirement (quy tắc đã khai báo khiến 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": "Kênh 'telegram' sử dụng nhà cung cấp bị từ chối 'telegram'.",
  "source": "policy",
  "path": "cấu hình openclaw",
  "ocPath": "oc://openclaw.config/channels/telegram",
  "target": "oc://openclaw.config/channels/telegram",
  "requirement": "oc://policy.jsonc/channels/denyRules/#0",
  "fixHint": "Telegram không được phê duyệt cho không gian làm việc này."
}

{
  "checkId": "policy/tools-missing-risk-level",
  "severity": "error",
  "message": "Công cụ 'deploy' trong TOOLS.md không có phân loại rủi ro rõ ràng.",
  "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 có 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": "Cài đặt 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": "Cài đặt liên kết Gateway 'gateway-bind' cho phép phơi bày trên địa chỉ không phải 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": "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": "openclaw config",
  "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": "Chính sách không cho phép workspaceAccess 'rw' của sandbox agents.defaults.",
  "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"
}

​

Sửa chữa

doctor --lint và policy check chỉ có quyền đọc.

doctor --fix chỉ chỉnh sửa các cài đặt 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 bước kiểm tra sẽ báo cáo nội dung mà chúng sẽ sửa chữa và giữ nguyên các cài đặt.

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 sửa chữa thu hẹp tự động được liệt kê dưới đây. Chỉ bật workspaceRepairs sau khi tệp chính sách đã được xem xét, 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 id công cụ bắt buộc 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 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 cài đặt 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ó chức năng phát hiện. 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 nhật ký hoặc dữ liệu đo từ xa dùng chung, vì việc thay đổi cài đặt 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ộ của tác tử 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 được 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 cho phép URL đ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 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ị bỏ qua. Chức năng này 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

Lệnh	0	1	2
policy check	Không có phát hiện nào đạt ngưỡng.	Một hoặc nhiều phát hiện đã đạt ngưỡng.	Lỗi đối số hoặc lỗi thời gian chạy.
policy compare	Tệp chính sách ít nhất nghiêm ngặt ngang với đường cơ sở.	Tệp chính sách không hợp lệ, bị thiếu hoặc yếu hơn các quy tắc đường cơ sở.	Lỗi đối số hoặc lỗi thời gian chạy.
policy watch	Không có phát hiện và hàm băm được chấp nhận là hiện hành.	Có phát hiện hoặc chứng thực được chấp nhận đã lỗi thời.	Lỗi đối số hoặc lỗi thời gian chạy.

​

Liên quan

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