前言：安全无小事，别等出事再后悔
在部署、人格、技能及多会话功能日益强大的同时，安全风险也不容忽视。安全是系统稳定运行的基石，一旦出现问题后果严重。
主要风险场景包括：
- API 密钥泄露，导致额度被滥用
- AI 助手误删重要文件
- 敏感聊天记录被第三方获取
- 子代理执行危险操作导致系统入侵
本文将介绍 OpenClaw 的安全最佳实践，帮助降低潜在风险。
一、OpenClaw 安全架构概览
1.1 安全边界
OpenClaw 的安全设计遵循最小权限原则，层级结构如下：
外部世界（互联网）
↓
消息平台（WhatsApp/Telegram）
↓
OpenClaw 网关（你的控制）
↓
工作区（文件、配置、技能）
↓
本地系统（操作系统）
核心原则：越往外，风险越高；越往内，权限越受限。
1.2 威胁模型
| 风险类型 | 来源 | 影响程度 |
|---|---|---|
| API 密钥泄露 | 配置不当、代码泄露 | 🔴 高 |
| 敏感数据外传 | 技能/子代理行为 | 🔴 高 |
| 恶意技能执行 | 第三方技能 | 🟠 中高 |
| 文件误操作 | AI 指令误解 | 🟠 中 |
| 会话劫持 | 网络攻击 | 🟡 低 |
二、API 密钥安全
2.1 密钥存储最佳实践
❌ 错误做法：
// 直接把密钥写在代码里
const apiKey = "sk-1234567890abcdef";
✅ 正确做法： 使用环境变量：
export OPENCLAW_API_KEY="sk-1234567890abcdef"
或者在工作区创建 .env 文件：
OPENCLAW_API_KEY=sk-1234567890abcdef
关键点：
.env文件必须加入.gitignore，防止提交到代码仓库- 生产环境使用密钥管理服务（如 AWS Secrets Manager、HashiCorp Vault）
2.2 密钥权限最小化
申请 API 密钥时，只申请需要的权限：
- 如果只需要调用模型，不要申请管理权限
- 设置使用额度上限
- 定期轮换密钥（建议每 3-6 个月）
2.3 密钥泄露应对
如果怀疑密钥泄露：
- 立即撤销：去 API 提供方后台撤销该密钥
- 检查用量：查看是否有异常调用
- 生成新密钥：创建新密钥并更新配置
- 审计日志：检查 OpenClaw 日志，定位泄露来源
三、工作区安全
3.1 文件访问控制
OpenClaw 默认只能访问工作区内的文件，这是安全边界。
不要做：
// 技能中访问工作区外的敏感文件
const sensitiveData = fs.readFileSync('/etc/passwd');
const homeFiles = fs.readFileSync('/home/user/.ssh/id_rsa');
正确做法：
// 只访问工作区内的文件
const workspaceFile = fs.readFileSync('./data/config.json');
3.2 危险操作防护
涉及以下操作时，AI 应该先确认再执行：
- 删除文件（
rm、fs.unlink） - 覆盖重要文件
- 执行系统命令（
exec、spawn） - 网络请求（尤其是 POST）
技能中实现确认机制：
async function deleteFile(filePath) {
// 先询问用户确认
const confirmed = await askUser(`确定要删除 ${filePath} 吗？(y/n)`);
if (confirmed !== 'y') {
return { success: false, message: '用户取消操作' };
}
// 执行删除
fs.unlinkSync(filePath);
return { success: true };
}
3.3 工作区备份
定期备份工作区，防止意外丢失：
# 简单备份脚本
tar -czf workspace-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/workspace/
建议：
- 每天自动备份
- 备份到不同位置（本地 + 云端）
- 保留最近 7 天的备份
四、技能安全
4.1 第三方技能审查
使用第三方技能前，务必检查：
- 源代码：有没有可疑操作？
- 依赖项：
package.json里的依赖是否可信？ - 权限请求：技能请求的权限是否合理？
- 作者信誉：是否来自可信来源？
危险信号：
- 技能请求访问系统文件
- 技能向未知地址发送数据
- 技能要求执行任意命令
- 代码混淆或加密
4.2 技能沙箱
对于不信任的技能，可以在沙箱环境中运行：
# 使用 Docker 沙箱
docker run --rm -v ./workspace:/workspace openclaw-sandbox skill-runner
4.3 技能权限分级
建议给技能分个级：
| 等级 | 权限 | 示例 |
|---|---|---|
| 🔵 只读 | 只能读取文件 | 文档查看技能 |
| 🟢 低风险 | 可创建/修改文件 | 笔记技能 |
| 🟠 中风险 | 可删除文件、网络请求 | 文件管理技能 |
| 🔴 高风险 | 可执行系统命令 | 部署技能 |
高风险技能需要额外确认才能启用。
五、会话安全
5.1 会话隔离
不同用途使用不同会话：
- 主会话：日常对话
- 工作会话：处理工作相关任务
- 测试会话：测试新技能/配置
- 敏感会话：处理敏感信息
这样可以防止信息泄露和上下文污染。
5.2 会话数据清理
定期清理会话历史：
# 清理旧会话
openclaw sessions cleanup --older-than 7d
敏感对话后，手动删除会话：
openclaw session end --purge session-id
5.3 子代理安全
子代理继承主会话的权限，所以要特别注意：
- 不要给子代理过高的权限
- 子代理完成任务后及时结束
- 监控子代理的行为日志
六、网络安全
6.1 网关端口保护
OpenClaw 网关默认监听本地端口，如需对外暴露：
❌ 不要直接暴露：
# 危险！任何人都能连接
openclaw gateway start --host 0.0.0.0
✅ 正确做法：
# 只监听本地
openclaw gateway start --host 127.0.0.1
# 需要远程访问时，使用 SSH 隧道
ssh -L 8080:localhost:8080 user@remote-server
6.2 消息平台认证
连接 WhatsApp、Telegram 等平台时：
- 使用官方 API，不用第三方中转
- 保护 Bot Token，不泄露
- 定期检查授权的应用
6.3 防火墙配置
如果 OpenClaw 运行在服务器上，配置防火墙：
# Ubuntu/Debian
sudo ufw allow 22/tcp # SSH
sudo ufw deny 8080/tcp # 拒绝外部访问网关端口
# CentOS/RHEL
sudo firewall-cmd --add-port=22/tcp --permanent
sudo firewall-cmd --remove-port=8080/tcp --permanent
七、审计与监控
7.1 启用日志
OpenClaw 默认记录操作日志，位置在工作区：
workspace/logs/openclaw.log
定期检查日志，关注：
- 异常错误
- 未知技能调用
- 异常网络请求
7.2 安全审计清单
每月对照检查：
- API 密钥是否安全存储
- 工作区备份是否正常
- 第三方技能是否可信
- 会话是否及时清理
- 网关端口是否暴露
- 日志是否有异常
- 系统/Node.js 是否更新
7.3 安全事件响应
如果发现安全问题：
- 隔离：停止 OpenClaw 服务
- 评估：确定影响范围
- 修复：修补漏洞、更换密钥
- 恢复：从备份恢复（如需要）
- 复盘：记录事件，防止再发生
八、安全配置示例
8.1 推荐的 config.json
{
"gateway": {
"host": "127.0.0.1",
"port": 8080,
"allowExternal": false
},
"security": {
"confirmDangerousOps": true,
"maxSubAgents": 5,
"sessionTimeout": 3600
},
"logging": {
"level": "info",
"rotate": true,
"maxFiles": 7
}
}
8.2 推荐的 .gitignore
# OpenClaw 工作区
.env
*.log
logs/
memory/
config.local.json
node_modules/
九、常见问题
Q1: OpenClaw 会上传我的数据到云端吗？
A: 不会。OpenClaw 本地运行，数据存在你的工作区。只有调用 API 时，请求会发送到模型提供商。
Q2: 子代理能访问我的系统文件吗？
A: 默认只能访问工作区内的文件。如果技能请求系统权限，需要明确授权。
Q3: 如何确认我的 API 密钥没泄露？
A: 定期检查 API 提供商的使用量统计，发现异常立即撤销密钥。
Q4: OpenClaw 有自动更新吗？
A: 建议手动更新，更新前查看变更日志：npm view openclaw
结语
安全是系统稳定运行的基石。请牢记以下几点：
- API 密钥是命门，一定要保护好
- 第三方技能要审查，别随便用
- 危险操作要确认，别给 AI 太大权限
- 定期备份和审计，防患于未然
- 最小权限原则，够用就行
关键是养成习惯，把安全措施融入日常工作流程。
