> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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ợ:

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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": "+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"],
  },
}
```

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.

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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.

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`):

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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`.

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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`:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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."
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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"
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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"
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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"
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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"
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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"
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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."
}
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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.

```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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](/vi/cli/doctor#lint-mode)
* [CLI đường dẫn](/vi/cli/path)