中继平面

OpenRouter的路由服务。中继平面负责观察、治理与学习。

专为OpenClaw高级用户设计的智能体运维工具。您的智能体每次会话会发起数百次API调用——中继平面为您提供对所有调用的可见性、成本控制与治理能力。

核心功能

中继平面是可选的优化层它部署在智能体的请求管道中，能够将简单任务路由至更经济的模型、执行预算控制并记录所有日志——若出现任何故障，系统会自动回退至直接调用服务提供商。

关键原则：中继平面永不成为系统依赖项。即使代理服务中断，您的智能体仍将持续运行。确保零停机时间。

安装指南

npm install -g @relayplane/proxy@latest

快速开始

# 1. Start the proxy (runs on localhost:4100 by default)
relayplane-proxy

# 2. Add to your openclaw.json:
#    { "relayplane": { "enabled": true } }

# 3. That's it. OpenClaw routes through RelayPlane when healthy,
#    falls back to direct provider calls automatically.

⚠️ 重要提示：请勿设置BASE_URL

绝对不要这样做：

# ❌ WRONG — hijacks ALL traffic, breaks OpenClaw if proxy dies
export ANTHROPIC_BASE_URL=http://localhost:4100

请改用配置方案：

// ✅ RIGHT — openclaw.json
{
  "relayplane": {
    "enabled": true
  }
}

配置方案采用熔断机制——若代理服务中断，流量将直接传输。而BASE_URL方案不具备故障回退能力，可能导致整个系统瘫痪。

架构

Agent → OpenClaw Gateway → Circuit Breaker → RelayPlane Proxy → Provider
                                   ↓ (on failure)
                              Direct to Provider

• 断路器：连续3次失败 → 代理被绕过30秒
• 自动恢复：健康探针检测代理何时恢复
• 进程管理：网关可自动生成/管理代理

配置

最小配置（其他均使用默认值）：

{
  "relayplane": {
    "enabled": true
  }
}

完整选项：

{
  "relayplane": {
    "enabled": true,
    "proxyUrl": "http://127.0.0.1:4100",
    "autoStart": true,
    "circuitBreaker": {
      "failureThreshold": 3,
      "resetTimeoutMs": 30000,
      "requestTimeoutMs": 3000
    }
  }
}

命令

程序化使用 (v1.3.0+)

import { RelayPlaneMiddleware, resolveConfig } from '@relayplane/proxy';

const config = resolveConfig({ enabled: true });
const middleware = new RelayPlaneMiddleware(config);

// Route a request — tries proxy, falls back to direct
const response = await middleware.route(request, directSend);

// Check status
const status = middleware.getStatus();
console.log(middleware.formatStatus());

进阶：完整智能体运维代理

import { createSandboxedProxyServer } from '@relayplane/proxy';

const { server, middleware } = createSandboxedProxyServer({
  enableLearning: true,    // Enable pattern detection
  enforcePolicies: true,   // Enforce budget/model policies
  relayplane: { enabled: true },  // Circuit breaker wrapping
});

await server.start();
// All three pillars active: Observes + Governs + Learns
// Circuit breaker protects against proxy failures

v1.4.0 版本新特性

三大支柱 —— 全面集成：

• 观察（学习账本）—— 捕获每次运行，实现完整的决策可解释性
• 治理（策略引擎）—— 预算上限、模型许可列表、审批关卡
• 学习（学习引擎）—— 模式检测、成本建议、规则管理

沙盒架构 (v1.3.0+)：

• 熔断器—— 自动故障转移，杜绝系统中断
• 进程管理器—— 代理以受管子进程运行
• 健康探针—— 主动恢复检测
• 统计与可观测性—— p50/p95/p99 延迟、请求计数、熔断器状态

学习引擎端点 (v1.4.0)：

• GET /v1/analytics/summary— 带日期范围的分析功能
• POST /v1/analytics/analyze— 检测模式、异常，生成建议
• GET /v1/suggestions— 列出待处理建议
• POST /v1/suggestions/:id/approve/ 拒绝— 建议工作流
• GET /v1/rules— 活跃规则
• GET /v1/rules/:id/effectiveness— 此规则是否有帮助？

隐私

• 您的提示词保留在本地— 从不发送至 RelayPlane 服务器
• 匿名遥测数据— 仅包含令牌数量、延迟、所用模型
• 随时选择退出—relayplane-proxy telemetry off
• 完全离线模式—relayplane-proxy --offline

链接

• 文档： https://relayplane.com/docs
• GitHub： https://github.com/RelayPlane/proxy
• npm： https://www.npmjs.com/package/@relayplane/proxy