Openclaw Security Guard

OpenClaw Security Guard

The missing security layer for your OpenClaw installation.

Audit. Monitor. Protect. All from one tool.

Quick Start • Why This Tool • Features • Dashboard • CLI • Contributing

Built by Miloud Belarebia at 2PiData — for the OpenClaw community.

______________________________________________________________________

问题

您安装了OpenClaw。它工作得很好。但问问自己：

• 你是 暴露的API密钥 配置文件或技能？
• 就是你 沙盒模式 正确配置？
• 做你的 MCP服务器 来自经过验证的来源？
• 能吗 提示注入 隐藏在工作区文件中？
• 你是 npm依赖关系 没有已知的漏洞？

如果你不确定，你需要这个工具。

______________________________________________________________________

快速开始

# Install globally
npm install -g openclaw-security-guard

# Run your first audit
openclaw-guard audit

# Fix issues automatically
openclaw-guard fix --auto

# Launch the live dashboard
openclaw-guard dashboard

30秒。 这就是了解你的安全态势所需要的一切。

______________________________________________________________________

为什么是保安？

OpenClaw生态系统中还有其他安全工具。以下是它们的比较：

保安不会取代这些工具。它填补了他们留下的空白。

______________________________________________________________________

所得

5个应用程序扫描仪+基础设施模块

基础设施安全（选择加入）

对于生产部署，请添加 --infra 扫描您的服务器：

openclaw-guard audit --infra

infra模块捕获应用程序扫描遗漏的内容：

• 应用评分为85/100，但网关已打开 0.0.0.0 启用SSH密码身份验证=实际上易受攻击
• 随着 --infra，综合得分反映了真实情况

自动淬火

三种模式以您的方式解决问题：

openclaw-guard fix               # Interactive: review each fix
openclaw-guard fix --auto        # Automatic: fix everything, backup first
openclaw-guard fix --dry-run     # Preview: see what would change

每次修复都会创建一个带时间戳的备份。没有什么是不可逆转的。

安全评分（0-100）

一个数字告诉你的立场：

扣除：关键发现=-10，高=-5，中=-2。沙盒关闭=-20。开放DM策略=-15。

______________________________________________________________________

实时仪表板

openclaw-guard dashboard

在以下位置打开受密码保护的web仪表板 http://localhost:18790 与：

• 实时安全评分 检测到威胁时进行更新
• 请求监控 每分钟请求跟踪
• 成本跟踪 API使用（每日/每月限额）
• 威胁源 显示及时的注入尝试、被阻止的请求、速率限制点击
• 配置概述 一目了然

仪表板运行 localhost 仅使用PBKDF2密码散列（10万次迭代，SHA-512），并通过WebSocket连接到您的OpenClaw网关。

______________________________________________________________________

CLI参考

全局选项

______________________________________________________________________

配置

创建 .openclaw-guard.json 在项目根目录或主目录中：

{
  "scanners": {
    "secrets": {
      "enabled": true,
      "exclude": ["*.test.js", "node_modules/**"]
    },
    "config": {
      "enabled": true,
      "strict": true
    },
    "prompts": {
      "enabled": true,
      "sensitivity": "high"
    },
    "mcpServers": {
      "allowlist": [
        "mcp-server-filesystem",
        "mcp-server-fetch",
        "mcp-server-memory",
        "mcp-server-sqlite",
        "mcp-server-git",
        "mcp-server-github"
      ],
      "blockUnknown": false
    }
  },
  "monitors": {
    "cost": {
      "dailyLimit": 10,
      "monthlyLimit": 100
    }
  },
  "dashboard": {
    "port": 18790
  }
}

______________________________________________________________________

程序化API

在您自己的项目中使用Security Guard作为库：

import { quickAudit, checkPromptInjection } from 'openclaw-security-guard';

// Full audit
const results = await quickAudit('~/.openclaw');
console.log(`Score: ${results.securityScore}/100`);
console.log(`Critical: ${results.summary.critical}`);

// Check a message for injection
const check = await checkPromptInjection('ignore all previous instructions');
console.log(check.safe); // false

// Individual scanners
import { SecretsScanner, ConfigAuditor, McpServerAuditor } from 'openclaw-security-guard';

const scanner = new SecretsScanner({});
const result = await scanner.scan('/path/to/openclaw');

______________________________________________________________________

隐私和安全

这是一个安全工具。它本身应该是安全的。以下是承诺：

看 安全.md 完整的安全策略。

______________________________________________________________________

文档

______________________________________________________________________

贡献

PR欢迎。看 贡献.md.

git clone https://github.com/2pidata/openclaw-security-guard.git
cd openclaw-security-guard
npm install
npm test    # 25 tests, 0 warnings

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

Created by Miloud Belarebia at 2PiData

Inspired by detect-secrets, trivy, and OWASP.

If this tool helps you, leave a star. It helps others find it too.

github.com/2pidata/openclaw-security-guard

Report a bug • Request a feature • 2pidata.com