核心用法
mirage-proxy 是部署在 OpenClaw 与 LLM 提供商之间的透明代理层，主要功能是在请求 outbound 阶段自动识别并替换敏感信息（PII、密钥、凭证等）为可信假值，使原始数据永不离开本地环境。
典型配置流程：
1. 执行 setup.sh 一键安装二进制、创建自启脚本并启动代理
2. 在 OpenClaw 配置中新增 mirage-* Provider，将 baseUrl 指向本地代理端口（默认 8686）
3. 通过 /model 切换直连或代理路由，实现即时回退能力
4. 配置 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 端口被占用导致启动失败 | 启动前检查端口占用，预留备用端口 |
---
> 认证状态说明：本简介基于提供的技能文档生成，未执行动态安全扫描。实际部署前建议在隔离环境验证脱敏规则覆盖度与性能表现。