| name | SX-security-audit |
| description | 全方位安全审计技能。检查文件权限、环境变量、依赖漏洞、配置文件、网络端口、Git 安全、Shell 安全、macOS 安全、密钥检测等。支持 CLI 参数、JSON 输出、配置文件。当用户要求"安全检查"、"漏洞扫描"、"权限检查"、"安全审计"时使用此技能。 |
Security Audit - 全方位安全审计技能
本技能提供全面的安全检查功能，涵盖系统、代码、配置等多个层面，并支持生成报告发送到飞书。
检查范围
本技能支持以下安全检查模块（可通过 --check 选择）：
🔒 permissions - 权限与访问控制
- 敏感文件权限 - 检查 .ssh、.aws、.gnupg、OpenClaw 目录权限
- 使用位掩码
actual_mode & ~expected_mode 精确检测超出预期的权限位
🔓 world_writable - 世界可写文件检测
- 在 workspace 目录下扫描 o+w 权限的文件
- 检测 SUID/SGID 位设置的文件
🔐 config - OpenClaw 配置安全
- 使用正则模式检测配置文件中的真实密钥（AWS、GitHub、Slack、OpenAI 等）
- 检查 Gateway 认证方式
- 检查插件安装状态
📝 skills - Skills 代码安全
- 用正则模式匹配检测硬编码密钥
- 检查不安全的函数调用（eval、exec、os.system 等）
- 高熵字符串检测（Shannon entropy > 4.5）
📦 dependencies - 依赖与供应链安全
- 运行
npm audit --json 检查 NPM 依赖漏洞
- 正确处理 npm audit 非零返回码（有漏洞时返回非零）
- 按漏洞严重级别统计
🌍 env - 环境变量安全
- 扫描当前进程环境变量中的敏感信息
- 检测已知 API key 格式（sk-、ghp_、xoxb-、AKIA 等）
- 检测环境变量名称中的敏感关键词
🔀 git - Git 安全检查
- 检查 .gitignore 是否忽略了 .env、.secret、credentials 等
- 检查 git credential.helper 是否使用明文存储
- 扫描最近 commit diff 中的密钥模式
🌐 network - 网络端口扫描
- 使用
lsof -i -P -n 检查监听端口
- 标记监听 0.0.0.0（全接口暴露）的进程
- 列出所有监听端口清单
🐚 shell - Shell 安全检查
- 检查 .bash_history / .zsh_history 文件权限
- 扫描 .bashrc / .zshrc 中的明文 export 密钥
🍎 macos - macOS 安全检查（仅 macOS）
- 检查防火墙状态（socketfilterfw）
- 检查 Gatekeeper 状态（spctl）
- 检查 SIP 系统完整性保护状态（csrutil）
增强密钥检测
使用正则模式精确匹配已知密钥格式：
| 类型 | 模式 |
|---|
| AWS Access Key | AKIA[0-9A-Z]{16} |
| GitHub Token | ghp_[a-zA-Z0-9]{36} / github_pat_ |
| Slack Token | xox[bpas]- |
| OpenAI/Anthropic Key | sk-[a-zA-Z0-9]{20,} |
| JWT Token | eyJ[a-zA-Z0-9_-]+\.eyJ |
| Private Key | -----BEGIN PRIVATE KEY----- |
同时支持 Shannon 信息熵检测（> 4.5 的高熵字符串视为可疑密钥）。
CLI 使用方式
完整审计
python3 scripts/security_audit.py
指定检查模块
python3 scripts/security_audit.py --check permissions env git
过滤严重级别
python3 scripts/security_audit.py --severity high
JSON 输出
python3 scripts/security_audit.py --json
python3 scripts/security_audit.py --json --output report.json
列出可用模块
python3 scripts/security_audit.py --list-checks
静默模式
python3 scripts/security_audit.py --quiet --json --output report.json
配置文件支持
创建 .security-audit.json 自定义审计行为：
{
"excludePaths": [
"/tmp",
"node_modules"
],
"severityThreshold": "medium",
"autoFix": false,
"reportFormat": "markdown"
}
配置文件搜索顺序：
- 当前目录
.security-audit.json
~/.openclaw/.security-audit.json~/.openclaw/workspace/.security-audit.json
飞书报告
发送报告
python3 scripts/send_report_to_feishu.py report.md
python3 scripts/send_report_to_feishu.py report.md --format card
python3 scripts/send_report_to_feishu.py report.md --webhook https://...
支持的消息格式
- text - 纯文本消息
- rich - 飞书富文本（post 类型），包含标题、加粗等样式
- card - 交互式卡片，支持颜色标签（红/橙/绿），摘要卡片化展示
发送方式优先级
- OpenClaw 插件 API（如已配置飞书插件）
- 飞书 Webhook（通过
--webhook 或 FEISHU_WEBHOOK_URL 环境变量）
- 保存格式化消息供手动发送
报告格式
审计报告包含以下部分：
📊 执行摘要
- 审计时间、检查范围
- 通过/警告/失败统计
- 风险等级分布（严重/高/中/低）
🔍 详细检查结果
每个检查项包含：状态、风险等级、问题描述、影响范围、修复建议
📋 优先修复清单
按风险等级排序的问题列表，附带修复命令
参考资料
注意事项
- 首次运行可能需要安装额外依赖（
npm audit 等）
- 某些检查需要 sudo/root 权限（如完整端口扫描）
- macOS 安全检查仅在 Darwin 平台执行
- 报告发送到飞书需要飞书插件已配置或提供 Webhook URL
技能维护者: 小小宝 🐾✨
最后更新: 2026-03-12
