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

openclaw-security-practice-guide

安全与审计

查看项目

更新于 10-15 13:52

技能介绍

用途

OpenClaw 安全实践指南（OpenClaw Security Practice Guide）是一套面向高权限自主 AI 智能体的安全框架，由 ara.so 制作、收录于 Hermes Skills 集合，维护者为 SlowMist 安全团队，采用 MIT 许可证。它针对以终端/root 权限运行的 OpenClaw 智能体，将传统静态主机防御转向「智能体零信任架构」（Agentic Zero-Trust Architecture），用于缓解破坏性操作、提示注入、供应链投毒和未授权业务逻辑执行等风险。

核心原则是：安全措施设计为由 AI 智能体自身解释和部署，尽量减少手动配置，同时对高风险操作保留明确的人类在环（human-in-the-loop）控制。

主要能力

指南提供三层防御矩阵：

事前防御（Pre-action Defense）

  • 行为黑名单（红/黄线命令）
  • 严格的 Skill/MCP 安装审计协议
  • 供应链投毒防护

事中防御（In-action Defense）

  • 权限收窄与最小权限执行
  • 跨 Skill 预检（Cross-Skill pre-flight checks）
  • 业务风控闸门

事后防御（Post-action Defense）

  • 每夜自动审计（13 项核心指标）
  • Brain Git 灾难恢复
  • 30 天持久审计追踪

红/黄线命令控制 红线（硬停止，需人工确认）包括破坏性操作（如 rm -rf /、dd if=/dev/zero of=/dev/sda、mkfs.*）、权限提升（chmod 777 /etc/shadow、chown -R nobody:nobody /）、网络暴露（iptables -F、ufw disable）、关键文件修改（> /etc/passwd）。黄线（软警告，智能体须说明理由）包括包安装（apt install、pip install）、外部下载（curl <url> | bash、wget <url> -O /tmp/script.sh）、权限变更（chmod +x <file>）。指南给出 check_command_safety() 实现模式，在命令执行前进行自检。

Skill 安装审计协议 代码审查工作流包括：下载到隔离区（~/.openclaw/skills-quarantine）、静态分析（grep eval/exec/system/shell_exec、curl|bash、wget|sh、查找 .so/.dylib/.dll）、权限审计（查找可执行文件、检查所有权）、二次下载检测（requests.get、urllib.request、http.get、fetch、subprocess.run curl、os.system wget）、文档审查与人工批准。v2.8 增强协议增加运行时网络调用检测、高风险文件类型警告（.so、.dylib、编译二进制）、可疑模式升级工作流、Token 优化代码审查（在 LLM 分析前用 bash 预过滤）。

每夜安全审计 提供自动化审计脚本 ~/.openclaw/nightly-security-audit.sh，使用 set -euo pipefail，检查项包括：意外 SUID 文件、Cron 任务完整性（sha256 基线比对）、SSH authorized_keys 哈希比对，以及文件权限、监听端口等其余指标。报告持久化到 $OC/security-reports/，保留 30 天自动轮转，支持 known-issues 排除文件抑制误报，输出显式健康状态与便于解析的摘要行。Cron 安装使用 --light-context 隔离标志防止工作区上下文劫持审计。

Brain Git 灾难恢复 在 ~/.openclaw/brain 初始化 Git 仓库，每夜自动提交备份，可通过 git log、git checkout <commit-hash> 恢复整体或单个文件。

使用方式

前置条件：已安装并运行 OpenClaw 智能体；具备 root/sudo 权限的 Linux 环境；强推理模型（Gemini、Claude Opus、GPT-4 或同等）；已配置 Git 用于审计追踪。

快速开始（智能体辅助部署）：

  1. 下载指南：v2.8 Beta（推荐 OpenClaw 2026.4+）或 v2.7 Legacy（OpenClaw 2026.3 及更早），使用 curl -O 从 GitHub raw 地址获取 markdown 文件。
  2. 将 markdown 文件放入 OpenClaw 聊天会话。
  3. 让智能体评估：请阅读此安全指南，在部署前识别与当前设置的任何风险或冲突。
  4. 部署：v2.8 按指南中的智能体辅助部署工作流执行；v2.7 按指南描述部署防御矩阵，包括红/黄线规则、收紧权限、部署每夜审计 Cron Job。
  5. 验证（推荐）：运行红队指南中的验证测试，确认防御正常工作。

配置项包括环境变量 OPENCLAW_HOME、AUDIT_RETENTION_DAYS（默认 30）、KNOWN_ISSUES_FILE；known-issues.txt 每行一个模式，用于 grep -vFf。OpenClaw 引擎升级后需重建基线：先手动审计识别新的合法变更，将预期变更加入 known-issues.txt，删除 .cron-baseline 与 .ssh-baseline 后重新运行审计建立新基线。

指南还提供常见模式：安全包安装（验证来源、--no-install-recommends）、外部脚本审查（隔离下载、静态分析、人工审查、隔离环境执行）、权限收紧（chmod 700 brain 目录、chmod 500 审计脚本、chattr +i 配置）。

适用场景

  • 以高权限（终端/root 能力）运行的 OpenClaw
  • 持续安装 Skill、MCP、脚本和工具的环境
  • 目标：在可控风险和明确可审计的前提下最大化能力

限制与注意事项

  • 版本兼容性：v2.7 适用于 OpenClaw 2026.3 及更早，v2.8 Beta 适用于 OpenClaw 2026.4 及之后。指南明确警告 OpenClaw 快速迭代可能导致与未来版本不兼容，务必先在非生产环境测试。
  • 最终责任仍由人类操作者承担。
  • 指南列出常见故障排查：审计脚本静默失败（检查 cron 日志、手动 bash -x 执行、确认 set -euo pipefail 与报告目录权限）、SUID 检测误报（构建完整 known-issues 列表）、智能体绕过红线（检查指南是否加载、模型能力、是否遭恶意 Skill 提示注入）、合法变更后基线漂移（审查报告后重建基线）、审计报告重启后丢失（确认报告目录不在 /tmp）。
  • 高级用法包括多智能体协调（共享审计目录、报告含 agent ID）与外部 SIEM 集成（logger 或远程 syslog），以及自定义红/黄线规则文件 ~/.openclaw/custom-rules.json。

安全哲学

指南基于四项核心原则：零摩擦运营（除红线外减少手动安全负担）、高风险需确认（不可逆操作暂停等待人工批准）、显式每夜审计（所有指标均报告，包括健康状态）、默认零信任（假设提示注入和供应链投毒始终可能发生）。