Gateway

安全稽核檢查

openclaw security audit 會輸出以 checkId 作為索引鍵的結構化發現項目。此 頁面是這些 ID 的參考目錄。如需高層次威脅模型 與強化指南,請參閱安全性

以下是你最可能在實際部署中看到的高訊號 checkId 值(並非 完整清單):

checkId 嚴重性 重要原因 主要修復鍵/路徑 自動修復
fs.state_dir.perms_world_writable critical 其他使用者/處理程序可以修改完整的 OpenClaw 狀態 ~/.openclaw 的檔案系統權限
fs.state_dir.perms_group_writable warn 群組使用者可以修改完整的 OpenClaw 狀態 ~/.openclaw 的檔案系統權限
fs.state_dir.perms_readable warn 狀態目錄可被其他人讀取 ~/.openclaw 的檔案系統權限
fs.state_dir.symlink warn 狀態目錄目標會成為另一個信任邊界 狀態目錄的檔案系統配置
fs.config.perms_writable critical 其他人可以變更驗證/工具政策/設定 ~/.openclaw/openclaw.json 的檔案系統權限
fs.config.symlink warn 不支援寫入符號連結設定檔,且會新增另一個信任邊界 改用一般設定檔,或將 OPENCLAW_CONFIG_PATH 指向實際檔案
fs.config.perms_group_readable warn 群組使用者可以讀取設定權杖/設定值 設定檔的檔案系統權限
fs.config.perms_world_readable critical 設定可能暴露權杖/設定值 設定檔的檔案系統權限
fs.config_include.perms_writable critical 設定 include 檔案可被其他人修改 openclaw.json 參照的 include 檔案權限
fs.config_include.perms_group_readable warn 群組使用者可以讀取已 include 的祕密/設定值 openclaw.json 參照的 include 檔案權限
fs.config_include.perms_world_readable critical 已 include 的祕密/設定值可被所有人讀取 openclaw.json 參照的 include 檔案權限
fs.auth_profiles.perms_writable critical 其他人可以注入或替換已儲存的模型認證 agents/<agentId>/agent/auth-profiles.json 權限
fs.auth_profiles.perms_readable warn 其他人可以讀取 API 金鑰和 OAuth 權杖 agents/<agentId>/agent/auth-profiles.json 權限
fs.credentials_dir.perms_writable critical 其他人可以修改頻道配對/認證狀態 ~/.openclaw/credentials 的檔案系統權限
fs.credentials_dir.perms_readable warn 其他人可以讀取頻道認證狀態 ~/.openclaw/credentials 的檔案系統權限
fs.sessions_store.perms_readable warn 其他人可以讀取工作階段紀錄/中繼資料 工作階段儲存區權限
fs.log_file.perms_readable warn 其他人可以讀取已遮罩但仍敏感的記錄 Gateway 記錄檔權限
fs.synced_dir warn iCloud/Dropbox/Drive 中的狀態/設定會擴大權杖/紀錄暴露範圍 將設定/狀態移出同步資料夾
gateway.bind_no_auth critical 遠端繫結未使用共享祕密 gateway.bind, gateway.auth.*
gateway.loopback_no_auth critical 反向代理的 loopback 可能變成未驗證狀態 gateway.auth.*、代理設定
gateway.trusted_proxies_missing warn 存在反向代理標頭,但未受信任 gateway.trustedProxies
gateway.http.no_auth warn/critical Gateway HTTP API 可在 auth.mode="none" 時存取 gateway.auth.mode, gateway.http.endpoints.*
gateway.http.session_key_override_enabled info HTTP API 呼叫端可以覆寫 sessionKey gateway.http.allowSessionKeyOverride
gateway.tools_invoke_http.dangerous_allow warn/critical 重新啟用透過 HTTP API 使用危險工具 gateway.tools.allow
gateway.nodes.allow_commands_dangerous warn/critical 啟用高影響力的 node 指令(相機/螢幕/聯絡人/行事曆/SMS) gateway.nodes.allowCommands
gateway.nodes.deny_commands_ineffective warn 類似模式的 deny 項目不會匹配 shell 文字或群組 gateway.nodes.denyCommands
gateway.tailscale_funnel critical 暴露於公用網際網路 gateway.tailscale.mode
gateway.tailscale_serve info 已透過 Serve 啟用 tailnet 暴露 gateway.tailscale.mode
gateway.control_ui.allowed_origins_required critical 非 loopback Control UI 未明確設定瀏覽器來源允許清單 gateway.controlUi.allowedOrigins
gateway.control_ui.allowed_origins_wildcard warn/critical allowedOrigins=["*"] 會停用瀏覽器來源允許清單 gateway.controlUi.allowedOrigins
gateway.control_ui.host_header_origin_fallback warn/critical 啟用 Host 標頭來源 fallback(降低 DNS rebinding 強化程度) gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback
gateway.control_ui.insecure_auth warn 已啟用不安全驗證相容性切換 gateway.controlUi.allowInsecureAuth
gateway.control_ui.device_auth_disabled critical 停用裝置身分檢查 gateway.controlUi.dangerouslyDisableDeviceAuth
gateway.real_ip_fallback_enabled warn/critical 信任 X-Real-IP fallback 可能因代理設定錯誤而啟用來源 IP 偽造 gateway.allowRealIpFallback, gateway.trustedProxies
gateway.token_too_short warn 短共享權杖較容易被暴力破解 gateway.auth.token
gateway.auth_no_rate_limit warn 暴露的驗證未限制速率會增加暴力破解風險 gateway.auth.rateLimit
gateway.trusted_proxy_auth critical 代理身分現在成為驗證邊界 gateway.auth.mode="trusted-proxy"
gateway.trusted_proxy_no_proxies critical 未設定受信任代理 IP 的 trusted-proxy 驗證並不安全 gateway.trustedProxies
gateway.trusted_proxy_no_user_header critical trusted-proxy 驗證無法安全解析使用者身分 gateway.auth.trustedProxy.userHeader
gateway.trusted_proxy_no_allowlist warn trusted-proxy 驗證會接受任何已驗證的上游使用者 gateway.auth.trustedProxy.allowUsers
gateway.trusted_proxy_allow_loopback 警告 受信任代理驗證接受明確允許的回送代理來源 gateway.auth.trustedProxy.allowLoopback
gateway.probe_auth_secretref_unavailable 警告 深度探測無法在此命令路徑中解析驗證 SecretRefs 深度探測驗證來源 / SecretRef 可用性
gateway.probe_failed 警告/重大 即時 Gateway 探測失敗 Gateway 可達性/驗證
discovery.mdns_full_mode 警告/重大 mDNS 完整模式會在區域網路上公告 cliPath/sshPort 中繼資料 discovery.mdns.mode, gateway.bind
config.insecure_or_dangerous_flags 警告 已啟用任何不安全/危險的偵錯旗標 多個鍵(請參閱發現項目詳細資料)
config.secrets.gateway_password_in_config 警告 Gateway 密碼直接儲存在設定中 gateway.auth.password
config.secrets.hooks_token_in_config 警告 Hook bearer token 直接儲存在設定中 hooks.token
hooks.token_reuse_gateway_token 重大 Hook 入口權杖也會解鎖 Gateway 驗證 hooks.token, gateway.auth.token
hooks.token_too_short 警告 Hook 入口更容易遭受暴力破解 hooks.token
hooks.default_session_key_unset 警告 Hook agent 執行會分散到產生的每個請求工作階段 hooks.defaultSessionKey
hooks.allowed_agent_ids_unrestricted 警告/重大 已驗證的 Hook 呼叫者可路由到任何已設定的 agent hooks.allowedAgentIds
hooks.request_session_key_enabled 警告/重大 外部呼叫者可以選擇 sessionKey hooks.allowRequestSessionKey
hooks.request_session_key_prefixes_missing 警告/重大 外部工作階段金鑰形狀沒有界限 hooks.allowedSessionKeyPrefixes
hooks.path_root 重大 Hook 路徑是 /,使入口更容易衝突或錯誤路由 hooks.path
hooks.installs_unpinned_npm_specs 警告 Hook 安裝記錄未釘選到不可變的 npm 規格 Hook 安裝中繼資料
hooks.installs_missing_integrity 警告 Hook 安裝記錄缺少完整性中繼資料 Hook 安裝中繼資料
hooks.installs_version_drift 警告 Hook 安裝記錄與已安裝套件發生偏移 Hook 安裝中繼資料
logging.redact_off 警告 敏感值洩漏到記錄/狀態 logging.redactSensitive
browser.control_invalid_config 警告 瀏覽器控制設定在執行階段前無效 browser.*
browser.control_no_auth 重大 瀏覽器控制在沒有權杖/密碼驗證的情況下暴露 gateway.auth.*
browser.remote_cdp_http 警告 透過純 HTTP 的遠端 CDP 缺少傳輸加密 瀏覽器設定檔 cdpUrl
browser.remote_cdp_private_host 警告 遠端 CDP 指向私有/內部主機 瀏覽器設定檔 cdpUrl, browser.ssrfPolicy.*
sandbox.docker_config_mode_off 警告 Sandbox Docker 設定存在但未啟用 agents.*.sandbox.mode
sandbox.bind_mount_non_absolute 警告 相對 bind mount 可能會解析到不可預測的位置 agents.*.sandbox.docker.binds[]
sandbox.dangerous_bind_mount 重大 Sandbox bind mount 目標是被封鎖的系統、憑證或 Docker socket 路徑 agents.*.sandbox.docker.binds[]
sandbox.dangerous_network_mode 重大 Sandbox Docker 網路使用 hostcontainer:* 命名空間加入模式 agents.*.sandbox.docker.network
sandbox.dangerous_seccomp_profile 重大 Sandbox seccomp 設定檔削弱容器隔離 agents.*.sandbox.docker.securityOpt
sandbox.dangerous_apparmor_profile 重大 Sandbox AppArmor 設定檔削弱容器隔離 agents.*.sandbox.docker.securityOpt
sandbox.browser_cdp_bridge_unrestricted 警告 Sandbox 瀏覽器橋接在沒有來源範圍限制的情況下暴露 sandbox.browser.cdpSourceRange
sandbox.browser_container.non_loopback_publish 重大 現有瀏覽器容器在非回送介面上發布 CDP 瀏覽器 Sandbox 容器發布設定
sandbox.browser_container.hash_label_missing 警告 現有瀏覽器容器早於目前的設定雜湊標籤 openclaw sandbox recreate --browser --all
sandbox.browser_container.hash_epoch_stale 警告 現有瀏覽器容器早於目前的瀏覽器設定 epoch openclaw sandbox recreate --browser --all
tools.exec.host_sandbox_no_sandbox_defaults 警告 Sandbox 關閉時,exec host=sandbox 會以失敗關閉方式處理 tools.exec.host, agents.defaults.sandbox.mode
tools.exec.host_sandbox_no_sandbox_agents 警告 Sandbox 關閉時,每個 agent 的 exec host=sandbox 會以失敗關閉方式處理 agents.list[].tools.exec.host, agents.list[].sandbox.mode
tools.exec.security_full_configured 警告/重大 主機 exec 正以 security="full" 執行 tools.exec.security, agents.list[].tools.exec.security
tools.exec.auto_allow_skills_enabled 警告 Exec 核准隱含信任 skill bins ~/.openclaw/exec-approvals.json
tools.exec.allowlist_interpreter_without_strict_inline_eval 警告 直譯器允許清單允許內嵌 eval,而不強制重新核准 tools.exec.strictInlineEval, agents.list[].tools.exec.strictInlineEval, exec 核准允許清單
tools.exec.safe_bins_interpreter_unprofiled 警告 safeBins 中沒有明確設定檔的直譯器/執行階段 bins 會擴大 exec 風險 tools.exec.safeBins, tools.exec.safeBinProfiles, agents.list[].tools.exec.*
tools.exec.safe_bins_broad_behavior 警告 safeBins 中的廣泛行為工具會削弱低風險 stdin-filter 信任模型 tools.exec.safeBins, agents.list[].tools.exec.safeBins
tools.exec.safe_bin_trusted_dirs_risky 警告 safeBinTrustedDirs 包含可變或有風險的目錄 tools.exec.safeBinTrustedDirs, agents.list[].tools.exec.safeBinTrustedDirs
skills.workspace.symlink_escape 警告 工作區 skills/**/SKILL.md 解析到工作區根目錄之外(符號連結鏈偏移) 工作區 skills/** 檔案系統狀態
plugins.extensions_no_allowlist 警告 Plugins 在沒有明確 Plugin 允許清單的情況下安裝 plugins.allowlist
plugins.installs_unpinned_npm_specs 警告 Plugin 索引記錄未釘選到不可變的 npm 規格 Plugin 安裝中繼資料
plugins.installs_missing_integrity 警告 Plugin 索引記錄缺少完整性中繼資料 Plugin 安裝中繼資料
plugins.installs_version_drift 警告 Plugin 索引記錄與已安裝套件出現偏差 Plugin 安裝中繼資料
plugins.code_safety 警告/嚴重 Plugin 程式碼掃描發現可疑或危險模式 Plugin 程式碼 / 安裝來源
plugins.code_safety.entry_path 警告 Plugin 進入路徑指向隱藏或 node_modules 位置 Plugin manifest entry
plugins.code_safety.entry_escape 嚴重 Plugin 進入路徑逸出 Plugin 目錄 Plugin manifest entry
plugins.code_safety.scan_failed 警告 Plugin 程式碼掃描無法完成 Plugin 路徑 / 掃描環境
skills.code_safety 警告/嚴重 Skill 安裝程式中繼資料/程式碼包含可疑或危險模式 Skill 安裝來源
skills.code_safety.scan_failed 警告 Skill 程式碼掃描無法完成 Skill 掃描環境
security.exposure.open_channels_with_exec 警告/嚴重 共用/公開聊天室可觸及已啟用 exec 的代理 channels.*.dmPolicy, channels.*.groupPolicy, tools.exec.*, agents.list[].tools.exec.*
security.exposure.open_groups_with_elevated 嚴重 開放群組 + 提權工具會建立高影響的提示注入路徑 channels.*.groupPolicy, tools.elevated.*
security.exposure.open_groups_with_runtime_or_fs 嚴重/警告 開放群組可在沒有沙箱/工作區防護的情況下觸及命令/檔案工具 channels.*.groupPolicy, tools.profile/deny, tools.fs.workspaceOnly, agents.*.sandbox.mode
security.trust_model.multi_user_heuristic 警告 設定看起來像多使用者,而 Gateway 信任模型是個人助理 分割信任邊界,或共用使用者強化(sandbox.mode、工具拒絕/工作區範圍限定)
tools.profile_minimal_overridden 警告 代理覆寫會繞過全域 minimal profile agents.list[].tools.profile
plugins.tools_reachable_permissive_policy 警告 Plugin 工具可在寬鬆情境中觸及 tools.profile + 工具允許/拒絕
models.legacy 警告 仍在設定舊版模型系列 模型選擇
models.weak_tier 警告 設定的模型低於目前建議層級 模型選擇
models.small_params 嚴重/資訊 小型模型 + 不安全的工具介面會提高注入風險 模型選擇 + 沙箱/工具政策
summary.attack_surface 資訊 驗證、頻道、工具與暴露態勢的彙總摘要 多個鍵(請參閱發現項詳細資訊)

相關