moltguard-zh

Files (30)

• LICENSE
• SKILL.md
• config.ts · agent/
• index.ts · agent/
• runner.ts · agent/
• sanitizer.ts · agent/
• types.ts · agent/
• SKILL.md · clawhub-skill/
• gateway-manager.ts
• config.ts · gateway/
• anthropic.ts · gateway/handlers/
• gemini.ts · gateway/handlers/
• openai.ts · gateway/handlers/
• index.ts · gateway/
• restorer.ts · gateway/
• sanitizer.ts · gateway/
• test-gateway.ts · gateway/
• types.ts · gateway/
• index.test.ts
• index.ts
• index.ts · memory/
• store.ts · memory/
• openclaw.plugin.json
• package.json
• clean-email.txt · samples/
• test-document.md · samples/
• test-email.txt · samples/
• test-webpage.html · samples/
• tsconfig.json
• tsconfig.plugin.json

SKILL.md (first lines)

# MoltGuard 安全防护

> OpenClaw 原生安全插件，检测和防止提示注入攻击

## 🛡️ 功能特性

- **提示注入检测** - 通过 MoltGuard API 分析工具结果和消息中的恶意提示注入
- **本地净化网关** - 可选的本地提示词净化，在发送到 LLM 前保护敏感数据
- **自动注册** - 首次使用时自动注册 API 密钥
- **灵活配置** - 支持超时、日志记录、拦截策略等高级配置

## 🚀 快速开始

### 基本配置

启用基本防护：

```json
{
  "enabled": true
}
```

### 启用本地净化网关

```json
{
  "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

## 🛡️ 安全特性

### 防护机制

- **拦截策略** - 检测到风险时自动拦截工具调用
- **日志记录** - 详细的安全事件日志
- **实时监控** - 实时监控工具执行和消息内容

### 合规性

- **数据本地化** - 敏感数据本地处理，不上传外部服务
- **透明度** - 所有可能的拦截都会记录日志
- **可控性** - 用户可以随时调整安全级别

## 📊 使用建议

### 高安全性场景

```json
{
  "enabled": true,
  "sanitizePrompt": true,
  "blockOnRisk": true,
  "logPath": "~/.openclaw/logs/security"
}
```

### 严格环境（无网络）

```json
{
  "enabled": true,
  "sanitizePrompt": true,
  "autoRegister": false,
  "blockOnRisk": true
}
```

## 🔧 故障排除

### 常见问题

1. **API 密钥问题**
   - 确保网络连接正常
   - 检查 API 密钥是否正确
   - 查看日志文件了解详情

2. **网关启动失败**
   - 检查端口是否被占用
   - 确保 gatewayAutoStart 设置正确
   - 查看系统日志了解错误信息

3. **性能问题**
   - 调整 timeoutMs 参数
   - 启用日志记录查看性能瓶颈

## 📝 日志记录

From L-LesterYu/OpenClaw-hot-skills-zh, MIT.

More from L-LesterYu/OpenClaw-hot-skills-zh