本页内容
本页内容
网关
安全审计检查
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 区分开来。
相关内容
- 安全
- 配置
- 可信代理授权
- Gateway 暴露操作手册 — 上述暴露结果的飞行前检查表