本页内容

本页内容

网关

安全审计检查

openclaw security audit 发出由 checkId 键入的结构化结果。此页面是这些 ID 的参考目录。有关高级威胁模型和强化指南,请参阅 Security。

某些检查仅使用 openclaw security audit --deep 运行:plugin/skill 代码扫描(plugins.code_safety*、skills.code_safety*)和实时网关检查(gateway.probe_*)。此表中的其他所有内容都在普通 openclaw security audit 上运行。

深度代码扫描每个插件或技能最多检查 500 个源文件,优先考虑声明的插件入口点,并跳过大于 1 MiB 的文件。遍历也会在 100,000 个目录条目(包括排除的条目)后停止。 *.code_safety.scan_truncated 警告表示某些文件未检查;它不识别危险代码。工作区技能路径扫描保留 2,000 个技能文件和 40,000 次目录访问的单独限制,以及相同的 100,000 项遍历限制。他们的 skills.workspace.scan_truncated 警告还涵盖了树的不可读部分。

像 warn/critical 这样的严重性表示同一个 checkId 可能根据配置以任一级别发出(例如,取决于 Gateway 是否对外远程暴露)。以下是实际部署中最可能看到的高信号值(并不完整):

checkId 严重性 重要原因 主要修复 key/path 自动修复
fs.state_dir.perms_world_writable 批判的 其他users/processes可以修改完整的OpenClaw状态 ~/.openclaw 上的文件系统权限 是
fs.state_dir.perms_group_writable 警告 组用户可以修改完整的 OpenClaw 状态 ~/.openclaw 上的文件系统权限 是
fs.state_dir.perms_readable 警告 状态目录可被其他用户读取 ~/.openclaw 上的文件系统权限 是
fs.state_dir.symlink 警告 状态目录目标成为另一个信任边界 状态目录文件系统布局 no
fs.config.perms_writable 批判的 其他可改 auth/tool policy/config ~/.openclaw/openclaw.json 上的文件系统权限 是
fs.config.symlink 警告 不支持写入符号链接配置文件,并且会增加另一个信任边界 替换为普通配置文件,或将 OPENCLAW_CONFIG_PATH 指向真实文件 no
fs.config.perms_group_readable 警告 组用户可以读取配置tokens/settings 配置文件的文件系统权限 是
fs.config.perms_world_readable 批判的 配置可以暴露tokens/settings 配置文件的文件系统权限 是
fs.config_include.perms_writable 批判的 其他用户可以修改配置包含文件 openclaw.json 引用的包含文件权限 是
fs.config_include.perms_group_readable 警告 群组用户可以阅读包含的secrets/settings openclaw.json 引用的包含文件权限 是
fs.config_include.perms_world_readable 批判的 包含的 secrets/settings 是世界可读的 openclaw.json 引用的包含文件权限 是
fs.auth_profiles.perms_writable 批判的 其他用户可以注入或替换已存储的模型凭据 代理本地 SQLite 身份验证 database/sidecar 权限和旧版 auth-profiles.json 权限 是
fs.auth_profiles.perms_readable 警告 其他用户可以读取 API 密钥和 OAuth 令牌 代理本地 SQLite 身份验证 database/sidecar 权限和旧版 auth-profiles.json 权限 是
fs.credentials_dir.perms_writable 批判的 其他人可以修改通道pairing/credential状态 ~/.openclaw/credentials 上的文件系统权限 是
fs.credentials_dir.perms_readable 警告 其他用户可以读取频道凭据状态 ~/.openclaw/credentials 上的文件系统权限 是
fs.sessions_store.perms_readable 警告 其他人可以读取会话 transcripts/metadata 会话存储权限 是
fs.log_file.perms_readable 警告 其他人可以读取原始的、可能包含凭证的日志 Gateway 日志文件权限 是
fs.synced_dir 警告 iCloud/Dropbox/Drive 中的 State/config 扩大了 token/transcript 的曝光范围 将 config/state 从同步文件夹中移出 no
gateway.bind_no_auth 批判的 远程绑定但没有共享密钥 gateway.bind, gateway.auth.* no
gateway.loopback_no_auth 批判的 经过反向代理的环回地址可能变得未经身份验证 gateway.auth.*、代理设置 no
gateway.trusted_proxies_missing 警告 存在反向代理标头,但未将其代理设为可信 gateway.trustedProxies no
gateway.http.no_auth warn/critical 可通过 auth.mode="none" 访问网关 HTTP API gateway.auth.mode, gateway.http.endpoints.*, plugins.entries.admin-http-rpc no
gateway.http.session_key_override_enabled 信息 HTTP API 调用方可以覆盖 sessionKey gateway.http.allowSessionKeyOverride no
gateway.tools_invoke_http.dangerous_allow warn/critical 为 owner/admin 调用者重新启用 HTTP API 上的危险工具 gateway.tools.allow no
gateway.nodes.allow_commands_dangerous warn/critical 启用高影响力的节点命令(桌面 input/camera/screen/contacts/calendar/SMS) gateway.nodes.commands.allow no
gateway.nodes.deny_commands_ineffective 警告 类似模式的拒绝条目无法匹配 shell 文本或命令组 gateway.nodes.commands.deny no
gateway.tailscale_funnel 批判的 暴露到公共互联网 gateway.tailscale.mode no
gateway.tailscale_serve 信息 通过 Serve 启用了 Tailnet 暴露 gateway.tailscale.mode no
gateway.control_ui.allowed_origins_required 批判的 没有有效的浏览器来源白名单的非环回 Control UI gateway.publicOrigin(当省略 gateway.controlUi.allowedOrigins 时)或显式白名单 no
gateway.control_ui.allowed_origins_wildcard warn/critical allowedOrigins=["*"] 会禁用浏览器来源允许列表 gateway.controlUi.allowedOrigins no
gateway.control_ui.host_header_origin_fallback warn/critical 启用 Host 标头来源回退(降低 DNS 重绑定防护) gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback no
gateway.real_ip_fallback_enabled warn/critical 信任 X-Real-IP 回退可能因代理配置错误而导致源 IP 欺骗 gateway.allowRealIpFallback, gateway.trustedProxies no
gateway.password_placeholder_value 批判的 密码为空或字符串化的 undefined/null 占位符 gateway.auth.password, OPENCLAW_GATEWAY_PASSWORD no
gateway.password_too_short 警告 共享密码少于 24 个字符 gateway.auth.password, OPENCLAW_GATEWAY_PASSWORD no
gateway.token_placeholder_value 批判的 令牌为空或字符串化的 undefined/null 占位符 gateway.auth.token no
gateway.token_too_short 警告 较短的共享令牌更容易被暴力破解 gateway.auth.token no
gateway.auth_no_rate_limit 警告 暴露的身份验证没有速率限制,会增加暴力破解风险 gateway.auth.rateLimit no
gateway.trusted_proxy_auth 批判的 代理身份现在成为身份验证边界 gateway.auth.mode="trusted-proxy" no
gateway.trusted_proxy_no_proxies 批判的 没有可信代理 IP 的可信代理身份验证是不安全的 gateway.trustedProxies no
gateway.trusted_proxy_no_user_header 批判的 可信代理身份验证无法安全解析用户身份 gateway.auth.trustedProxy.userHeader no
gateway.trusted_proxy_no_allowlist 警告 可信代理身份验证接受任何已通过上游身份验证的用户 gateway.auth.trustedProxy.allowUsers no
gateway.trusted_proxy_allow_loopback 警告 可信代理身份验证接受显式允许的环回代理来源 gateway.auth.trustedProxy.allowLoopback no
gateway.probe_auth_secretref_unavailable 警告 深度检查无法解析此命令路径中的身份验证 SecretRefs 深度检查身份验证源/SecretRef 可用性 no
gateway.probe_failed 警告 实时网关检查失败(仅限 --deep) 网关 reachability/auth no
discovery.mdns_full_mode warn/critical mDNS 完整模式会在本地网络上公布 cliPath/sshPort 元数据 discovery.mdns.mode, gateway.bind no
config.insecure_or_dangerous_flags 警告 启用一个 insecure/dangerous 调试标志 查找详细信息中指定的键 no
security.audit.suppressions.active 信息 审计输出配置了抑制项,结果可能经过筛选 security.audit.suppressions no
config.secrets.gateway_password_in_config 警告 Gateway 密码直接存储在配置中 gateway.auth.password no
config.secrets.hooks_token_in_config 警告 Hook bearer 令牌直接存储在配置中 hooks.token no
hooks.token_reuse_gateway_token 批判的 Hook 入口令牌同时可以解锁 Gateway 身份验证 hooks.token, gateway.auth.token, gateway.auth.password no
hooks.token_too_short 警告 Hook 入口更容易被暴力破解 hooks.token no
hooks.default_session_key_unset 警告 Hook agent 运行会分散到按请求生成的会话中 hooks.defaultSessionKey no
hooks.allowed_agent_ids_unrestricted warn/critical 已通过身份验证的 Hook 调用方可以路由到任何已配置的 agent hooks.allowedAgentIds no
hooks.request_session_key_enabled warn/critical 外部调用者可以选择sessionKey hooks.allowRequestSessionKey no
hooks.request_session_key_prefixes_missing warn/critical 没有限制外部会话密钥格式 hooks.allowedSessionKeyPrefixes no
hooks.path_root 批判的 Hook 路径为 /,使入口更容易发生冲突或路由错误 hooks.path no
hooks.installs_unpinned_npm_specs 警告 Hook 安装记录未固定到不可变的 npm 规范 Hook 安装元数据 no
hooks.installs_missing_integrity 警告 Hook 安装记录缺少完整性元数据 Hook 安装元数据 no
hooks.installs_version_drift 警告 Hook 安装记录与已安装的软件包发生版本偏移 Hook 安装元数据 no
browser.control_invalid_config 警告 浏览器控制配置在运行时之前即无效 browser.* no
browser.control_no_auth 批判的 未经 token/password 身份验证而暴露的浏览器控件 gateway.auth.* no
browser.remote_cdp_http 警告 通过纯 HTTP 进行的远程 CDP 缺少传输加密 浏览器配置文件 cdpUrl no
browser.remote_cdp_private_host 警告 远程 CDP 目标 private/internal 主机 浏览器配置文件 cdpUrl、browser.ssrfPolicy.* no
browser.extension_relay_legacy_auth 警告 旧版分机中继 bearer/Basic/token 身份验证保持启用状态 browser.extensionRelay.allowLegacyAuth no
sandbox.docker_config_mode_off 警告 存在 Sandbox Docker 配置,但处于非活动状态 agents.*.sandbox.mode no
sandbox.bind_mount_non_absolute 警告 相对绑定挂载的解析结果可能不可预测 agents.*.sandbox.docker.binds[] no
sandbox.dangerous_bind_mount 批判的 Sandbox 绑定挂载指向被阻止的系统、凭据或 Docker 套接字路径 agents.*.sandbox.docker.binds[] no
sandbox.dangerous_network_mode 批判的 Sandbox Docker 网络使用 host 或 container:* 命名空间加入模式 agents.*.sandbox.docker.network no
sandbox.dangerous_seccomp_profile 批判的 Sandbox seccomp 配置文件削弱了容器隔离 agents.*.sandbox.docker.securityOpt no
sandbox.dangerous_apparmor_profile 批判的 Sandbox AppArmor 配置文件削弱了容器隔离 agents.*.sandbox.docker.securityOpt no
sandbox.browser_cdp_bridge_unrestricted 警告 Sandbox 浏览器桥接暴露时未限制来源范围 sandbox.browser.cdpSourceRange no
sandbox.browser_container.non_loopback_publish 批判的 现有浏览器容器在非环回接口上发布 CDP 浏览器 Sandbox 容器发布配置 no
sandbox.browser_container.hash_label_missing 警告 现有浏览器容器早于当前配置哈希标签 openclaw sandbox recreate --browser --all no
sandbox.browser_container.hash_epoch_stale 警告 现有浏览器容器早于当前浏览器配置世代 openclaw sandbox recreate --browser --all no
sandbox.browser_container.docker_probe_timeout 警告 Docker 浏览器容器的标签检查超时 Docker 守护进程可达性 no
tools.exec.host_sandbox_no_sandbox_defaults 警告 exec host=sandbox 沙箱关闭时拒绝执行 tools.exec.host, agents.defaults.sandbox.mode no
tools.exec.host_sandbox_no_sandbox_agents 警告 当沙箱关闭时,每个代理 exec host=sandbox 拒绝执行 agents.entries.*.tools.exec.host, agents.entries.*.sandbox.mode no
tools.exec.security_full_configured warn/critical 主机 exec 运行时使用了 security="full" tools.exec.security, agents.entries.*.tools.exec.security no
tools.exec.agent_skill_mcp_boundary_drift 警告 存在代理技能白名单,而主机执行人员可以达到 MCP clients/registries agents.entries.*.tools.exec.*、sandbox/OS 隔离、MCP 服务器凭证 no
tools.exec.fs_tools_disabled_but_exec_enabled 警告 文件系统工具策略未使 shell 执行变为只读 tools.deny, agents.entries.*.tools.deny, agents.*.sandbox.workspaceAccess no
tools.exec.auto_allow_skills_enabled 警告 Exec 审批会隐式信任技能二进制文件 主机审批文件 no
tools.exec.allowlist_interpreter_without_strict_inline_eval 警告 解释器允许列表允许内联求值,但未强制重新审批 tools.exec.strictInlineEval、agents.entries.*.tools.exec.strictInlineEval、exec 审批允许列表 no
tools.exec.safe_bins_interpreter_unprofiled 警告 safeBins 中的 Interpreter/runtime 垃圾箱没有明确的配置文件会增加执行风险 tools.exec.safeBins, tools.exec.safeBinProfiles, agents.entries.*.tools.exec.* no
tools.exec.safe_bins_broad_behavior 警告 safeBins 中的广泛行为工具削弱了低风险 stdin 过滤信任模型 tools.exec.safeBins, agents.entries.*.tools.exec.safeBins no
tools.exec.safe_bin_trusted_dirs_risky 警告 safeBinTrustedDirs 包含可变或有风险的目录 tools.exec.safeBinTrustedDirs, agents.entries.*.tools.exec.safeBinTrustedDirs no
tools.elevated.allowFrom.<provider>.wildcard 批判的 tools.elevated.allowFrom.<provider> 包含 "*",会批准所有发送者 tools.elevated.allowFrom.<provider> no
tools.elevated.allowFrom.<provider>.large 警告 <provider> 的提升权限允许列表包含超过 25 个条目 tools.elevated.allowFrom.<provider> no
skills.workspace.symlink_escape 警告 工作区 skills/**/SKILL.md 解析到工作区根目录之外(符号链接链偏移) 工作区 skills/** 文件系统状态 no
skills.workspace.scan_truncated 警告 工作区技能扫描达到遍历限制或无法读取树的部分内容 目录访问和工作空间 skills/ 树大小 no
plugins.extensions_no_allowlist 警告 安装插件时未配置显式插件允许列表 plugins.allowlist no
plugins.allow_phantom_entries 警告 plugins.allow 列出了没有匹配已安装插件的 ID plugins.allow no
plugins.installs_unpinned_npm_specs 警告 插件索引记录未固定到不可变的 npm 规范 插件安装元数据 no
plugins.installs_missing_integrity 警告 插件索引记录缺少完整性元数据 插件安装元数据 no
plugins.installs_version_drift 警告 插件索引记录与已安装的软件包发生版本偏移 插件安装元数据 no
plugins.code_safety warn/critical 插件代码扫描发现可疑或危险模式(仅限 --deep) 插件代码 / 安装源 no
plugins.code_safety.entry_path 警告 插件入口路径指向隐藏目录或 node_modules 位置 插件清单 entry no
plugins.code_safety.entry_escape 批判的 插件入口逃逸出插件目录 插件清单 entry no
plugins.code_safety.manifest_parse_error 警告 代码安全扫描期间无法解析插件清单 插件清单文件 no
plugins.code_safety.scan_failed 警告 插件代码扫描无法完成(仅限 --deep) 插件路径 / 扫描环境 no
plugins.code_safety.scan_truncated 警告 插件代码扫描达到其文件或遍历预算(仅限 --deep) 手动查看有界扫描之外的文件 no
plugins.<pluginId>.security_audit_failed 警告 插件自有的安全审计收集器抛出错误 该插件的安全审计收集器 no
skills.code_safety warn/critical 技能安装程序 metadata/code 包含可疑或危险模式(仅限 --deep) 技能安装源 no
skills.code_safety.scan_failed 警告 技能代码扫描无法完成(仅限 --deep) 技能扫描环境 no
skills.code_safety.scan_truncated 警告 技能代码扫描达到其文件或遍历预算(仅限 --deep) 手动查看有界扫描之外的文件 no
channels.discord.allowlisted_groups.broad_members 警告 允许列表中的 Discord guild/channel 目标没有成员或角色限制 channels.discord.guilds.*.users/roles、每个频道的 users/roles no
security.exposure.open_channels_with_exec warn/critical Shared/public 房间可以联系启用 exec 的座席 channels.*.dmPolicy, channels.*.groupPolicy, tools.exec.*, agents.entries.*.tools.exec.* no
security.exposure.open_groups_with_elevated 批判的 打开 DMs/groups + 提升的工具创建高影响力的提示注入路径 顶级或嵌套 DM 策略路径、帐户覆盖、channels.*.groupPolicy no
security.exposure.open_groups_with_runtime_or_fs critical/warn 打开DMs/groups即可到达command/file工具,无需sandbox/workspace防护装置 DM/group 策略路径、tools.profile/deny、tools.fs.workspaceOnly、agents.*.sandbox.mode no
security.exposure.open_groups_with_control_plane_tools 批判的 打开DMs/groups可以到达更新、自动化或插件管理工具 tools.deny(automations、gateway、plugins)、DM/group 策略路径、tools.profile no
security.trust_model.multi_user_heuristic 警告 配置看起来是多用户的,而网关信任模型是个人助理 分割信任边界,或共享用户强化(sandbox.mode,工具 deny/workspace 范围界定) no
security.trust_model.cross_agent_session_access_default info/warn 多个代理;未钳制的呼叫者保留会话工具;信任边界信号升级为警告。 tools.sessions.visibility, tools.agentToAgent.allow, tools.agentToAgent.enabled no
tools.profile_minimal_overridden 警告 agent 覆盖设置绕过了全局最小配置文件 agents.entries.*.tools.profile no
plugins.tools_reachable_permissive_policy 警告 在允许的上下文中可访问的扩展工具 tools.profile + 工具 allow/deny no
models.small_params critical/info 小模型+不安全的工具表面增加注射风险 模型选择+sandbox/tool保单 no
channels.<provider>.dm.open 批判的 <provider> DM 保单为 "open";任何人都可以 DM 机器人 channels.<provider>.dmPolicy, .allowFrom no
channels.<provider>.dm.open_invalid 警告 dmPolicy="open" 与 allowFrom 中没有 "*" 不一致 channels.<provider>.allowFrom no
channels.<provider>.dm.scope_main_multiuser 警告 多个 DM 发送者当前共享主会话 session.dmScope no
channels.<provider>.allowFrom.mutable_entries_inert 警告 配置的条目仅匹配可变别名,并且无法在禁用名称匹配的情况下进行授权 用稳定的发件人 ID 替换受影响的 allowFrom 条目 no
channels.<provider>.allowFrom.dangerous_name_matching_enabled 信息 启用可变匹配;分类器感知通道报告有多少条目依赖于它 将可变的 allowFrom 条目替换为稳定的发件人 ID,然后禁用 dangerouslyAllowNameMatching no
channels.<provider>.account.read_only_resolution 警告 无法完全解析通道帐户以进行审核(缺少 secret/gateway) 检查引用的机密是否可以解析,或针对实时网关快照运行 no
channels.<provider>.warning.<n> info/warn/critical 提供商特定的安全警告,根据插件自由格式文本分类 参见发现详情 no
summary.attack_surface 信息 身份验证、频道、工具和暴露状态的汇总 多个键(参见发现详情) no

channels.<provider>.* 和 tools.elevated.allowFrom.<provider>.* checkId 是根据配置的 channel/provider 生成的,因此 <provider> 是实际输出中的真实通道 ID(例如 telegram、discord),而不是文字字符串。

可变条目检查使用配置的 allowFrom 条目,不包括 "*" 和配对存储批准,并报告计数和没有原始值的配置路径。符号 accessGroup: 引用不计为可变标识符。可变别名是可更改或共享的标签;相反,准确、稳定的标识符可能拥有未经证实的所有权。入口诊断将 mutable_identifier_disabled 与 identifier_authentication_too_weak 区分开来。

相关内容

本页有帮助吗?