openclaw-hardener

🛡️ OpenClaw 安全加固与审计专家

开源 OpenClaw 安全加固工具,提供深度审计、敏感信息扫描与权限修复,默认只读模式保障操作安全。

收藏
1.6k
安装
712
版本
v0.1.2
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

OpenClaw Hardener 是一款专为 OpenClaw 环境设计的本地安全加固工具,通过集成内置安全审计、工作区卫生检查与配置加固功能,帮助开发者系统性识别并修复潜在的安全风险。该工具采用 Python 编写,通过命令行界面提供灵活的检查与修复能力。

核心用法围绕四个主要场景展开:首先是只读检查模式(check --all),这是推荐的默认使用方式,可运行 OpenClaw 内置的深度安全审计(openclaw security audit --deep)并检查工作区卫生状况,包括 ~/.openclaw 目录权限、异常可执行文件位、stray .env 文件以及不安全的反序列化模式;其次是修复模式(fix --all),在用户显式确认后应用安全的机械修复,包括权限清理(chmod/exec-bit)和审计自动修复;第三是配置加固规划(plan-config),生成 JSON5 格式的 Gateway 配置补丁计划,用于收紧运行时策略;最后是配置应用(apply-config),通过 openclaw gateway call 将审查后的配置补丁应用到运行中的网关。

该工具的显著优点体现在其安全优先的设计哲学上。默认只读模式确保用户在了解当前安全状态前不会无意中修改系统;完善的敏感信息脱敏机制(REDACT_PATTERNS)可自动识别并脱敏输出中的 API Key、Bearer Token、JWT 和私钥等敏感内容;所有子进程调用均使用硬编码命令,用户输入通过 pathlib.Path 安全处理,有效防范命令注入;此外,工具明确遵循"无秘密输出"和"补丁计划必须显式"的设计规则,确保操作透明可控。

然而,该工具也存在一定局限性。首先,其来源为 GitHub 个人账号(T3 级别),虽代码本身通过 A 级安全认证,但企业环境仍需额外审查;其次,依赖未完全锁定(lockfilesRequired: false),存在依赖版本漂移风险;再者,配置补丁生成采用"尽力而为"策略,需要用户具备足够的安全知识进行人工审查,无法完全自动化部署;最后,仅适用于 OpenClaw 生态,对其他 AI 开发环境无直接支持。

适合使用该技能的目标群体主要包括:OpenClaw 环境的日常用户与管理员,需要定期审计工作区安全状况;安全工程师与 DevOps 从业者,负责维护开发环境的安全基线;以及对数据泄露和提示注入攻击有防范意识的高级开发者。特别适用于需要检查环境变量泄露、权限配置错误和敏感信息硬编码等场景,但不适用于需要完全自动化无人值守修复的生产环境。

使用风险方面,尽管工具本身设计安全,但用户需注意:在 fix 模式下修改文件权限或应用配置补丁时,可能因误操作影响正常业务流程;依赖的外部工具(如 trufflehog、semgrep)若版本不兼容可能导致检查失败或误报;此外,由于来源为第三方个人仓库,建议在使用前进行代码审计,并在隔离环境中首次运行验证,避免潜在供应链风险。

安全解读

核心用法

OpenClaw Hardener 是一款面向 OpenClaw 运行时的本地安全加固工具,采用「检查优先、修复可选」的设计理念。用户通过 check 子命令进行只读审计,确认风险后再通过 fixapply-config 执行安全加固。主要功能模块包括:

1. OpenClaw 内置审计:调用 openclaw security audit --deep 检测提示注入、数据外泄等运行时风险;
2. 工作区卫生检查:扫描 ~/.openclaw 及当前仓库的权限位、 stray .env 文件、危险反序列化模式等;

3. 配置补丁规划:生成 JSON5 格式的 config.patch,用于收紧网关的 inbound 访问策略与日志脱敏配置。

显著优点

  • 零第三方依赖:纯 Python 标准库实现,消除供应链攻击面;
  • 密钥自动脱敏:内置 REDACT_PATTERNS 机制,审计报告中自动屏蔽 OpenAI Key、JWT 等敏感令牌;
  • 权限最小化:明确拒绝 /etc/**/root/** 访问,仅申请功能必需的 <repo>/**~/.openclaw/**
  • 透明可审计:所有 patch 计划先展示再应用,用户拥有完全决策权。

潜在局限

  • 子进程调用面较广:需执行 openclawgitbashjq 等外部命令,若宿主机工具链被篡改存在理论风险;
  • 启发式检测非完备:RISKY_PATTERNS 基于正则匹配,可能漏检新型攻击模式或产生误报;
  • 配置补丁需人工复核:生成的 patch 为「尽力而为」模板,实际策略需结合业务场景调整。

适合人群

  • 使用 OpenClaw 框架的开发者与运维团队;
  • 需满足内部合规审计(GDPR/CCPA)的技术负责人;
  • 希望快速收敛「密钥硬编码 + 权限过宽」两类最常见安全债的 DevSecOps 工程师。

常规风险

| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| 误操作修复 | `fix` 模式会修改文件权限位 | 默认只读,执行前强制二次确认 |
| 敏感信息残留 | 扫描过程可能读取 `.env` 文件 | 输出强制脱敏,原始内容不落盘 |
| 网关配置漂移 | `apply-config` 可能收紧策略导致业务中断 | patch 先展示后应用,建议灰度验证 |

版本与维护

  • 当前版本:0.1.2
  • 维护者:virtaava(GitHub 组织账号,T2 可信来源)
  • 代码规模:4 文件 / 448 行可执行代码
  • 认证结果:CLS-Certify A 级(85 分)

openclaw-hardener 内容

scripts文件夹
手动下载zip · 7.2 kB
hardener.pytext/plain
请选择文件