moltguard-zh

name	moltguard-zh
description	OpenClaw 原生安全插件——通过 MoltGuard API 检测工具结果与消息中的提示注入，可选本地净化网关在发送前脱敏 PII（银行卡/密码等），首次使用自动注册 API 密钥
tags	["security","protection","prompt-injection-detection"]
permissions	["network"]
metadata	{"clawdbot":{"requires":{"env":[]},"files":[]},"capabilities":{"allow":[{"network":["api.moltguard.com"]},{"read":["workspace/**"]},{"write":["workspace/**"]}],"deny":[{"execute":["!*"]}]},"env_declarations":[{"name":"MOLTTGUARD_API_KEY","required":false,"description":"MoltGuard API 密钥（可选 — 留空则自动注册）"}]}

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
}

🔧 故障排除

常见问题

1. API 密钥问题

   • 确保网络连接正常
   • 检查 API 密钥是否正确
   • 查看日志文件了解详情

2. 网关启动失败

   • 检查端口是否被占用
   • 确保 gatewayAutoStart 设置正确
   • 查看系统日志了解错误信息

3. 性能问题

   • 调整 timeoutMs 参数
   • 启用日志记录查看性能瓶颈

📝 日志记录

所有安全事件都会记录到 JSONL 格式的日志文件中：

# 默认日志位置
~/.openclaw/logs/

# 查看日志
cat ~/.openclaw/logs/moltguard-*.jsonl | jq '.'

日志内容包括：

• 检测到的时间戳
• 风险级别
• 检测到的内容
• 处理结果
• 相关上下文

---

注意: MoltGuard 需要网络连接以进行 API 调用。在严格隔离的环境中，可仅使用本地净化功能。