OpenClaw-hot-skills-zh moltguard-zh

OpenClaw 原生安全插件——通过 MoltGuard API 检测工具结果与消息中的提示注入，可选本地净化网关在发送前脱敏 PII（银行卡/密码等），首次使用自动注册 API 密钥

install

source · Clone the upstream repo

git clone https://github.com/L-LesterYu/OpenClaw-hot-skills-zh

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/L-LesterYu/OpenClaw-hot-skills-zh "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/moltguard-zh" ~/.claude/skills/l-lesteryu-openclaw-hot-skills-zh-moltguard-zh && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/L-LesterYu/OpenClaw-hot-skills-zh "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/moltguard-zh" ~/.openclaw/skills/l-lesteryu-openclaw-hot-skills-zh-moltguard-zh && rm -rf "$T"

manifest: skills/moltguard-zh/SKILL.md

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 调用。在严格隔离的环境中，可仅使用本地净化功能。