SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场audit-openclaw-security

audit-openclaw-security

安全与审计

查看项目

更新于 10-15 14:03

技能介绍

用途

该技能用于对 OpenClaw 部署进行安全审计，检查范围包括网关暴露面、身份认证、频道访问、工具权限以及密钥处理。适用于 OpenClaw 安全审查场景。

审计前提：只审计用户拥有或已获授权评估的系统。默认以只读方式开始；配置变更、修复、重启、凭据轮换或暴露面调整均需事先获得批准。绝不索取原始令牌、密码、Cookie 或凭据存储。

主要能力

  • 建立信任边界：记录已安装的 OpenClaw 版本、主机/容器安排、网关绑定地址、代理/隧道路径，以及谁可以发送消息或调用工具。一个网关对应一个受信任的操作者/团队边界，而非相互对抗用户之间的隔离；不同信任域应使用独立网关与凭据。
  • 主机安装与容器镜像可能有不同的绑定默认值。应检查运行中的监听器与已发布的容器端口，而不是根据安装方式推断暴露情况。
  • 收集证据：解析 SKILL_DIR 为包含本文件的目录，捆绑路径相对于该目录而非被审计项目。输出在审查前保持本地与私密。
  • 提供 CLI 审计命令：
openclaw --version
openclaw security audit --help
openclaw security audit --json
openclaw security audit --deep --json
  • 更完整的主机/网络采集，可运行捆绑的采集器与渲染器：
bash "$SKILL_DIR/scripts/collect_openclaw_audit.sh" --out ./openclaw-audit
python3 "$SKILL_DIR/scripts/render_report.py" --input ./openclaw-audit --output ./openclaw-security-report.md
  • 将失败与不支持的命令记录为缺失证据，绝不记为通过的检查。渲染器是报告辅助工具，不证明部署安全。CLI 诊断可能包含私有标识符或敏感自由文本，分享前需检查。
  • 仅在必要时脱敏配置：优先对非密钥设置进行定向读取，而非完整配置导出。需要共享配置时：
python3 "$SKILL_DIR/scripts/redact_openclaw_config.py" ~/.openclaw/openclaw.json > openclaw.redacted.json

该辅助脚本解析 JSON/JSON5，替换敏感字段的完整值，并从 URL 中移除凭据。输入无效时返回非零状态且 stdout 为空。需要时安装 JSON5 解析器；不要退回到对原始配置进行正则编辑。解析过程中注释会消失。需人工审查未知字段与自由文本：脱敏并非穷尽的密钥检测器。输出不是可恢复的备份。

使用方式

  • 分诊与整改：用运行时/文件系统/提权工具遏制公开暴露与开放消息面。
  • 验证网关认证、允许的来源、受信任代理以及真实的客户端身份路径。Tailscale Serve 与公共 Funnel 的暴露不同；两者都不能替代检查访问策略。
  • 审查私信配对/允许列表、群组访问、提及门控与会话隔离。提及门控控制触发，而非敌意用户的安全边界。
  • 将工具、浏览器、节点、插件与自动化权限限制到任务所需。测试有效策略，而不仅是预期配置。
  • 审查凭据、记录与日志的权限与保留策略。将已安装插件与可写技能视为可执行的供应链输入。
  • 对每项已批准的变更，安全捕获先前配置，应用一项连贯变更，然后重新运行相关审计与功能检查。保留回滚路径。
  • 使用已安装的 CLI 与当前官方配置模式获取准确键名。不要从旧的检查 ID 列表推断安全性，也不要盲目粘贴平台基线。

适用场景

  • OpenClaw 安全审查。
  • 需要检查网关暴露、认证、频道访问、工具权限与密钥处理的部署。

限制

  • 仅限审计用户拥有或获授权的系统。
  • 默认只读；变更需批准。
  • 不索取原始令牌、密码、Cookie 或凭据存储。
  • 渲染器不证明部署安全。
  • 脱敏不是穷尽的密钥检测器，输出不是可恢复备份。
  • 失败与不支持的命令记为缺失证据，不记为通过。

支持材料

  • references/platform-mac-mini.md、references/platform-personal-laptop.md、references/platform-docker.md 或 references/platform-aws-ec2.md：平台调查提示。
  • references/openclaw-audit-checks.md 与 assets/openclaw_checkid_map.json：已知发现的解释；未知的当前检查仍需分诊。
  • assets/report-template.md：最终报告结构。

报告应包含范围/版本、带脱敏证据的观察发现、严重性与影响、已批准的变更、验证结果以及未测试的边界。将观察与建议分开。

来源与验证

2026-09-13 对照 OpenClaw 安全（包括其当前信任模型、审计、网络暴露与密钥章节）进行审查。更改安全策略前请查阅这些页面。

运行离线脱敏回归测试：

python3 -m unittest discover -s "$SKILL_DIR/tests" -v