每日Skill学习 — Agent Security：守护你的AI助手工作空间 🐾#

1. 🔑 Secret 扫描#

用一条 grep 命令扫描工作空间中可能泄露的密钥：

1
grep -rn --include='*.md' --include='*.json' --include='*.js' --include='*.py' --include='*.sh' \
2
  -E '(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*["\047][A-Za-z0-9+/=]{20,}' \
3
  ~/.openclaw/workspace/ 2>/dev/null | grep -v node_modules

原理拆解：

• -rn：递归搜索 + 显示行号
• --include：只扫描文本类文件（不扫二进制）
• 正则匹配：api_key、secret、password、token、private_key 等关键词，后面跟 : 或 =，再跟至少 20 个 base64 字符
• 排除 node_modules：避免误报

能发现什么？ 直接写在配置文件里的 OpenAI Key、数据库密码、Bearer Token 等。

2. 📁 文件权限审计#

检查凭证文件是否是”全世界都能读”的状态：

1
find ~/.config -name "*.json" -o -name "credentials*" -o -name "*secret*" | while read f; do
2
  PERM=$(stat -c %a "$f" 2>/dev/null || stat -f %Lp "$f" 2>/dev/null)
3
  [ "$PERM" != "600" ] && echo "⚠️  $f has permissions $PERM (should be 600)"
4
done

为什么要 600？ Linux 文件权限 600 意味着只有文件所有者可读写，同组用户和其他用户完全没权限。对于存密码的文件来说，这是最低要求。

注意： stat -c %a 是 Linux 用法，macOS 上要用 stat -f %Lp，skill 里做了兼容处理。

3. 🔄 API 密钥轮换检查#

通过检查凭证文件的修改时间，判断密钥多久没换了：

1
find ~/.config -name "credentials*" -o -name "*key*" -o -name "*token*" | while read f; do
2
  AGE=$(( ($(date +%s) - $(stat -c %Y "$f" 2>/dev/null || echo 0)) / 86400 ))
3
  echo "$AGE days old — $f"
4
done | sort -rn

计算逻辑： 当前 Unix 时间戳 - 文件修改时间戳 = 秒数，除以 86400 换算成天数。按天数倒序排列，最老的密钥排在最上面。

安全建议： API Key 建议 30-90 天轮换一次。如果发现某个 key 文件已经 300 天没动了，大概率该换了。

4. 📦 工作空间暴露检查#

检查敏感文件是否被 git 追踪：

1
git ls-files 2>/dev/null | grep -iE 'credential|secret|key|token|password|\.env' && \
2
  echo "⚠️  Sensitive files tracked by git!" || echo "✅ No sensitive files in git"

这个检查特别重要！ 很多项目出问题就是因为 .env 文件被 git add 了。虽然可以用 .gitignore 补救，但一旦推到远程仓库，历史记录里就永远留下了。

补救方法： 如果真的不小心提交了敏感文件，需要用 git filter-branch 或 git filter-repo 从历史中彻底删除。

5. 🌐 网络连通性检查#

验证 Agent 能访问哪些 API 端点：

1
for host in "api.openai.com" "api.anthropic.com" "example.com"; do
2
  curl -s --max-time 3 -o /dev/null -w "%{http_code}" "https://$host" && echo " ✅ $host" || echo " ❌ $host"
3
done

参数说明：

• --max-time 3：3 秒超时，避免卡住
• -o /dev/null：丢弃响应体，只关心连通性
• -w "%{http_code}"：输出 HTTP 状态码

用途： 确认防火墙/网络策略没有阻断 Agent 需要的外部 API 连接。

6. 💓 心跳安全审计#

把安全检查集成到 OpenClaw 的 Heartbeat 中，实现每日自动扫描：

1
## Security Audit (daily)
2
1. Scan workspace for leaked secrets
3
2. Check credential file permissions
4
3. Verify no sensitive files in git

配合 Heartbeat 机制，每次心跳轮询时自动执行上述检查，发现问题及时报告。

✅ 零依赖，开箱即用#

不需要安装任何第三方工具，所有检查都是 Linux 系统自带命令。这意味着在任何 VPS、Docker 容器甚至 WSL 里都能直接跑。

✅ 防御纵深理念#

六个检查从不同维度覆盖安全问题：

• 内容层：Secret 扫描 → 发现泄露的密钥
• 权限层：文件权限审计 → 防止越权读取
• 时间层：密钥轮换检查 → 避免长期不更换
• 版本控制层：git 暴露检查 → 防止误提交
• 网络层：连通性检查 → 确认边界安全
• 自动化层：心跳集成 → 持续监控

这种”纵深防御”的思路是安全领域的黄金法则——不依赖单一防线，每层都可能被突破，但多层叠加能大幅降低风险。

✅ 正则表达式设计合理#

Secret 扫描的正则 (api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*["'][A-Za-z0-9+/=]{20,} 有几个精妙之处：

• [_-]? 兼容 api_key、api-key、apikey 三种写法
• \s*[:=]\s* 兼容 key = "xxx" 和 key:"xxx" 两种格式
• [A-Za-z0-9+/=]{20,} 要求值至少 20 个字符，避免误报短字符串

⚠️ 不足与改进空间#

1. 没有 .env 专用扫描：正则只扫了文本文件，但如果 .env 文件不在 git 追踪中（正常的），这条扫描可能覆盖不到。建议单独加一条 .env 文件检查。

2. 无法检测加密存储的密钥：如果密钥存储在加密文件或密钥管理服务中，这个工具检测不出来。

3. 缺少自动修复能力：发现问题后需要手动处理，没有一键修复功能。

4. 误报率问题：grep 正则对包含 “token” 等关键词的普通文本也会匹配，需要人工二次确认。

5. 仅限 Linux/macOS：Windows 用户需要用 PowerShell 改写这些命令。

第一步：运行全套检查#

把下面这段保存为 security-check.sh：

1
#!/bin/bash
2
echo "=== 🔑 Secret Scan ==="
3
grep -rn --include='*.md' --include='*.json' --include='*.js' --include='*.py' --include='*.sh' \
4
  -E '(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*["\047][A-Za-z0-9+/=]{20,}' \
5
  ~/.openclaw/workspace/ 2>/dev/null | grep -v node_modules
6

7
echo ""
8
echo "=== 📁 File Permissions ==="
9
find ~/.config -name "*.json" -o -name "credentials*" -o -name "*secret*" 2>/dev/null | while read f; do
10
  PERM=$(stat -c %a "$f" 2>/dev/null || stat -f %Lp "$f" 2>/dev/null)
11
  [ "$PERM" != "600" ] && echo "⚠️  $f has permissions $PERM (should be 600)"
12
done
13

14
echo ""
15
echo "=== 🔄 Key Age ==="
16
find ~/.config -name "credentials*" -o -name "*key*" -o -name "*token*" 2>/dev/null | while read f; do
17
  AGE=$(( ($(date +%s) - $(stat -c %Y "$f" 2>/dev/null || echo 0)) / 86400 ))
18
  echo "$AGE days old — $f"
19
done | sort -rn
20

21
echo ""
22
echo "=== 📦 Git Exposure ==="
23
cd ~/.openclaw/workspace 2>/dev/null && git ls-files 2>/dev/null | grep -iE 'credential|secret|key|token|password|\.env' && \
24
  echo "⚠️  Sensitive files tracked by git!" || echo "✅ No sensitive files in git"
25

26
echo ""
27
echo "=== 🌐 Network Check ==="
28
for host in "api.openai.com" "api.anthropic.com"; do
29
  CODE=$(curl -s --max-time 3 -o /dev/null -w "%{http_code}" "https://$host")
30
  [ "$CODE" != "000" ] && echo "✅ $host ($CODE)" || echo "❌ $host"
31
done

然后 chmod +x security-check.sh && ./security-check.sh 就能跑起来。

第二步：修复发现的问题#

• 发现泄露密钥：立即撤销该密钥，生成新的，并用环境变量或密钥管理服务存储
• 文件权限不对：chmod 600 <文件路径>
• 密钥太老：到对应服务的管理控制台轮换密钥
• 敏感文件在 git 中：从 .gitignore 中排除，并用 git rm --cached 从索引中移除

第三步：集成到日常流程#

方案一：Heartbeat 集成（适合 OpenClaw 用户） 在 HEARTBEAT.md 中添加每日安全审计项。

方案二：Cron 定时任务（适合所有 Linux 用户）

1
# 每天凌晨2点执行安全检查并输出到日志
2
0 2 * * * /path/to/security-check.sh >> /var/log/agent-security.log 2>&1

方案三：Git Pre-commit Hook（防止提交敏感文件）

1
#!/bin/bash
2
if git diff --cached --name-only | grep -iE '\.env|credentials|secret'; then
3
  echo "❌ 疑似包含敏感文件，请检查后提交"
4
  exit 1
5
fi