l-lesteryu MoltGuard 安全防护
OpenClaw 原生安全插件，检测和防止提示注入攻击
🛡️ 功能特性
- 提示注入检测 - 通过 MoltGuard API 分析工具结果和消息中的恶意提示注入
- 本地净化网关 - 可选的本地提示词净化，在发送到 LLM 前保护敏感数据
- 自动注册 - 首次使用时自动注册 API 密钥
- 灵活配置 - 支持超时、日志记录、拦截策略等高级配置
🚀 快速开始
基本配置
启用基本防护：
{
"enabled": true
}
启用本地净化网关
{
"enabled": true,
"sanitizePrompt": true,
"gatewayAutoStart": true
}
⚙️ 配置选项
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
enabled |
boolean | true |
启用或禁用防护 |
sanitizePrompt |
boolean | false |
启用本地提示词净化网关 |
gatewayPort |
number | 8900 |
本地净化网关端口 |
gatewayAutoStart |
boolean | true |
插件加载时自动启动网关 |
blockOnRisk |
boolean | true |
检测到注入时拦截工具调用 |
apiKey |
string | - | MoltGuard API 密钥（可选） |
timeoutMs |
number | 60000 |
分析超时时间（毫秒） |
autoRegister |
boolean | true |
apiKey 为空时自动注册 API 密钥 |
apiBaseUrl |
string | https://api.moltguard.com |
MoltGuard API 基础 URL |
🔍 工作原理
1. 检测模式
- 工具结果分析 - 扫描工具执行结果中的恶意注入内容
- 消息检测 - 检测输入消息中的提示注入攻击
- 风险评估 - 基于上下文评估风险级别
2. 净化模式（可选）
- 本地网关 - 在本地运行提示词净化服务
- PII 脱敏 - 自动检测并脱敏敏感信息
- 隐私保护 - 确保敏感数据不会发送到 LLM
🛡️ 安全特性
防护机制
- 拦截策略 - 检测到风险时自动拦截工具调用
- 日志记录 - 详细的安全事件日志
- 实时监控 - 实时监控工具执行和消息内容
合规性
- 数据本地化 - 敏感数据本地处理，不上传外部服务
- 透明度 - 所有可能的拦截都会记录日志
- 可控性 - 用户可以随时调整安全级别
📊 使用建议
高安全性场景
{
"enabled": true,
"sanitizePrompt": true,
"blockOnRisk": true,
"logPath": "~/.openclaw/logs/security"
}
严格环境（无网络）
{
"enabled": true,
"sanitizePrompt": true,
"autoRegister": false,
"blockOnRisk": true
}
🔧 故障排除
常见问题
API 密钥问题
- 确保网络连接正常
- 检查 API 密钥是否正确
- 查看日志文件了解详情
网关启动失败
- 检查端口是否被占用
- 确保 gatewayAutoStart 设置正确
- 查看系统日志了解错误信息
性能问题
- 调整 timeoutMs 参数
- 启用日志记录查看性能瓶颈
📝 日志记录
所有安全事件都会记录到 JSONL 格式的日志文件中：
# 默认日志位置
~/.openclaw/logs/
# 查看日志
cat ~/.openclaw/logs/moltguard-*.jsonl | jq '.'
日志内容包括：
- 检测到的时间戳
- 风险级别
- 检测到的内容
- 处理结果
- 相关上下文
注意: MoltGuard 需要网络连接以进行 API 调用。在严格隔离的环境中，可仅使用本地净化功能。