📦 AI-Warden — Prompt Injection Protection — AI-Warden — 提示注入防护
v1.4.1安装、配置并管理 OpenClaw 的 AI-Warden 提示注入防护插件。发布者:AI-Warden(ai-warden.io)。源码:github.com/ai-ward...
详细分析 ▾
运行时依赖
版本
**技能元数据和安装说明已更新,以提升安全性与清晰度。** - 新增显式包版本(`openclaw-ai-warden@2.4.0`)及 NPM 来源/完整性验证步骤。 - 安装步骤现要求版本检查与 shasum 验证,保障供应链安全。 - 安装清单指定所需 Node.js 版本、NPM 及可选 `AI_WARDEN_API_KEY` 环境变量。 - 明确说明配置中 `plugins.allow` 的用法。 - 所有安装与更新命令已指向新的必需包版本。 - 运行逻辑无变动,仅文档优化与最佳实践。
安装命令
点击复制技能文档
OpenClaw 代理的提示注入防护。5 层安全盾 + 污染锁。
- 发布者: AI-Warden
- 源码: github.com/ai-warden/openclaw-plugin
- NPM: openclaw-ai-warden
- 兼容: OpenClaw 2026.3.14+ 及 4.x
要求
- OpenClaw 2026.3.14+(含 4.x)
- Node.js 18+
- npm(随 Node.js 自带)
安装 —— 按顺序执行
每一步都是独立命令,逐条运行并确认输出无误。Step 0:备份配置
``bash
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak && echo "BACKUP OK"
`
验证: 输出 BACKUP OK。 Step 1:创建扩展目录
`bash
mkdir -p ~/.openclaw/extensions/ai-warden
`
`bash
echo '{"private":true}' > ~/.openclaw/extensions/ai-warden/package.json
`
验证: 无报错。 Step 2:安装 npm 包
`bash
cd ~/.openclaw/extensions/ai-warden && npm install openclaw-ai-warden@2.4.0
`
验证: 无错误、无审计警告。检查已装包:
`bash
ls node_modules/openclaw-ai-warden/
`
`bash
cat node_modules/openclaw-ai-warden/package.json | grep -E '"name"|"version"'
`
确认包名 openclaw-ai-warden 且版本为 2.4.0。 来源验证:
`bash
npm info openclaw-ai-warden repository.url
`
期望:https://github.com/ai-warden/openclaw-plugin
`bash
npm info openclaw-ai-warden dist.shasum
`
与本地对比:
`bash
cat node_modules/openclaw-ai-warden/package.json | grep _shasum
`
Step 3:复制插件文件到扩展根目录
OpenClaw 从扩展根目录加载插件,而非 node_modules。
`bash
cd ~/.openclaw/extensions/ai-warden
`
`bash
cp node_modules/openclaw-ai-warden/index.ts .
`
`bash
cp node_modules/openclaw-ai-warden/openclaw.plugin.json .
`
`bash
cp -r node_modules/openclaw-ai-warden/src .
`
`bash
grep VERSION index.ts | head -1
`
验证: 输出 const VERSION = 及版本号。 Step 4:配置 OpenClaw
自动向 openclaw.json 注册插件,保留原有配置(频道、模型、网关等)。
`bash
node -e "
const fs = require('fs');
const p = process.env.HOME + '/.openclaw/openclaw.json';
const cfg = JSON.parse(fs.readFileSync(p, 'utf8'));
if (!cfg.plugins) cfg.plugins = {};
cfg.plugins.enabled = true;
if (!cfg.plugins.entries) cfg.plugins.entries = {};
cfg.plugins.entries['ai-warden'] = {
enabled: true,
config: {
layers: {
content: 'block',
channel: 'warn',
preLlm: 'off',
toolArgs: 'block',
subagents: 'block',
output: 'off'
},
sensitivity: 'balanced'
}
};
fs.writeFileSync(p, JSON.stringify(cfg, null, 2));
console.log('CONFIG OK');
"
`
验证: 输出 CONFIG OK。 注意: 仅通过 plugins.entries 注册。若你使用 plugins.allow 白名单,需手动添加 "ai-warden";否则无需额外操作。
Step 5:添加 API 密钥(可选)
在线检测准确率 98.9%,离线约 60%。 方案 A —— 环境变量(推荐,密钥不写入配置文件):
在 shell profile 或 systemd 服务中设置 AI_WARDEN_API_KEY:
``bash
# 对于 systemd(如 OpenClaw 网关服务):
# 在 y