（3395期）Mirage Proxy – LLM 请求的本地透明脱敏网关

LLM 请求的本地透明脱敏网关 本地透明代理层，自动识别并脱敏 LLM 请求中的 PII/密钥，支持多模型路由与自动保活，降低敏感数据泄露风险。 使用说明 核心用法 mirage-proxy 是部署在 OpenClaw 与 LLM 提供商之间的透明代理层，主要功能是在请求 outbound 阶段自动识别并替换敏感信息（PII、密钥、凭证等）为可信假值，使原始数据永不离开本地环境。 典型配置流程： 执行 setup.sh 一键安装二进制、创建自启脚本并启动代理 在 OpenClaw 配置中新增 mirage-* Provider，将 baseUrl 指向本地代理端口（默认 8686） 通过 /model 切换直连或代理路由，实现即时回退能力 配置 Docker entrypoint 或 Heartbeat 检测，确保代理在容器重启后自动恢复 多厂商支持：目前适配 Anthropic（API Key 模式）与 OpenAI/Codex（OAuth 模式），通过不同的 Provider 配置策略区分。 显著优点 | 维度 | 说明 ||------|------|| 零侵入 | 无需修改业务代码或 Prompt，对 LLM 调用方完全透明 || 实时脱敏 | 基于模式匹配与启发式规则，动态替换密钥、邮箱、信用卡号等敏感实体 || 多路由并存 | 支持同一模型同时配置直连与代理版本，按场景灵活切换 || 轻量自托管 | 单二进制文件，本地监听，无外网依赖，日志留存本地 || 自动保活 | 提供 entrypoint 脚本与 Heartbeat 两种机制，对抗容器生命周期波动 | 潜在缺点与局限性 识别覆盖率：依赖内置规则集，新型密钥格式或定制 PII 可能漏检 语义破坏风险：过度脱敏可能导致 LLM 理解上下文偏差（如替换后假值不符合业务逻辑） 运维复杂度：额外引入本地服务依赖，需监控 8686 端口健康状态 性能损耗：请求需经本地代理转发，增加 ~10-50ms 延迟（视规则复杂度） 单点故障：代理崩溃将导致所有路由至 mirage 的模型调用失败，需配合 fallback 配置 适合人群 企业开发团队需满足数据合规（GDPR、SOC 2）要求 使用 OpenClaw 处理含敏感代码/日志的场景 希望在不改造现有 Prompt 的前提下快速增强数据安全的个人开发者 常规风险 | 风险类型 | 描述 | 缓解建议 ||----------|------|----------|| 假值泄露 | 脱敏后的假值若被 LLM 记忆，可能反向暴露原始数据模式 | 定期轮换假值生成策略 || 配置漂移 | 手动维护 Provider JSON 易出错，导致代理绕过 | 将配置纳入 GitOps 流程 || 日志残留 | 代理日志可能记录脱敏前的敏感片段 | 配置日志滚动与敏感字段二次过滤 || 端口冲突 | 8686 端口被占用导致启动失败 | 启动前检查端口占用，预留备用端口 | --- 认证状态说明：本简介基于提供的技能文档生成，未执行动态安全扫描。实际部署前建议在隔离环境验证脱敏规则覆盖度与性能表现。 原始说明 Install and configure mirage-proxy as a transparent PII/secrets filter for OpenClaw LLM API calls. Handles binary installation, provider config, auto-restart...