openclaw policy

openclaw policy توسط Plugin همراه Policy ارائه می‌شود. این قابلیت یک لایه انطباق سازمانی روی تنظیمات موجود OpenClaw است، نه یک سامانه پیکربندی دوم. الزامات را در policy.jsonc تعریف می‌کنید؛ OpenClaw فضای کاری فعال را به‌عنوان شواهد مشاهده می‌کند؛ و Policy انحراف را از طریق doctor --lint گزارش می‌دهد. Policy فراخوانی ابزارها را اعمال نمی‌کند، رفتار زمان اجرا را هنگام درخواست بازنویسی نمی‌کند و مخازن اعتبارنامه مختص هر عامل، مانند auth-profiles.json، را گواهی نمی‌کند.

Policy کانال‌های پیکربندی‌شده، سرورهای MCP، ارائه‌دهندگان مدل، وضعیت SSRF شبکه، دسترسی ورودی/کانال، در معرض‌بودن Gateway و وضعیت فرمان‌های Node، دسترسی عامل به فضای کاری، وضعیت محیط ایزوله، وضعیت مدیریت داده، وضعیت ارائه‌دهنده اسرار/نمایه احراز هویت و فراداده ابزارهای تحت حاکمیت (TOOLS.md) را بررسی می‌کند. زمانی از آن استفاده کنید که یک فضای کاری به گزاره‌ای ماندگار و قابل‌بررسی مانند «Telegram نباید فعال باشد» یا «ابزارهای تحت حاکمیت باید فراداده ریسک و مالک را اعلام کنند» نیاز دارد. اگر فقط به رفتار محلی، بدون گواهی یا تشخیص انحراف نیاز دارید، پیکربندی عادی کافی است.

شروع سریع

openclaw plugins enable policy

حتی زمانی که policy.jsonc وجود ندارد، Plugin فعال باقی می‌ماند تا 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، یک Policy فقط‌خواندنی را برآورده نمی‌کند.
• agents.workspace.denyTools مقادیر exec، process، write، edit و apply_patch را می‌پذیرد. گروه‌های منع ابزار در پیکربندی، یعنی group:fs (تغییر فایل) و group:runtime (پوسته/فرایند)، وضعیت معادل را برآورده می‌کنند.
• بررسی‌های تأیید اجرای فرمان تنها زمانی مصنوع زنده exec-approvals.json را می‌خوانند که یک قانون execApprovals وجود داشته باشد؛ مصنوع مفقود یا نامعتبر، شواهد مشاهده‌ناپذیر است، نه یک قبولی مصنوعی.
• شواهد اسرار و نمایه احراز هویت فقط وضعیت ارائه‌دهنده/منبع و فراداده SecretRef را ثبت می‌کنند و هرگز مقادیر خام را ثبت نمی‌کنند. Policy مخازن اعتبارنامه مختص هر عامل، مانند auth-profiles.json، را نمی‌خواند یا گواهی نمی‌کند.
• شواهد مدیریت داده فقط وضعیت سطح پیکربندی را شامل می‌شوند (حالت پوشاندن، کلید تغییر ثبت تله‌متری، حالت نگهداری نشست و تنظیم نمایه‌سازی رونوشت). این شواهد گزارش‌ها، خروجی‌های تله‌متری، رونوشت‌ها یا فایل‌های حافظه را بررسی نمی‌کنند و نتیجه پاک ثابت نمی‌کند که هیچ داده شخصی یا رازی در آن‌ها وجود ندارد.

مرجع قوانین Policy

همه قوانین زیر اختیاری هستند؛ هر بررسی فقط زمانی اجرا می‌شود که قانون وجود داشته باشد. وضعیت مشاهده‌شده، پیکربندی موجود OpenClaw یا فراداده فضای کاری است.

هم‌پوشانی‌های محدوده‌دار

هنگامی که عامل‌ها یا کانال‌های مشخص به Policy سخت‌گیرانه‌تری نسبت به خط‌مبنای سطح‌بالا نیاز دارند، از 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 به‌جای اعلام قبولی، 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-approvals.json را می‌خوانند: به‌طور پیش‌فرض ~/.openclaw/exec-approvals.json، یا هنگامی که OPENCLAW_STATE_DIR تنظیم شده است، $OPENCLAW_STATE_DIR/exec-approvals.json. قواعد وضعیت زیر execApprovals.defaults.* یا execApprovals.agents.* به شواهد مصنوع خواندنی نیاز دارند؛ مصنوع مفقود یا نامعتبر به‌جای قبولی بر پایه بهترین تلاش، به‌عنوان شواهد مشاهده‌ناپذیر گزارش می‌شود. پس از خواندنی شدن، فیلدهای حذف‌شده مقادیر پیش‌فرض زمان اجرا را به ارث می‌برند: نبود defaults.security برابر full است و نبود امنیت عامل نیز آن مقدار پیش‌فرض را به ارث می‌برد. شواهد شامل defaults، agents.*، agents.*.allowlist[].pattern، argPattern اختیاری، وضعیت مؤثر autoAllowSkills و منبع ورودی است — و هرگز شامل مسیر سوکت/توکن، commandText، lastUsedCommand، مسیرهای حل‌شده یا برچسب‌های زمانی نیست.

مثال: مصنوع تأییدها را الزامی کنید، پیش‌فرض‌های سهل‌گیرانه را رد کنید و فقط وضعیت تأیید اجرای بازبینی‌شده را برای عامل‌های منتخب مجاز کنید.

{  "execApprovals": {    "requireFile": true,    "defaults": {      // Security modes: "deny", "allowlist", or "full".      // This default permits only the locked-down deny posture.      "allowSecurity": ["deny"],    },  },  "scopes": {    "restricted-shell": {      "agentIds": ["family-agent", "groups-agent"],      "execApprovals": {        "agents": {          // Selected agents may use reviewed allowlist posture, but not "full".          "allowSecurity": ["allowlist"],          // false means skill CLIs must appear in the reviewed allowlist instead of          // being implicitly approved by autoAllowSkills.          "allowAutoAllowSkills": false,          "allowlist": {            "expected": [              // Simple entry: exact reviewed executable pattern with no argPattern.              "travel-hub",              // Constrained entry: pattern plus reviewed argument regex.              { "pattern": "calendar-cli", "argPattern": "^sync\\b" },              "/bin/date",            ],          },        },      },    },  },}

نمایه‌های احراز هویت

فرادادهٔ ابزار

وضعیت ابزار

اجرای بررسی‌ها

هنگام نگارش، فقط بررسی‌های سیاست را اجرا کنید:

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

policy check فقط مجموعهٔ بررسی‌های سیاست را اجرا می‌کند و شواهد، یافته‌ها و هش‌های گواهی را خروجی می‌دهد. هنگامی که Plugin سیاست فعال باشد، همین یافته‌ها در openclaw doctor --lint نیز نمایش داده می‌شوند.

یک فایل سیاست اپراتور را با یک خط مبنای تدوین‌شده مقایسه کنید:

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:...",        },      },    },  },}

برای غیرفعال‌کردن بررسی‌های سیاست در یک فضای کاری، در حالی که Plugin نصب‌شده باقی می‌ماند، plugins.entries.policy.config.enabled را روی false تنظیم کنید.

پذیرش وضعیت سیاست

نمونهٔ خروجی 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

در CI یا اسکریپت‌هایی که به یک ارزیابی واحد از انحراف نیاز دارند، از --once استفاده کنید. بدون --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 راه‌دور را منع می‌کند، gateway.mode=local را تنظیم کند
• وقتی خط‌مشی نقاط پایانی API HTTP مربوط به Gateway را منع می‌کند، مسیرهای گزارش‌شده gateway.http.endpoints.*.enabled را روی false تنظیم کند
• وقتی خط‌مشی ورود باز گروهی را منع می‌کند، مسیرهای گزارش‌شده 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,        },      },    },  },}

کدهای خروج

مرتبط

• حالت بررسی Doctor
• CLI مسیر