mcpField
A
audit-openclaw-security

audit-openclaw-security

github.com/tristanmanchester安全493 次安装7 周前更新
代码仓库

关于 audit-openclaw-security

audit-openclaw-security 是用于审查自有或获授权 OpenClaw 系统的技能，要求先进行只读评估。它指导证据收集、暴露面与权限检查、配置脱敏及修复验证。

主要功能

  1. 01梳理部署的信任边界
  2. 02收集 CLI 与主机审计证据
  3. 03脱敏配置中的凭据
  4. 04检查网络暴露和工具权限
  5. 05获批修改后重新执行检查

适用场景

  1. 01评估获授权的 OpenClaw 部署
  2. 02准备脱敏后的安全报告
  3. 03调查网关暴露与访问控制
  4. 04验证获批的配置变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tristanmanchester/agent-skills --skill audit-openclaw-security

安装后在 Claude Code 中输入/audit-openclaw-security确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CHANGELOG.md
assets/
openclaw_checkid_map.json
report-template.md
references/
command-cheatsheet.md
openclaw-audit-checks.md
openclaw-baseline-config.md
platform-aws-ec2.md
platform-docker.md
platform-mac-mini.md
platform-personal-laptop.md
scripts/
collect_openclaw_audit.sh
redact_openclaw_config.py
render_report.py
tests/
test_redaction.py
test_review_regressions.py

详细介绍

审计 OpenClaw 安全性

仅审计用户拥有或获准评估的系统。先以只读方式开始；如需更改配置、修复、重启、轮换凭据或更改暴露范围，须先获得批准。切勿索要原始令牌、密码、Cookie 或凭据存储。

确定信任边界

记录已安装的 OpenClaw 版本、主机／容器布局、网关绑定地址、代理／隧道路径，以及哪些人可以发送消息或调用工具。一个网关对应一个可信的操作人员／团队边界，不用于隔离彼此不信任的用户。不同信任域应使用独立的网关和凭据。

主机安装和容器镜像可能采用不同的默认绑定设置。请检查正在运行的侦听器和已发布的容器端口，而不要根据安装方式推断暴露范围。

收集证据

将 SKILL_DIR 解析为包含此文件的目录。捆绑路径相对于该目录，而非正在审计的项目。审核前，请在本地妥善保管输出，不要公开。

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 中的凭据。输入无效时，它会返回非零状态码，且标准输出为空。需要时请安装 JSON5 解析器；不要退而使用正则表达式编辑原始配置。解析过程中注释会消失。请手动检查未知字段和自由文本：脱敏工具无法穷尽检测所有机密。输出不能用作可恢复的备份。

分类处理并修复

  1. 使用运行时／文件系统／高权限工具，限制公开暴露和开放的消息入口。
  2. 验证网关身份验证、允许的来源、可信代理以及实际的客户端身份路径。Tailscale Serve 和公开 Funnel 的暴露方式不同；两者都不能替代对访问策略的检查。
  3. 检查私信配对／允许列表、群组访问权限、提及门控和会话隔离。提及门控控制的是触发方式，而不是防范恶意用户的安全边界。
  4. 将工具、浏览器、节点、插件和自动化权限限制在任务所需范围内。测试实际生效的策略，而不只是预期配置。
  5. 检查凭据、转录记录和日志的权限及保留期限。将已安装的插件和可写技能视为可执行的供应链输入。
  6. 对每项已批准的更改，安全保存之前的配置，应用一项一致的更改，然后重新运行相关审计和功能检查。保留回滚途径。

请使用已安装的 CLI 和当前官方配置架构确认准确的配置键。不要依据过时的检查 ID 列表推断安全性，也不要盲目粘贴平台基线配置。

按需加载辅助材料

  • 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

评论

支持 Markdown