security-audit-hand（安全审计手）

Security Audit Hand - 自主安全审计

🎯 核心功能

自主定期安全检查：

• 系统漏洞扫描
• 配置审计
• 权限检查
• 日志分析
• 风险报告

灵感来源: OpenFang 16 层安全模型

🛡️ 审计框架 (基于 OpenFang)

16 层安全检查

🔍 审计流程 (7 阶段)

Phase 1: 状态恢复

1. memory_recall `security_audit_state`
2. 读取历史报告 `security_reports/`
3. 加载基线配置 `security_baseline.json`

Phase 2: 系统信息收集

# 系统信息
uname -a
whoami
pwd
df -h
free -h

# 网络信息
netstat -tlnp
curl ifconfig.me

# OpenClaw 状态
openclaw gateway status
openclaw --version

Phase 3: 配置审计

检查 ~/.openclaw/openclaw.json:
- [ ] auth.token 是否设置
- [ ] gateway.bind 是否安全 (loopback/lan)
- [ ] tools.deny 是否配置
- [ ] session.dmScope 是否安全
- [ ] 敏感信息是否明文

Phase 4: 权限检查

# 文件权限
ls -la ~/.openclaw/
ls -la ~/.openclaw/workspace/

# API Key 权限
cat ~/.openclaw/.api-keys.md | grep -E "sk-|nvapi-"

# 进程权限
ps aux | grep openclaw

Phase 5: 日志分析

# 检查异常日志
grep -i "error\|fail\|unauthorized" /tmp/openclaw/*.log

# 检查频繁错误
grep -c "error" /tmp/openclaw/openclaw-*.log

# 检查敏感信息泄露
grep -E "sk-[a-zA-Z0-9]+" /tmp/openclaw/*.log

Phase 6: 风险评估

每个风险评分 (0-100):
- 严重性：+40 (高/中/低)
- 可能性：+30 (高/中/低)
- 影响范围：+20 (系统/应用/数据)
- 可修复性：+10 (易/中/难)

风险等级:
- 🔴 高危：≥80 分
- 🟠 中危：50-79 分
- 🟡 低危：<50 分

Phase 7: 生成报告

# 安全审计报告

## 执行摘要
- 审计时间：[日期]
- 发现风险：N 个 (🔴X 🟠Y 🟡Z)
- 整体安全评分：X/100

## 发现的风险

### 🔴 高危风险 1: [名称]
**描述**: [详细说明]
**影响**: [可能的后果]
**修复建议**: [具体步骤]
**优先级**: 立即修复

### 🟠 中危风险 2: [名称]
...

## 安全评分趋势
[与历史审计对比]

## 修复计划
[按优先级排序的待办事项]

📊 检查清单

🔐 认证安全

• [ ] API Key 是否使用环境变量
• [ ] Token 是否定期轮换
• [ ] 是否启用双因素认证
• [ ] 密码是否足够复杂

🔒 数据安全

• [ ] 敏感文件是否加密
• [ ] 数据库是否加密
• [ ] 传输是否使用 HTTPS
• [ ] 备份是否安全

🛡️ 网络安全

• [ ] 防火墙是否开启
• [ ] 不必要端口是否关闭
• [ ] SSH 是否使用密钥认证
• [ ] 是否使用 VPN/Tailscale

📁 文件安全

• [ ] 敏感文件权限是否正确 (600)
• [ ] 是否有世界可读文件
• [ ] 是否有 SUID/SGID 文件
• [ ] 临时文件是否清理

🧩 应用安全

• [ ] OpenClaw 是否最新版本
• [ ] Skills 是否来自可信源
• [ ] 是否配置工具黑名单
• [ ] 是否启用会话维护

📋 报告模板

# 安全审计报告

**审计日期**: 2026-03-02
**审计范围**: OpenClaw 系统 + 服务器配置
**审计工具**: security-audit-hand v1.0

---

## 执行摘要

| 指标 | 值 |
|------|------|
| 整体安全评分 | 75/100 |
| 发现风险数 | 5 个 |
| 🔴 高危 | 0 个 |
| 🟠 中危 | 2 个 |
| 🟡 低危 | 3 个 |
| 上次审计 | 2026-02-26 |

---

## 发现的风险

### 🟠 中危风险 1: API Key 明文存储

**文件**: `~/.openclaw/openclaw.json`

**问题**: API Key 以明文形式存储在配置文件中

**影响**: 如果配置文件泄露，攻击者可使用 API Key

**修复建议**:

1. 使用环境变量

export DASHSCOPE_API_KEY="sk-xxx"

2. 或使用加密存储

openclaw secrets add dashscope_api_key

3. 修改配置文件

{ "models": { "providers": { "dashscope": { "apiKey": "${DASHSCOPE_API_KEY}" } } } }

**优先级**: 本周内修复

---

### 🟠 中危风险 2: Gateway 绑定到 LAN

**配置**: `gateway.bind = "lan"`

**问题**: Gateway 监听所有网络接口 (0.0.0.0)

**影响**: 同一网络内的设备可访问 Gateway

**修复建议**:

// 如果不需要远程访问 { gateway: { bind: "loopback" // 仅监听 127.0.0.1 } }

// 如果需要远程访问，使用 Tailscale { gateway: { bind: "lan", tailscale: { mode: "on" } } }

**优先级**: 本周内修复

---

### 🟡 低危风险 1: 未配置工具黑名单

**问题**: `tools.deny` 未配置

**影响**: 默认允许所有工具，可能误用危险工具

**修复建议**:

{ tools: { deny: ["group:runtime"], // 禁止 exec/bash } }

---

## 安全评分趋势

2026-02-26: 70/100 2026-03-02: 75/100 (+5)

**改进**:
- ✅ 配置了会话维护
- ✅ 启用了循环检测
- ⏳ 待修复：API Key 存储

---

## 修复计划

### 立即修复 (本周)
- [ ] API Key 改用环境变量
- [ ] Gateway 绑定改为 loopback

### 短期修复 (本月)
- [ ] 配置工具黑名单
- [ ] 启用 Tailscale 远程访问
- [ ] 配置定期安全审计

### 长期改进 (下季度)
- [ ] 实现 Merkle 审计日志
- [ ] 添加污点追踪
- [ ] 实现秘密零化

---

## 附录

### 审计命令

openclaw security audit openclaw doctor openclaw gateway status --deep

### 参考文档
- OpenFang Security Model: 16 layers
- OpenClaw Security: /gateway/security
- Server Hardening: /skills/healthcheck

🔧 配置选项

# 审计频率
audit_schedule = "weekly"  # daily/weekly/monthly

# 风险阈值
high_risk_threshold = 80
medium_risk_threshold = 50

# 报告设置
report_format = "markdown"
save_history = true
history_retention_days = 90

# 通知设置
notify_on_high_risk = true
notify_channel = "feishu"

📊 仪表盘指标

{
  "security_audit_score": 75,
  "security_audit_last_date": "2026-03-02",
  "security_high_risks": 0,
  "security_medium_risks": 2,
  "security_low_risks": 3,
  "security_reports_generated": 1,
  "security_fixes_applied": 0
}

🎯 使用示例

激活 Hand

openfang hand activate security-audit

手动触发审计

帮我做一次全面的安全审计

查看安全评分

现在的安全评分是多少？

定期检查

每周一早上 9 点自动审计

📝 从 OpenFang 借鉴

1. ✅ 16 层安全模型 (完整采用)
2. ✅ 自主定期审计 (适配实现)
3. ✅ 风险评分系统 (直接采用)
4. ✅ 审计报告模板 (优化适配)
5. ✅ 仪表盘指标 (简化实现)

*此 Skill 受 OpenFang Security Model 启发创建*