RelayPlane

核心用法

RelayPlane 作为 OpenClaw 的可选优化中间件，部署在代理请求链路中，主要提供三大能力：

1. Observes（可观测性） — Learning Ledger 记录每次调用，支持完整决策追溯
2. Governs（治理管控） — Policy Engine 实现预算上限、模型白名单、审批门禁
3. Learns（智能学习） — Learning Engine 检测调用模式，自动生成成本优化建议

安装后通过 relayplane-proxy 启动本地服务（默认 4100 端口），在 openclaw.json 中启用即可。关键设计：断路器模式（Circuit Breaker） — 连续 3 次失败自动绕过代理直连提供商，30 秒后健康探测恢复，确保代理永不依赖 RelayPlane。

显著优点

• 零依赖保障：代理始终可用，proxy 宕机不影响业务
• 成本智能优化：自动将简单任务路由至 cheaper models
• 企业级治理：预算控制、模型审批、完整审计日志
• 隐私优先：提示词本地处理，仅上报匿名 token 计数

潜在局限

• 额外运维节点：需本地运行 proxy 服务，增加架构复杂度
• 学习曲线：Policy Engine 和 Learning Engine 配置需理解规则体系
• 生态绑定：专为 OpenClaw 设计，通用性受限
• 版本迭代快：v1.4.0 功能快速演进，文档可能滞后

适合人群

• 高频调用 LLM 的 OpenClaw 重度用户
• 需要精细化成本管控的企业 AI 团队
• 追求高可用、需自动故障转移的生产环境

常规风险

• 配置误用风险：错误设置 BASE_URL 环境变量会导致全流量劫持，破坏断路器机制
• 本地服务单点：虽有无代理 fallback，但 proxy 本身可能成为性能瓶颈
• 隐私合规：匿名 telemetry 虽可 opt-out，但企业仍需评估数据出境合规性

核心用法

RelayPlane 是 OpenClaw 的可选优化中间件，通过本地代理服务器（localhost:4100）拦截并优化 AI 模型调用。用户通过 openclaw.json 配置启用，无需修改环境变量即可享受智能路由。

关键配置原则：必须使用 JSON 配置 { "relayplane": { "enabled": true } }，而非直接设置 BASE_URL 环境变量。后者会劫持全部流量且无故障转移能力，可能导致系统级中断。

典型工作流：
1. npm install -g @relayplane/proxy 安装代理
2. relayplane-proxy 启动本地服务
3. 配置启用后，OpenClaw 网关自动实现「代理健康时走优化路径，故障时直连供应商」的双轨机制

显著优点

零依赖韧性：电路断路器（Circuit Breaker）设计是最大亮点——3 次连续失败后自动绕过代理 30 秒，并持续健康探测自动恢复。这种「代理即服务、非代理即依赖」的架构哲学，从根本上消除了单点故障风险。

成本与治理：Learning Engine 自动检测调用模式，建议更便宜的模型替代方案；Policy Engine 支持预算硬上限、模型白名单和审批门禁。对于高频 Agent 场景（单会话数百次 API 调用），成本优化空间显著。

隐私优先设计：提示内容完全本地处理，仅上报匿名遥测（Token 计数、延迟、模型类型），支持完全离线模式 --offline，符合 GDPR/CCPA 数据最小化原则。

潜在局限

运维复杂度：需要额外维护一个 Node.js 常驻进程（代理服务器），对纯 Python 或无 Node 环境的团队引入技术栈负担。autoStart: true 虽能自动启停，但仍需理解进程生命周期。

功能边界：v4.1.0 版本 SKILL 本身为纯 Markdown 文档，无可执行代码，所有功能依赖用户手动执行 CLI。这种「文档型 Skill」设计虽安全，但也意味着 Agent 无法自主完成安装、配置、故障排查等闭环操作。

网络拓扑限制：本地代理模式假设用户环境可运行常驻服务，在 Serverless、容器化或权限受限的企业环境中可能受限。

适合人群

• OpenClaw 重度用户：日调用量 >1000 次、多 Agent 协作场景的成本敏感型团队
• AI 运维工程师：需要可观测性（p50/p95/p99 延迟、请求追踪）和治理合规的企业
• 本地优先隐私倡导者：要求提示数据不出境、完全可控的数据主权场景

常规风险

配置误用风险：文档反复强调「不要设置 BASE_URL」，但用户若忽略此警告，将导致硬依赖代理、故障时全局瘫痪。建议结合 openclaw doctor 等工具做前置校验。

版本漂移风险：Skill 版本（v4.1.0）与代理 npm 包版本（文档提及 v1.3.0/v1.4.0）存在表述不一致，升级时需确认兼容性。

本地服务安全：虽代理默认绑定 localhost，但若用户手动改为 0.0.0.0 或部署在共享环境，可能暴露未授权访问面。