RelayShield MCP Proxy Firewall

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install relayshield-mcp-firewall
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 relayshield-mcp-firewall。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

RelayShield MCP Proxy Firewall 在 Openclaw、mcporter 和上游 MCP 服务器之间添加了一个运行时安全层。它根据包含 700,000 多个指标的威胁情报库审查工具定义、调用参数和返回的结果。
该代理有助于检测投毒工具、提示词注入、凭据外泄、钓鱼工具包指纹、可疑 URL 以及异常的工具行为。干净的流量将被转发到上游，而可疑活动可以通过标准的 MCP 错误响应和审计记录被阻止或隔离。作为 Openclaw Skills 的一部分，它提供实用的 MCP 防火墙保护，而无需更改代理的常规工具工作流。

应用场景

保护 OpenClaw 代理免受投毒的 MCP 工具定义和恶意相邻工具的侵害。
根据 RelayShield 威胁情报审查工具调用 URL、域和 IP 地址。
检测工具结果中的提示词注入、指令劫持、秘密暴露、钓鱼指纹和凭据外泄。
通过行为检测监控异常调用序列、流量激增和跨工具攻击链。
通过在代理层管理它们，将上游授权标头排除在 mcporter 和代理配置之外。
在部署前预先扫描 MCP 服务器，以识别危险功能和可疑工具元数据。
使用可选的 YAML 策略文件针对每个代理、工具或服务器应用声明式允许和拒绝规则。
为评估侧重安全性的 Openclaw Skills 的团队提供本地审查边界。

工作原理

克隆 RelayShield 仓库并安装所需的运行时依赖项。
可选：针对上游 MCP 服务器运行离线工具扫描器，以在部署前识别提示词注入、外泄模式、凭据参数和危险功能。
为上游 MCP 服务器启动一个 RelayShield 代理实例，配置上游 URL、监听端口、审查行为、阻止级别和可选的 API key。
在 mcporter 中注册本地代理 URL，而不是直接连接到上游 MCP 服务器。
OpenClaw 通过 mcporter 将 MCP 流量发送到 RelayShield 代理，该代理提取并评估工具调用中的指标并审查返回的内容。
代理将干净的请求和结果转发到上游，而可疑活动会被阻止或隔离，并带有诸如错误 -32001 的标准 MCP 错误响应。
行为检测将代理活动与基线进行比较，以识别异常序列、流量激增和多工具攻击链。
每个策略决策都会进行审计记录；审查超时会放行，同时记录超时。
使用仪表板演示验证审查是否处于活动状态，并查看判决置信度得分和原因代码。

配置指南

前提条件
Python 3.10 或更新版本
mcporter
克隆的 RelayShield 仓库
上游 MCP 服务器 URL
安装 mcporter 并克隆 RelayShield：
npm install -g mcporter
git clone https://github.com/nzdsf2-gif/relayshield.git

1. 预扫描上游服务器 在路由生产流量之前运行推荐的离线扫描器：
   cd relayshield
   python3 -m mcp_proxy.tool_scanner --url https://your-mcp-server.example.com/mcp
   在启用运行时代理之前，审查并修复报告的问题。
2. 启动 RelayShield 代理 cd relayshield
   export MCP_PROXY_UPSTREAM="https://your-mcp-server.example.com/mcp"
   export MCP_PROXY_PORT="8090"
   python3 -m mcp_proxy
   代理监听端口 8090。每个上游服务器配置一个代理实例，每个实例使用单独的端口。
3. 配置 mcporter 注册本地代理而不是上游端点：
   mcporter config add myserver http://127.0.0.1:8090 --scope home
   mcporter list myserver
   如果上游需要授权，请在代理环境或策略文件中配置其静态标头。mcporter 连接到本地代理时无需上游身份验证。
4. 验证审查 运行交互式、无网络的演示：
   python3 -m mcp_proxy.dashboard --demo
   打开 http://127.0.0.1:8091/_rs/dashboard 并审查攻击场景，包括投毒邻居和钓鱼工具包案例。
   配置变量
   MCP_PROXY_UPSTREAM：必需的上游 MCP 服务器 URL。
   MCP_PROXY_PORT：本地代理端口；默认为 8090。
   MCP_PROXY_SCREENING：主威胁情报审查开关；默认为 true。
   MCP_PROXY_BLOCK_LEVELS：阻止的判决级别；默认为 high,medium。
   MCP_PROXY_RESULT_SCREENING：启用结果审查；默认为 true。
   MCP_PROXY_BEHAVIOR：启用行为异常检测；默认为 true。
   RELAYSHIELD_API_KEY：用于更深入缓存检查的可选 key。
   Stdio MCP 服务器无法通过 HTTP 代理。对于这些服务器，请使用部署前扫描器和 OpenClaw 批准钩子。
   RelayShield MCP Proxy Firewall 数据架构与分类体系
   流量与决策模型
   数据区域 评估内容 结果或操作
   工具定义 提示词注入、指令劫持、外泄模式、凭据参数和危险功能 部署前扫描器发现
   工具调用 从参数中提取的 URL、域和 IP 地址 转发、阻止或返回 MCP 错误 -32001
   工具结果 提示词注入、机密材料、钓鱼工具包指纹、未脱敏的 PII 以及面向非身份提供商基础架构的凭据外泄 审查的结果、阻止、隔离或审计事件
   代理行为 调用序列、流量激增和跨工具攻击链 行为异常判决
   策略规则 按代理、工具和服务器分类的可选 YAML 允许和拒绝规则 带有审计记录的声明式决策
   生成的和引用的资源
   代理端点： 本地 HTTP 监听器，通常为 http://127.0.0.1:8090，转发到配置的 MCP_PROXY_UPSTREAM。
   仪表板端点： 位于 http://127.0.0.1:8091/rs/dashboard 的本地演示仪表板。
   MCP 响应： 可疑调用可以产生标准的 MCP 错误响应，包括错误代码 -32001。
   威胁情报元数据： 判决可以包括置信度得分和识别触发信号的原因代码。
   审计元数据： 记录审查和策略决策以供审查。
   环境配置： 通过 MCP_PROXY* 变量和可选的 RELAYSHIELD_API_KEY 控制运行时行为。
   策略分类： 可选的 YAML 规则可以针对单个代理、MCP 工具或上游服务器。
   代理不将结果认证为安全；未标记的结果仅意味着未发现配置的信号。审查超时将被记录，并根据记录的行为放行。

高级特性

以包含 700,000 多个指标的语料库为后盾的威胁情报审查。
对工具调用和工具结果的双层检查，而不仅仅是调用。
使用每个代理活动基线的行为异常检测。
范围限定为代理、工具和服务器的声明式 YAML 允许和拒绝策略。
支持可选的 RelayShield API key 以进行更深入的缓存检查。
用于解释被阻止的演示场景和审查判决的置信度得分和原因代码。
用于策略和审查决策的审计日志。
针对多个上游 MCP 服务器的独立代理实例和端口。
具有 14 个攻击场景的本地交互式仪表板，用于验证完整的 OpenClaw 到上游链。
带有显式超时日志的放行超时处理，允许运营商监控可用性和安全性权衡。
兼容无法通过 HTTP 代理的 stdio MCP 服务器的 OpenClaw 批准钩子。

name: relayshield-mcp-firewall description: Route OpenClaw MCP traffic through the RelayShield Proxy Firewall, screening every tool call and tool result against threat intelligence before it reaches your agent. auto-activate: false
triggers: [mcp firewall, relayshield, tool screening, mcporter proxy, poisoned tools]