openclaw-security-checker

# OpenClaw 安全检测器 基于《OpenClaw 极简安全实践指南》和《安全验证与攻防演练手册》的全面安全检测工具。对 OpenClaw 实例的配置、权限、隔离、网络、日志进行系统化审查，输出可量化的安全评分和修复建议。 ## Purpose OpenClaw 实例运行在 Docker 容器中，每用户独占一个容器（JoySafeter 架构）。该技能负责对实例的安全面进行系统化检测，覆盖部署前配置审查、运行时权限验证、隔离区合规检查三个阶段。 ## Prerequisites ### 环境要求 - OpenClaw 实例已部署并可访问（本地或容器内） - 对 `~/.openclaw/` 目录有读取权限 - `openclaw.json` 配置文件可读 ### 目标实例信息 - OpenClaw 版本号（`openclaw --version`） - 部署模式：local / docker / kubernetes - Gateway 端口和绑定范围 ## Core Workflow 1. **配置文件扫描**: 解析 `openclaw.json`，检查 gateway 认证、绑定范围、工具权限、模型配置中的安全隐患。 2. **凭证暴露检测**: 扫描配置文件、环境变量、日志中是否存在明文 API Key、Token、密码。 3. **Gateway 安全审计**: 验证 gateway 绑定地址、认证方式、CORS 白名单、trusted proxies 配置。 4. **工具权限验证**: 检查 `tools.profile` 设置，验证文件系统访问范围、命令执行权限、网络访问策略。 5. **文件权限检查**: 验证 `~/.openclaw/` 目录及关键文件的权限位，确保配置文件不可被其他用户读取。 6. **隔离区合规检查**: 扫描 `_quarantine` 目录，列出被隔离的技能及原因，验证隔离机制是否正常运作。 7. **运行时完整性验证**: 通过 SHA-256 哈希校验核心文件完整性，对比安装时的基线值。 8. **日志审计分析**: 检查最近操作日志中的可疑模式（大量失败请求、敏感操作、红线触发记录）。 9. **网络策略检查**: 验证出站网络请求白名单、DNS 解析范围、容器网络隔离状态。 ## 检查项目详情 ### 1. 配置安全检查 | 检查项 | 风险等级 | 检测规则 | 扣分 | |--------|---------|---------|------| | API Key 明文暴露 | CRITICAL | 正则匹配 `sk-*`, `key-*`, `token:` 等模式 | -20 | | Gateway 绑定 0.0.0.0 | HIGH | 检查 `gateway.bind` 是否为 `0.0.0.0` 或 `lan` | -10 | | 工具权限设为 full | MEDIUM | `tools.profile === "full"` | -5 | | CORS 白名单过宽 | MEDIUM | `allowedOrigins` 包含 `*` | -5 | | 认证 Token 弱强度 | HIGH | Token 长度 < 32 或 entropy < 4.0 | -10 | | 禁用设备认证 | HIGH | `dangerouslyDisableDeviceAuth: true` | -10 | | 模型 context 过大 | LOW | `contextWindow > 200000` | -2 | | 未配置 TLS | MEDIUM | Gateway 未启用 HTTPS | -5 | | 自动更新已禁用 | LOW | `update.checkOnStart: false` | -3 | ### 2. 权限与隔离检查 | 检查项 | 风险等级 | 检测规则 | 扣分 | |--------|---------|---------|------| | 配置文件权限过宽 | HIGH | `openclaw.json` 权限非 600/640 | -10 | | 工作区目录权限 | MEDIUM | `/workspace/` 权限非 700/750 | -5 | | 以 root 运行 | CRITICAL | 当前进程 UID == 0 | -20 | | 文件系统未限制 | HIGH | `tools.fs.workspaceOnly: false` | -10 | | 隔离区异常 | MEDIUM | `_quarantine` 中存在未审查的技能 | -5 | ### 3. 网络安全检查 | 检查项 | 风险等级 | 检测规则 | 扣分 | |--------|---------|---------|------| | trusted proxies 过宽 | MEDIUM | 包含 `/8` 大段网络 | -5 | | 出站无白名单 | HIGH | 未配置出站网络限制 | -10 | | Gateway 暴露在公网 | CRITICAL | 端口可从容器外访问 | -15 | ### 4. 日志审计检查 | 检查项 | 风险等级 | 检测规则 | 扣分 | |--------|---------|---------|------| | 敏感操作无日志 | HIGH | 关键操作缺少审计记录 | -10 | | 可疑操作模式 | MEDIUM | 短时间内大量异常请求 | -5 | | 红线触发记录 | CRITICAL | 检测到已触发的安全红线 | -15 | | 日志文件可写 | MEDIUM | 日志文件权限允许修改 | -5 | ## 安全评分体系 ### 评分公式 基础分 100 分，每项检查根据风险等级扣分： ``` 最终分 = max(0, 100 - Σ 扣分) ``` ### 安全等级 | 等级 | 分数范围 | 含义 | 建议操作 | |------|---------|------|---------| | **A** | 90-100 | 安全状态良好 | 保持现有配置，定期复检 | | **B** | 80-89 | 有少量警告 | 建议在下次维护窗口修复 | | **C** | 70-79 | 存在中等风险 | 应在一周内修复 | | **D** | 60-69 | 存在较大风险 | 需要立即关注并修复 | | **F** | 0-59 | 严重安全问题 | 必须立即停止服务并修复 | ## 示例输出 ``` ╔══════════════════════════════════════╗ ║ OpenClaw 安全检测报告 ║ ╠══════════════════════════════════════╣ ║ 实例: openclaw-a1b2c3d4 ║ ║ 版本: 2026.3.11 ║ ║ 部署: Docker 容器 ║ ║ 检测时间: 2026-03-13 10:30:00 UTC ║ ╚══════════════════════════════════════╝ ▶ 配置安全检查 ✗ [HIGH] Gateway 绑定范围为 lan，建议收窄为 localhost ✗ [MEDIUM] tools.profile 设置为 full，建议使用 restricted ✗ [HIGH] dangerouslyDisableDeviceAuth 已启用 ✓ API Key 未暴露 ✓ 认证 Token 强度合格 ▶ 权限与隔离检查 ✓ 以 node 用户运行 (非 root) ✓ 配置文件权限正常 (600) ✗ [MEDIUM] /workspace/skills 目录权限为 755，建议 750 ▶ 网络安全检查 ✗ [MEDIUM] trusted proxies 包含 10.0.0.0/8 大段 ✓ Gateway 仅容器内可达 ▶ 日志审计检查 ✓ 最近 24h 无可疑操作 ✓ 无红线触发记录 ╔══════════════════════════════════════╗ ║ 安全评分: B (82/100) ║ ║ 严重问题: 0 | 高危: 2 | 警告: 3 ║ ╠══════════════════════════════════════╣ ║ 修复建议: ║ ║ 1. 将 gateway.bind 改为 localhost ║ ║ 2. 启用设备认证 ║ ║ 3. 将 tools.profile 改为 restricted ║ ╚══════════════════════════════════════╝ ``` ## Tool Categories | Category | Tools | Purpose | |----------|-------|---------| | 配置解析 | jq, node (JSON parser) | 解析 openclaw.json 配置文件 | | 凭证扫描 | grep, TruffleHog patterns | 检测明文密钥和 Token | | 权限检查 | stat, ls, id | 验证文件权限和运行用户 | | 完整性校验 | sha256sum, openssl dgst | 核心文件哈希验证 | | 网络检测 | ss, netstat, iptables | 端口绑定和网络策略检查 | | 日志分析 | grep, jq, awk | 审计日志模式匹配 | ## 安全原则 - **事前**: 行为层黑名单 + 安全审计 + 配置基线 - **事中**: 权限收窄 + 哈希基线 + 运行时监控 - **事后**: 每晚自动巡检 + 显性化汇报 + 修复追踪 ## References - `references/tools.md` - 工具函数签名和参数说明 - `references/workflows.md` - 检测流程定义和判定规则