openclaw policy

openclaw policy มาจาก Policy Plugin ที่รวมมาให้ โดยเป็นชั้นการตรวจสอบความสอดคล้องระดับองค์กรบนการตั้งค่า OpenClaw ที่มีอยู่ ไม่ใช่ระบบกำหนดค่าอีกระบบหนึ่ง คุณกำหนดข้อกำหนดใน policy.jsonc; OpenClaw สังเกตเวิร์กสเปซที่ใช้งานอยู่เพื่อใช้เป็นหลักฐาน; นโยบายรายงานความคลาดเคลื่อนผ่าน doctor --lint นโยบายไม่ได้บังคับใช้การเรียกเครื่องมือหรือเขียนพฤติกรรมรันไทม์ใหม่ขณะประมวลผลคำขอ และไม่ได้รับรองที่เก็บข้อมูลประจำตัวแยกตามเอเจนต์ เช่น auth-profiles.json

นโยบายตรวจสอบช่องทางที่กำหนดค่าไว้, เซิร์ฟเวอร์ MCP, ผู้ให้บริการโมเดล, สถานะการป้องกัน SSRF ของเครือข่าย, การเข้าถึงขาเข้า/ช่องทาง, การเปิดเผย Gateway และสถานะคำสั่งของ Node, การเข้าถึงเวิร์กสเปซของเอเจนต์, สถานะแซนด์บ็อกซ์, สถานะการจัดการข้อมูล, สถานะผู้ให้บริการข้อมูลลับ/โปรไฟล์การยืนยันตัวตน และข้อมูลเมตาของเครื่องมือที่อยู่ภายใต้การกำกับดูแล (TOOLS.md) ใช้เมื่อเวิร์กสเปซต้องมีข้อกำหนดที่คงทนและตรวจสอบได้ เช่น "ต้องไม่เปิดใช้งาน Telegram" หรือ "เครื่องมือที่อยู่ภายใต้การกำกับดูแลต้องประกาศข้อมูลเมตาด้านความเสี่ยงและเจ้าของ" หากคุณต้องการเพียงพฤติกรรมภายในเครื่องโดยไม่มีการรับรองหรือการตรวจจับความคลาดเคลื่อน การกำหนดค่าปกติก็เพียงพอ

เริ่มต้นอย่างรวดเร็ว

openclaw plugins enable policy

Plugin จะยังคงเปิดใช้งานแม้ไม่มี policy.jsonc เพื่อให้ doctor รายงานอาร์ติแฟกต์ที่ขาดหายไป แทนที่จะข้ามการตรวจสอบโดยไม่แจ้งให้ทราบ

เขียน policy.jsonc ด้วยตนเอง; ไฟล์นี้ไม่ได้สร้างจากการตั้งค่าปัจจุบัน แต่ละส่วนระดับบนสุดเป็นเนมสเปซของกฎ: การตรวจสอบจะทำงานเฉพาะเมื่อมีกฎที่ชัดเจนอยู่ภายใต้ส่วนนั้น (ส่วนหรือคีย์ที่ไม่รองรับจะล้มเหลวด้วย policy/policy-jsonc-invalid แทนที่จะถูกละเว้นโดยไม่แจ้งให้ทราบ) ตัวอย่างขั้นต่ำที่ครอบคลุมทุกส่วนที่รองรับ:

{  "channels": {    "denyRules": [      {        "id": "no-telegram",        "when": { "provider": "telegram" },        "reason": "Telegram is not approved for this workspace.",      },    ],  },  "mcp": {    "servers": {      "allow": ["docs"],      "deny": ["untrusted"],    },  },  "models": {    "providers": {      "allow": ["openai", "anthropic"],      "deny": ["openrouter"],    },  },  "network": {    "privateNetwork": {      "allow": false,    },  },  "ingress": {    "session": {      "requireDmScope": "per-channel-peer",    },    "channels": {      "allowDmPolicies": ["pairing", "allowlist", "disabled"],      "denyOpenGroups": true,      "requireMentionInGroups": true,    },  },  "gateway": {    "exposure": {      "allowNonLoopbackBind": false,      "allowTailscaleFunnel": false,    },    "auth": {      "requireAuth": true,      "requireExplicitRateLimit": true,    },    "controlUi": {      "allowInsecure": false,    },    "remote": {      "allow": false,    },    "http": {      "denyEndpoints": ["chatCompletions", "responses"],      "requireUrlAllowlists": true,    },    "nodes": {      "denyCommands": ["system.run"],    },  },  "agents": {    "workspace": {      "allowedAccess": ["none", "ro"],      "denyTools": ["exec", "process", "write", "edit", "apply_patch"],    },  },  "dataHandling": {    "sensitiveLogging": {      "requireRedaction": true,    },    "telemetry": {      "denyContentCapture": true,    },    "retention": {      "requireSessionMaintenance": true,    },    "memory": {      "denySessionTranscriptIndexing": true,    },  },  "secrets": {    "requireManagedProviders": true,    "denySources": ["exec"],    "allowInsecureProviders": false,  },  "auth": {    "profiles": {      "requireMetadata": ["provider", "mode"],      "allowModes": ["api_key", "token"],    },  },  "execApprovals": {    "requireFile": true,    "defaults": { "allowSecurity": ["deny"] },    "agents": {      "allowSecurity": ["deny", "allowlist"],      "allowAutoAllowSkills": false,      "allowlist": { "expected": ["deploy", "status"] },    },  },  "tools": {    "requireMetadata": ["risk", "sensitivity", "owner"],    "profiles": {      "allow": ["messaging", "minimal"],    },    "fs": {      "requireWorkspaceOnly": true,    },    "exec": {      "allowSecurity": ["deny", "allowlist"],      "requireAsk": ["always"],      "allowHosts": ["sandbox"],    },    "elevated": {      "allow": false,    },    "denyTools": ["group:runtime", "group:fs"],  },}

หมายเหตุที่ครอบคลุมหลายส่วนและอาจไม่ชัดเจนจากตารางกฎด้านล่าง:

• การละ gateway.bind ไว้ขณะปฏิเสธการผูกกับที่อยู่นอก local loopback หมายความว่าคุณยอมรับค่าเริ่มต้นของรันไทม์; กำหนด gateway.bind: "loopback" เพื่อให้สอดคล้องอย่างเคร่งครัด
• สำหรับเอเจนต์แบบอ่านอย่างเดียว ให้ตั้งค่า mode ของแซนด์บ็อกซ์เป็น all หรือ non-main ในค่าเริ่มต้น/เอเจนต์ที่เกี่ยวข้อง และตั้งค่า workspaceAccess เป็น none หรือ ro โหมดแซนด์บ็อกซ์ที่ขาดหายไปหรือเป็น off ไม่เป็นไปตามนโยบายแบบอ่านอย่างเดียว
• agents.workspace.denyTools รองรับ exec, process, write, edit, apply_patch กลุ่มปฏิเสธเครื่องมือในการกำหนดค่า group:fs (การแก้ไขไฟล์) และ group:runtime (เชลล์/กระบวนการ) เป็นไปตามสถานะที่เทียบเท่ากัน
• การตรวจสอบการอนุมัติการดำเนินการจะอ่านอาร์ติแฟกต์ exec-approvals.json ที่ใช้งานอยู่เฉพาะเมื่อมีกฎ execApprovals; อาร์ติแฟกต์ที่ขาดหายไปหรือไม่ถูกต้องคือหลักฐานที่สังเกตไม่ได้ ไม่ใช่ผลผ่านที่สร้างขึ้น
• หลักฐานของข้อมูลลับและโปรไฟล์การยืนยันตัวตนจะบันทึกเฉพาะสถานะผู้ให้บริการ/แหล่งที่มาและข้อมูลเมตา SecretRef เท่านั้น โดยจะไม่บันทึกค่าดิบ นโยบายไม่อ่านหรือรับรองที่เก็บข้อมูลประจำตัวแยกตามเอเจนต์ เช่น auth-profiles.json
• หลักฐานการจัดการข้อมูลเป็นเพียงสถานะระดับการกำหนดค่า (โหมดการปกปิดข้อมูล, สวิตช์การบันทึกข้อมูลเทเลเมทรี, โหมดการบำรุงรักษาเซสชัน, การตั้งค่าการทำดัชนีบทถอดความ) โดยไม่ตรวจสอบบันทึก, ข้อมูลส่งออกเทเลเมทรี, บทถอดความ หรือไฟล์หน่วยความจำ และผลลัพธ์ที่ไม่พบปัญหาไม่ได้พิสูจน์ว่าไม่มีข้อมูลส่วนบุคคลหรือข้อมูลลับอยู่ในสิ่งเหล่านั้น

ข้อมูลอ้างอิงกฎนโยบาย

กฎทุกข้อด้านล่างเป็นทางเลือก; การตรวจสอบจะทำงานเฉพาะเมื่อมีกฎนั้น สถานะที่สังเกตได้คือการกำหนดค่า OpenClaw หรือข้อมูลเมตาของเวิร์กสเปซที่มีอยู่

การซ้อนทับแบบกำหนดขอบเขต

ใช้ scopes.<scopeName> เมื่อเอเจนต์หรือช่องทางบางรายการต้องใช้นโยบายที่เข้มงวดกว่าค่าพื้นฐานระดับบนสุด ชื่อขอบเขตเป็นเพียงป้ายกำกับ; การจับคู่ใช้ตัวเลือกภายในขอบเขต การซ้อนทับเป็นแบบเพิ่มเข้าไป: กฎส่วนกลางยังคงทำงาน และกฎที่กำหนดขอบเขตสามารถเพิ่มข้อค้นพบของตนเองกับหลักฐานเดียวกันได้

หากรายการ agentIds ไม่มีอยู่ใน agents.list[] OpenClaw จะประเมินกฎที่กำหนดขอบเขตกับสถานะส่วนกลาง/ค่าเริ่มต้นที่สืบทอดมาสำหรับรหัสเอเจนต์รันไทม์นั้น แทนที่จะข้ามไป

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

เอเจนต์เดียวกันสามารถปรากฏในหลายขอบเขตได้ หากแต่ละขอบเขตกำกับดูแลคนละฟิลด์ดังตัวอย่างข้างต้น ฟิลด์ที่กำหนดขอบเขตซ้ำสำหรับเอเจนต์เดียวกันต้องเข้มงวดเท่ากันหรือมากกว่า; การอ้างข้อกำหนดซ้ำที่อ่อนกว่าจะถูกปฏิเสธ (รายการอนุญาตต้องเป็นเซตย่อย, รายการปฏิเสธต้องเป็นเซตครอบคลุม และค่าบูลีนที่บังคับต้องคงที่)

กฎสถานะคอนเทนเนอร์ (sandbox.containers.*) จะตรวจสอบกับหลักฐานที่แบ็กเอนด์แซนด์บ็อกซ์ของเอเจนต์ที่ตรงกันสามารถเปิดเผยได้เท่านั้น หากแบ็กเอนด์ไม่สามารถสังเกตกฎที่คุณเปิดใช้งานสำหรับแบ็กเอนด์นั้น นโยบายจะรายงาน policy/sandbox-container-posture-unobservable แทนการให้ผลผ่าน; ให้กำหนดขอบเขตกฎคอนเทนเนอร์เฉพาะกับกลุ่มเอเจนต์ที่ใช้แบ็กเอนด์ซึ่งสามารถเปิดเผยหลักฐานดังกล่าวได้

ingress.session.requireDmScope ระดับบนสุดยังคงเป็นแบบส่วนกลาง; session.dmScope ไม่ใช่หลักฐานที่ระบุที่มาของช่องทางได้ จึงไม่สามารถกำหนดขอบเขตด้วย channelIds

ทุกขอบเขตที่อยู่ใน policy.jsonc ต้องถูกต้องและสามารถบังคับใช้ได้

ช่องทาง

เซิร์ฟเวอร์ MCP

ผู้ให้บริการโมเดล

เครือข่าย

การเข้าถึงขาเข้าและช่องทาง

Gateway

gateway.nodes.denyCommands เป็นกฎชุดครอบคลุมการปฏิเสธที่ต้องตรงกันทุกประการและคำนึงถึงตัวพิมพ์เล็ก-ใหญ่ ใช้เมื่อจำเป็นต้องพิสูจน์ด้วยนโยบายว่าคำสั่ง Node ที่มีสิทธิ์สูงถูกปฏิเสธ อย่างชัดเจนโดยการกำหนดค่า OpenClaw การติดตั้งใช้งานที่ตั้งใจอนุญาตคำสั่ง Node ที่มีสิทธิ์สูงควรอัปเดต policy.jsonc หลังการตรวจสอบ แทนที่จะพึ่งพา gateway.nodes.allowCommands เพียงอย่างเดียว

พื้นที่ทำงานของเอเจนต์

รูปแบบความปลอดภัยของแซนด์บ็อกซ์

นโยบายถือว่า sandbox.mode ที่ขาดหายไปใช้ค่าเริ่มต้นโดยนัยเป็น off ดังนั้น sandbox.requireMode จะรายงานว่าแซนด์บ็อกซ์ใหม่หรือยังไม่ได้กำหนดค่าอยู่นอก รายการอนุญาต เช่น ["all"]

การจัดการข้อมูล

ข้อมูลลับ

การอนุมัติ Exec

การตรวจสอบการอนุมัติ Exec จะอ่านอาร์ติแฟกต์รันไทม์ exec-approvals.json: โดยค่าเริ่มต้นคือ ~/.openclaw/exec-approvals.json หรือ $OPENCLAW_STATE_DIR/exec-approvals.json เมื่อตั้งค่า OPENCLAW_STATE_DIR กฎรูปแบบภายใต้ execApprovals.defaults.* หรือ execApprovals.agents.* กำหนดให้มีหลักฐานอาร์ติแฟกต์ที่อ่านได้ อาร์ติแฟกต์ที่ขาดหายไปหรือไม่ถูกต้องจะถูกรายงานเป็น หลักฐานที่ไม่สามารถสังเกตได้ แทนที่จะถือว่าผ่านโดยพยายามเท่าที่ทำได้ เมื่ออ่านได้แล้ว ฟิลด์ที่ละไว้ จะสืบทอดค่าเริ่มต้นของรันไทม์: defaults.security ที่ขาดหายไปจะเป็น full และ การตั้งค่าความปลอดภัยของเอเจนต์ที่ขาดหายไปจะสืบทอดค่าเริ่มต้นนั้น หลักฐานประกอบด้วย defaults, agents.*, agents.*.allowlist[].pattern, argPattern ที่เป็นตัวเลือก, รูปแบบ autoAllowSkills ที่มีผล และแหล่งที่มาของรายการ โดยจะไม่รวมพาธ/โทเค็นซ็อกเก็ต, commandText, lastUsedCommand, พาธที่แก้ไขแล้ว หรือการประทับเวลา

ตัวอย่าง: กำหนดให้มีอาร์ติแฟกต์การอนุมัติ ปฏิเสธค่าเริ่มต้นที่ผ่อนปรน และอนุญาต เฉพาะรูปแบบการอนุมัติ Exec ที่ผ่านการตรวจสอบแล้วสำหรับเอเจนต์ที่เลือก

{  "execApprovals": {    "requireFile": true,    "defaults": {      // โหมดความปลอดภัย: "deny", "allowlist" หรือ "full"      // ค่าเริ่มต้นนี้อนุญาตเฉพาะสถานะปฏิเสธที่จำกัดอย่างเข้มงวด      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // เอเจนต์ที่เลือกอาจใช้สถานะรายการที่อนุญาตซึ่งผ่านการตรวจสอบแล้ว แต่ห้ามใช้ "full"          "allowSecurity": ["allowlist"],          // false หมายความว่า CLI ของ Skills ต้องปรากฏในรายการที่อนุญาตซึ่งผ่านการตรวจสอบแล้ว แทนที่จะ          // ได้รับอนุมัติโดยปริยายผ่าน autoAllowSkills          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // รายการแบบง่าย: รูปแบบไฟล์ปฏิบัติการที่ผ่านการตรวจสอบและตรงกันทุกประการ โดยไม่มี argPattern              "travel-hub",              // รายการแบบมีข้อจำกัด: รูปแบบพร้อมนิพจน์ทั่วไปของอาร์กิวเมนต์ที่ผ่านการตรวจสอบแล้ว              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

โปรไฟล์การยืนยันตัวตน

ข้อมูลเมตาของเครื่องมือ

สถานะการควบคุมเครื่องมือ

เรียกใช้การตรวจสอบ

เรียกใช้เฉพาะการตรวจสอบนโยบายระหว่างการจัดทำ:

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

policy check เรียกใช้เฉพาะชุดการตรวจสอบนโยบาย และส่งออกหลักฐาน ข้อค้นพบ และแฮชการรับรอง ข้อค้นพบเดียวกันจะปรากฏใน openclaw doctor --lint ด้วยเมื่อเปิดใช้งาน Plugin นโยบาย

เปรียบเทียบไฟล์นโยบายของผู้ดำเนินการกับค่าพื้นฐานที่จัดทำไว้:

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

policy compare ตรวจสอบไวยากรณ์ของไฟล์นโยบายเทียบกับไวยากรณ์ของไฟล์นโยบาย โดย ไม่ตรวจสอบสถานะรันไทม์ หลักฐาน ข้อมูลประจำตัว หรือข้อมูลลับ เครื่องมือนี้ใช้ ข้อมูลเมตาของกฎชุดเดียวกับที่ควบคุมโอเวอร์เลย์ตามขอบเขต: รายการที่อนุญาตต้องคงความเท่ากันหรือ แคบลง รายการปฏิเสธต้องคงความเท่ากันหรือกว้างขึ้น ค่าบูลีนที่บังคับต้องคง ค่าเดิม สตริงที่มีลำดับจะเลื่อนได้เฉพาะไปยังด้านที่เข้มงวดกว่าของ ลำดับที่กำหนดค่าไว้ และรายการแบบตรงกันทุกประการต้องตรงกัน ค่าพื้นฐานอาจเป็น นโยบายที่องค์กรจัดทำขึ้น ส่วนนโยบายที่ตรวจสอบอาจเพิ่มค่าที่เข้มงวดขึ้นหรือ กฎเพิ่มเติมได้ กฎระดับบนสุดที่ตรวจสอบสามารถทำให้กฎพื้นฐานตามขอบเขตเป็นไปตามข้อกำหนดได้ เมื่อ กฎนั้นเข้มงวดเท่ากันหรือมากกว่า ชื่อขอบเขตไม่จำเป็นต้องตรงกันระหว่าง ไฟล์ การเปรียบเทียบใช้ตัวเลือก (agentIds/channelIds) และฟิลด์เป็นคีย์

ผลการเปรียบเทียบที่ไม่มีปัญหา (--json):

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

ผลลัพธ์ policy check --json ที่ไม่มีปัญหาจะมีแฮชคงที่ซึ่งผู้ดำเนินการหรือ ผู้ควบคุมสามารถบันทึกได้:

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

กำหนดค่านโยบาย

การกำหนดค่านโยบายอยู่ภายใต้ plugins.entries.policy.config

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

ตั้งค่า plugins.entries.policy.config.enabled เป็น false เพื่อปิดใช้งานการตรวจสอบ นโยบายสำหรับพื้นที่ทำงาน โดยยังคงติดตั้ง Plugin ไว้

ยอมรับสถานะนโยบาย

ตัวอย่างผลลัพธ์ 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 ระบุอาร์ติแฟกต์กฎที่จัดทำขึ้น evidence บันทึกสถานะ OpenClaw ที่ตรวจพบซึ่งการตรวจสอบใช้ และ workspace.hash ระบุเพย์โหลดหลักฐานนั้น findingsHash ระบุ ชุดข้อค้นพบที่ตรงกันทุกประการ checkedAt บันทึกเวลาที่เรียกใช้การตรวจสอบ attestationHash ระบุคำรับรองแบบคงที่ (แฮชนโยบาย แฮชหลักฐาน แฮชข้อค้นพบ และสถานะไม่มีปัญหา/มีปัญหา) และจงใจไม่รวม checkedAt ดังนั้นสถานะนโยบายเดียวกันจึงสร้างแฮชการรับรองเดียวกันเสมอ เมื่อใช้ร่วมกัน ค่าทั้งสี่นี้จะประกอบเป็นทูเพิลการตรวจสอบสำหรับการตรวจสอบนโยบายหนึ่งครั้ง

หาก Gateway หรือผู้ควบคุมใช้นโยบายเพื่อบล็อก อนุมัติ หรือใส่คำอธิบายประกอบให้กับ การดำเนินการรันไทม์ ระบบควรบันทึกแฮชการรับรองจากการตรวจสอบที่ไม่มีปัญหาครั้งล่าสุด checkedAt ยังคงอยู่ในผลลัพธ์ JSON สำหรับบันทึกการตรวจสอบ แต่ไม่เป็นส่วนหนึ่งของ แฮชคงที่

วงจรการยอมรับสถานะนโยบาย:

1. จัดทำหรือตรวจทาน policy.jsonc
2. เรียกใช้ openclaw policy check --json
3. หากไม่มีปัญหา ให้บันทึก attestation.policy.hash เป็น expectedHash
4. บันทึก attestation.attestationHash เป็น expectedAttestationHash
5. เรียกใช้ openclaw doctor --lint อีกครั้งใน CI หรือเกตการเผยแพร่

หากมีการเปลี่ยนแปลงกฎนโยบายโดยตั้งใจ ให้อัปเดตแฮชที่ยอมรับทั้งสองค่าจากการตรวจสอบที่สะอาด หากเปลี่ยนเฉพาะการตั้งค่าเวิร์กสเปซ (นโยบายยังคงเดิม) โดยทั่วไปจะเปลี่ยนเฉพาะ expectedAttestationHash

การเปิดใช้หรืออัปเกรดกฎ agents.workspace จะเพิ่มหลักฐาน agentWorkspace ลงในแฮชเวิร์กสเปซและแฮชการรับรอง ให้ตรวจสอบหลักฐานใหม่และรีเฟรชแฮชการรับรองที่ยอมรับหลังจากเปิดใช้ การเปิดใช้หรืออัปเกรดกฎสถานะเครื่องมือจะเพิ่มหลักฐาน toolPosture ในลักษณะเดียวกัน

openclaw policy watch จะเรียกใช้การตรวจสอบซ้ำและรายงานเมื่อหลักฐานปัจจุบันไม่ตรงกับ expectedAttestationHash อีกต่อไป:

openclaw policy watch --json

ใช้ --once ใน CI หรือสคริปต์ที่ต้องการประเมินความคลาดเคลื่อนเพียงครั้งเดียว หากไม่มี --once ระบบจะสำรวจทุกสองวินาทีโดยค่าเริ่มต้น ใช้ --interval-ms เพื่อเปลี่ยนช่วงเวลา

ข้อค้นพบ

ข้อค้นพบหนึ่งรายการสามารถมีทั้ง target (สิ่งที่สังเกตพบในเวิร์กสเปซซึ่งไม่เป็นไปตามข้อกำหนด) และ requirement (กฎที่เขียนไว้ซึ่งทำให้เกิดข้อค้นพบนั้น) ปัจจุบันทั้งสองเป็นสตริงที่อยู่ oc:// แต่ชื่อฟิลด์อธิบายบทบาทในนโยบาย ไม่ใช่รูปแบบที่อยู่

ตัวอย่างข้อค้นพบ:

{  "checkId": "policy/channels-denied-provider",  "severity": "error",  "message": "Channel 'telegram' uses denied provider 'telegram'.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/channels/telegram",  "target": "oc://openclaw.config/channels/telegram",  "requirement": "oc://policy.jsonc/channels/denyRules/#0",  "fixHint": "Telegram is not approved for this workspace."}

{  "checkId": "policy/tools-missing-risk-level",  "severity": "error",  "message": "TOOLS.md tool 'deploy' has no explicit risk classification.",  "source": "policy",  "path": "TOOLS.md",  "line": 12,  "ocPath": "oc://TOOLS.md/tools/deploy",  "target": "oc://TOOLS.md/tools/deploy",  "requirement": "oc://policy.jsonc/tools/requireMetadata"}

{  "checkId": "policy/mcp-unapproved-server",  "severity": "error",  "message": "MCP server 'remote' is not in the policy allowlist.",  "source": "policy",  "path": "openclaw config",  "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": "Model ref 'anthropic/claude-sonnet-4.7' uses unapproved provider 'anthropic'.",  "source": "policy",  "path": "openclaw config",  "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": "Network setting 'browser-private-network' allows private-network access.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",  "target": "oc://openclaw.config/browser/ssrfPolicy/dangerouslyAllowPrivateNetwork",  "requirement": "oc://policy.jsonc/network/privateNetwork/allow"}

{  "checkId": "policy/gateway-non-loopback-bind",  "severity": "error",  "message": "Gateway bind setting 'gateway-bind' permits non-loopback exposure.",  "source": "policy",  "path": "openclaw config",  "ocPath": "oc://openclaw.config/gateway/bind",  "target": "oc://openclaw.config/gateway/bind",  "requirement": "oc://policy.jsonc/gateway/exposure/allowNonLoopbackBind"}

{  "checkId": "policy/gateway-node-command-denied",  "severity": "error",  "message": "Gateway node command 'system.run' is denied by policy but not denied by OpenClaw config.",  "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": "Add 'system.run' to gateway.nodes.denyCommands or update policy after review."}

{  "checkId": "policy/agents-workspace-access-denied",  "severity": "error",  "message": "agents.defaults sandbox workspaceAccess 'rw' is not allowed by policy.",  "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"}

การซ่อมแซม

doctor --lint และ policy check เป็นแบบอ่านอย่างเดียว

doctor --fix จะแก้ไขการตั้งค่าพื้นที่ทำงานที่นโยบายจัดการเฉพาะเมื่อเปิดใช้ workspaceRepairs อย่างชัดเจนเท่านั้น มิฉะนั้น การตรวจสอบจะรายงานสิ่งที่ระบบ จะซ่อมแซมและคงการตั้งค่าไว้โดยไม่เปลี่ยนแปลง

ในเวอร์ชันนี้ การซ่อมแซมสามารถปิดใช้งานช่องทางที่ channels.denyRules ปฏิเสธ และใช้การซ่อมแซมแบบจำกัดขอบเขตโดยอัตโนมัติตามรายการด้านล่าง เปิดใช้ workspaceRepairs หลังจากตรวจสอบไฟล์นโยบายแล้วเท่านั้น เนื่องจากกฎที่ถูกต้อง อาจเปลี่ยนแปลงการกำหนดค่าพื้นที่ทำงานได้:

• ตั้งค่า tools.elevated.enabled=false เมื่อนโยบายส่วนกลางห้ามใช้เครื่องมือที่มีสิทธิ์ระดับสูง
• เพิ่มรหัสเครื่องมือที่ต้องปฏิเสธแต่ยังขาดอยู่ลงใน tools.deny หรือ agents.list[].tools.deny เมื่อนโยบายกำหนดให้ปฏิเสธเครื่องมือเหล่านั้น
• ตั้งค่าตัวเลือก gateway.controlUi.* ที่ไม่ปลอดภัยเป็น false
• ตั้งค่า gateway.mode=local เมื่อนโยบายปฏิเสธโหมด Gateway ระยะไกล
• ตั้งค่าพาธ gateway.http.endpoints.*.enabled ที่รายงานเป็น false เมื่อนโยบาย ปฏิเสธปลายทาง HTTP API ของ Gateway
• ตั้งค่าพาธ groupPolicy สำหรับการรับข้อมูลเข้าของช่องทางที่รายงานเป็น allowlist เมื่อนโยบาย ปฏิเสธการรับข้อมูลเข้าจากกลุ่มแบบเปิด
• ตั้งค่าพาธ requireMention สำหรับการรับข้อมูลเข้าของช่องทางที่รายงานเป็น true เมื่อนโยบาย กำหนดให้ต้องกล่าวถึงในกลุ่ม
• ตั้งค่า logging.redactSensitive=tools เมื่อนโยบายกำหนดให้ปกปิดข้อมูลสำคัญ ในบันทึก
• ตั้งค่า diagnostics.otel.captureContent=false หรือ diagnostics.otel.captureContent.enabled=false สำหรับการตั้งค่าการเก็บข้อมูลเทเลเมทรี ในรูปแบบออบเจ็กต์ เมื่อนโยบายปฏิเสธการเก็บเนื้อหาเทเลเมทรี

การซ่อมแซมเครื่องมือที่มีสิทธิ์ระดับสูงแบบจำกัดขอบเขตเป็นการตรวจหาเท่านั้น นอกจากนี้ ระบบจะข้ามการซ่อมแซมการจัดการข้อมูลแบบจำกัดขอบเขตเมื่อผลการตรวจพบรายงานการกำหนดค่า บันทึกหรือเทเลเมทรีที่ใช้ร่วมกัน เนื่องจากการเปลี่ยนการตั้งค่าที่ใช้ร่วมกันจะส่งผล เกินกว่าเป้าหมายนโยบายแบบจำกัดขอบเขต

ระบบจะข้ามการซ่อมแซมข้อกำหนดให้ปฏิเสธแบบจำกัดขอบเขตเมื่อผลการตรวจพบรายงาน tools.deny ระดับรากที่สืบทอดมา เนื่องจากการเพิ่มเครื่องมือที่กำหนดลงในการกำหนดค่า ระดับรากจะส่งผลเกินกว่าเป้าหมายนโยบายแบบจำกัดขอบเขต การซ่อมแซมข้อกำหนดให้ปฏิเสธ เฉพาะเอเจนต์สามารถอัปเดตพาธ agents.list[].tools.deny ที่รายงานได้

ระบบจะข้ามการซ่อมแซมการรับข้อมูลเข้าของช่องทางแบบจำกัดขอบเขตเมื่อผลการตรวจพบรายงาน channels.defaults.* ที่สืบทอดมา เนื่องจากการเปลี่ยนค่าเริ่มต้นของช่องทางที่ใช้ร่วมกัน จะส่งผลเกินกว่าเป้าหมายนโยบายแบบจำกัดขอบเขต ผลการตรวจพบรายการอนุญาตสำหรับการดึง URL ผ่าน HTTP ของ Gateway ยังคงต้องดำเนินการด้วยตนเอง เนื่องจากการซ่อมแซมอัตโนมัติ ไม่สามารถเลือกค่า URL ของปลายทางที่ถูกต้องสำหรับรายการอนุญาตได้

ผลการตรวจพบการผูก Gateway และคำสั่ง Node ยังคงต้องผ่านการตรวจสอบ เมื่อ policy/gateway-non-loopback-bind หรือ policy/gateway-node-command-denied สามารถจับคู่กับพาธการกำหนดค่าได้ doctor --fix จะรายงานการเปลี่ยนแปลง gateway.bind หรือ gateway.nodes.denyCommands ที่เสนอเป็นคำแนะนำตัวอย่าง ที่ข้ามการดำเนินการ ระบบจะไม่ใช้การเปลี่ยนแปลงดังกล่าว และผลการตรวจพบจะยังไม่นับว่า ได้รับการซ่อมแซมจนกว่าผู้ดูแลระบบจะตรวจสอบและอัปเดตการกำหนดค่าหรือนโยบาย

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

รหัสการออก

เนื้อหาที่เกี่ยวข้อง

• โหมด lint ของ Doctor
• CLI สำหรับพาธ