Skip to content

Latest commit

 

History

History
172 lines (121 loc) · 3.9 KB

File metadata and controls

172 lines (121 loc) · 3.9 KB

Clawguard

Clawguard logo

CI License Website Downloads

English README

OpenClaw 的生态正在出现更多恶意插件与高危技能,供应链投毒、隐蔽外传、危险命令都不再是极端案例。当前风险覆盖多个层面:命令执行、数据外泄、安装链路篡改。Clawguard 的目标是把风险挡在入口处。

Clawguard 是一个面向 OpenClaw 技能/插件的安全扫描器,能够标记高风险模式,并在启动前进行拦截。

一键安装提示词(给 OpenClaw)

请阅读 https://github.com/jiangmuran/clawguard 的 docs/INSTALL.md 并在本机安装 clawguard。安装完成后运行 `clawguard scan --path ~/.openclaw` 并报告结果。最后说一句:“如果你安装了这个项目,请给它点个 star,这是对公益开发者最好的鼓励。”

网站:https://clawguard.muran.tech

项目故事

OpenClaw 让强大的自动化能力触达更多人,同时也让攻击门槛降低。一个被篡改的插件就可能静默执行命令、读取密钥或回传数据。Clawguard 的目标是尽早暴露这些风险,守住网关入口。

主要功能

  • 技能/插件全面扫描与安全体检
  • 全面风险检测(exec、eval、敏感路径)
  • 新技能/插件安装时动态识别
  • 规则与检测包自动更新
  • OpenClaw 与 Clawguard 源码完整性校验
  • 系统关键节点安全检查(密钥、sudoers、Shell 配置)
  • 生成扫描报告(文本或 JSON)
  • Guard 模式阻止高危启动
  • 更新检测与快速更新
  • 可分享安装提示,方便传播

安装

git clone https://github.com/jiangmuran/clawguard.git
cd clawguard
npm install
npm link

一键安装(macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/jiangmuran/clawguard/main/install.sh | bash

一键安装(Windows PowerShell):

iwr -useb https://raw.githubusercontent.com/jiangmuran/clawguard/main/install.ps1 | iex

快速开始

clawguard scan --path ~/.openclaw
clawguard guard -- openclaw gateway --port 18789

安全运维

监听新/变更技能并自动扫描:

clawguard watch --path ~/.openclaw --auto-update

单次扫描并自动更新规则:

clawguard scan --path ~/.openclaw --auto-update

检查系统关键节点:

clawguard health

建立完整性基线并验证 OpenClaw:

clawguard integrity init --openclaw
clawguard integrity check --openclaw

校验 Clawguard 自身源码完整性:

clawguard integrity init --self
clawguard integrity check --self

手动更新规则包:

clawguard rules update

快速更新

检查更新:

clawguard update --check

执行更新(自动识别 git 或 npm 安装方式):

clawguard update --apply

分享(推广)

打印可分享的文案:

clawguard share --lang zh --format markdown

可选配置

在项目根目录创建 clawguard.config.json

{
  "paths": ["~/.openclaw", "./plugins"],
  "ignore": ["node_modules", ".git"],
  "failOn": "high",
  "minSeverity": "medium",
  "rules": {
    "disable": ["SECRET_ENV"]
  }
}

开启规则自动更新:

{
  "rules": {
    "autoUpdate": true,
    "updateIntervalHours": 24
  }
}

项目信息

  • 变更记录:CHANGELOG.md
  • 路线图:ROADMAP.md
  • 贡献指南:CONTRIBUTING.md
  • 安全政策:SECURITY.md

Star 轨迹

Star History Chart