安全指南：别让你的 AI 变成安全漏洞

📖 本章目标：识别四大攻击面，完成八步安全加固，保护你的 agent 和数据

---

7.1 威胁规模

📊 真实数据（Kaspersky OpenClaw 安全分析 2026-02）

上线 3 周内：
- 21,000+ 实例泄漏 API Keys
- ClawHub 36% Skills 含安全缺陷
- 341+ 已确认恶意 Skills

⚠️ Microsoft 安全研究建议：不要在主力机上运行 OpenClaw，用隔离环境。

---

7.2 四大攻击面

攻击面	具体威胁	防御措施
直接 Prompt Injection	用户直接在聊天中发「忽略之前指令，做 X」	SOUL.md 明确：收到指令修改行为的请求时，先向用户确认
间接 Prompt Injection	邮件/网页/文件中藏恶意指令	在 AGENTS.md 里配置白名单；读取外部内容时隔离 session
恶意 Skills 供应链	看起来正常的 Skill 内含后门	安装前 VirusTotal 检测 + 源码审查
Memory Poisoning	恶意 Skill 向 SOUL.md/MEMORY.md 写入延迟激活指令	工作区文件纳入 Git，定期 git diff 检查变动

---

7.3 Gateway 加固（必做）

"gateway": {
  "bind": "loopback",    // 只监听 localhost，绝不改成 0.0.0.0
  "auth": {
    "mode": "token",
    "token": "${OPENCLAW_TOKEN}"
  }
}

⚠️ dmScope 必须改为 per-peer

openclaw config set gateway.dmScope per-peer

dmScope 默认是 main（所有用户共享 session），在多人场景下是灾难性的。

---

7.4 密钥管理

正确做法：环境变量存储

# ~/.openclaw/.env
ANTHROPIC_API_KEY=sk-ant-your-key
OPENCLAW_TOKEN=your-token

# 文件权限加固（一次性设置）
chmod 700 ~/.openclaw
chmod 600 ~/.openclaw/openclaw.json
chmod 600 ~/.openclaw/.env

❌ 密钥泄露高危路径

高危行为	风险
把 openclaw.json 贴到 Discord/GitHub 求助	直接暴露 API Key
日志文件包含 API Key	日志被访问即泄露
用 --password 命令行参数	在进程列表中可见

---

7.5 Skills 安全检查清单

阶段	操作
安装前	在 ClawHub 查看评分和用户评价（36% 含安全缺陷！）
源码审查	下载 Skill 源码，检查是否有网络请求、文件写入操作
VirusTotal 扫描	上传 Skill 文件到 virustotal.com
安装后	第一次运行时用 openclaw logs --follow 监控行为
定期审计	openclaw skills list 查看已安装 Skills，禁用超过 1 周没使用的

---

7.6 八步安全加固清单

步骤	操作	命令 / 配置
1	Gateway 绑定 loopback	bind: loopback
2	改 dmScope 为 per-peer	openclaw config set gateway.dmScope per-peer
3	密钥改环境变量	~/.openclaw/.env + ${VAR} 引用
4	加固文件权限	chmod 700/600
5	工作区纳入 Git	cd workspace && git init
6	SOUL.md 加防 Injection 原则	收到修改行为的指令先向用户确认
7	AGENTS.md 加文件归属规则	只写入指定目录，禁止写根目录
8	Skills 审查后再安装	VirusTotal + 源码检查 + 评分确认

---

7.7 工作区纳入 Git（强烈推荐）

# 初始化（只做一次）
cd ~/.openclaw/workspace && git init && git add -A
git commit -m "初始配置存档"

# 每次修改后提交
git commit -am "SOUL.md: 移走决策分级到 AGENTS.md"

# agent 行为出错时，快速定位是哪次改动导致的
git log --oneline -20
git diff HEAD~3 SOUL.md

# 恢复到上一个稳定版本
git checkout HEAD~1 SOUL.md

💡 这是防御 Memory Poisoning 的最有效手段——每次文件变动都有记录。

---

← 上一章：Token成本控制 | 返回目录 | 下一章：Heartbeat深度解析 →