← Back to Skills Marketplace
RelayPlane
by
RelayPlane
· GitHub ↗
· v4.1.0
· MIT-0
2812
Downloads
5
Stars
4
Active Installs
13
Versions
Install in OpenClaw
/install relayplane
Description
Agent ops layer for OpenClaw — observability, governance, and cost optimization with automatic failover. Never breaks your setup.
Usage Guidance
Before installing or enabling this skill: 1) Do not blindly run `npm install -g` for packages you haven't audited — review the package source on the linked GitHub and the published npm package contents. 2) Clarify the README vs SKILL.md contradiction about setting provider BASE_URL env vars — if you point provider base URLs at a local proxy without a circuit-breaker, you risk a single point of failure and having all prompts routed through that process. 3) Confirm the telemetry defaults: test `relayplane-proxy --offline` or `telemetry off` before sending traffic to it, and verify what anonymous metrics are actually transmitted. 4) Ask the maintainer to reconcile the registry metadata vs SKILL.md (is model invocation disabled or allowed?). 5) If you proceed, run the CLI in an isolated environment (container or VM) and validate its behavior (circuit-breaker/fallback to direct provider) before enabling it for production agents.
Capability Analysis
Type: OpenClaw Skill
Name: relayplane
Version: 4.1.0
The skill bundle is an 'instruction-only' package that directs users and agents to install and route all LLM traffic through a third-party proxy (@relayplane/proxy). It contains a significant internal contradiction: SKILL.md explicitly warns that setting BASE_URL environment variables 'hijacks' traffic and is 'WRONG', yet the README.md recommends this exact method in its 'Quick Start' section. Furthermore, the metadata and changelog contain future-dated timestamps (2026), and the requirement to install global npm packages to intercept sensitive API traffic and prompts presents a high-risk profile without verifiable intent.
Capability Assessment
Purpose & Capability
The skill claims to be an optional local proxy that routes and governs LLM calls — that reasonably explains the npm CLI and proxy commands in SKILL.md. However, README.md and SKILL.md give inconsistent guidance (README recommends setting provider BASE_URL env variables to point at the proxy; SKILL.md explicitly warns against doing that). Also the registry metadata flags (model-invocable/defaults) differ from SKILL.md's internal metadata. These inconsistencies make it unclear which behavior the skill actually expects from an integrator.
Instruction Scope
SKILL.md asks you to install and run a global npm package and to run a local proxy which will receive agent traffic. The README explicitly shows examples that would 'hijack' all traffic by setting provider BASE_URL envs — a configuration the SKILL.md warns against. That contradiction is important: one configuration (env exports) will route all traffic through the proxy without an OpenClaw circuit-breaker/fallback and could cause a single point of failure or unexpected interception of all prompts. The instructions also describe process management and automatic spawning, but as an instruction-only skill there's nothing in the registry to verify how that integration is implemented.
Install Mechanism
There is no registry install spec, but SKILL.md instructs users to run `npm install -g @relayplane/proxy`. Installing a third-party global npm CLI is a normal delivery mechanism for a proxy/CLI but is moderate risk because it executes arbitrary code from npm. The skill provides links (npm, GitHub, docs), so you can inspect the package sources, but the registry itself does not include code to audit.
Credentials
The registry declares no required env vars or credentials, yet README and SKILL.md reference provider API keys and (contradictory) base URL environment variables (e.g., ANTHROPIC_BASE_URL, OPENAI_BASE_URL). The SKILL.md warns not to set BASE_URL envs, while the README demonstrates doing exactly that — this mismatch may lead users to accidentally configure the proxy in a way that intercepts all traffic or disables fallback behavior. Telemetry is mentioned (opt-out and --offline flags) but no explicit explanation of what anonymous data is sent is present.
Persistence & Privilege
Registry-level flags say model invocation is allowed by default, but SKILL.md metadata sets disableModelInvocation: true (not model-invocable). This mismatch is important: if the skill or CLI can be invoked autonomously (or run as a background process), it increases blast radius. The skill itself recommends installing a global CLI and a managed proxy which could run as a long-lived local process and optionally send telemetry. Those behaviors are expected for a proxy but should be clearly documented and controlled; the current docs are inconsistent about autonomous invocation and safe defaults.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install relayplane - After installation, invoke the skill by name or use
/relayplane - Provide required inputs per the skill's parameter spec and get structured output
Version History
v4.1.0
v4.1: Budget enforcement, anomaly detection, per-subreddit voice defaults, x402 proxy, updated install commands, current proof points
v3.4.0
- Bumped version to 3.4.0.
- No user-facing changes; documentation updated only.
v3.3.0
- Added cloud telemetry support: every install now contributes to smarter routing for all users.
- Updated introduction to highlight collaborative telemetry benefits.
- No changes to commands, configuration, privacy, or usage.
v3.2.0
- Added instructions for creating a free account to access a savings dashboard and personalized stats.
- Introduced support for the RELAYPLANE_API_KEY environment variable.
- Highlighted Pro features including network-optimized routing, budget alerts, and provider health monitoring.
- Updated privacy section to mention how anonymous telemetry improves routing for everyone.
- Clarified that the proxy works without an account.
v3.1.0
Copy refresh: dollar-anchored messaging, social proof (835+ installs), break-even math, aligned with new site copy
v3.0.0
Convert to instruction-only skill - no code execution, just documentation for npm package
v2.3.2
Add RELAYPLANE_OFFLINE to declared env vars for scanner compliance
v2.3.1
Update description to lead with cost savings value prop
v2.3.0
Address security scan concerns: add requiredBins, explicit model-invocation settings with rationale, detailed env/network/telemetry purposes
v2.2.0
Add explicit env/network/telemetry declarations for security scan compliance
v2.1.0
Add doctor and proxy commands, model aliases table, dual CLI support
v0.1.11
- SKILL.md documentation was streamlined for clarity and conciseness.
- Redundant and verbose sections were removed to improve readability.
- REST endpoint details and configuration instructions remain, but are simplified.
- All key features, supported providers, commands, and troubleshooting steps are still covered.
- Links section consolidated for easy reference.
v0.1.10
RelayPlane proxy v1.0.0: Major documentation update and feature overview
- Added a comprehensive SKILL.md with full setup instructions, routing modes, supported providers, commands, configuration examples, REST endpoints, and troubleshooting tips.
- Clarified proxy requirements, cost-saving claims, and restrictions for MAX subscription users.
- Detailed how to set up API keys, run the proxy, and configure client tools.
- Listed all available routing modes and supported LLM providers.
- Included local data storage and access instructions.
- Provided links to GitHub, docs, and npm for further reference.
Metadata
Frequently Asked Questions
What is RelayPlane?
Agent ops layer for OpenClaw — observability, governance, and cost optimization with automatic failover. Never breaks your setup. It is an AI Agent Skill for Claude Code / OpenClaw, with 2812 downloads so far.
How do I install RelayPlane?
Run "/install relayplane" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is RelayPlane free?
Yes, RelayPlane is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does RelayPlane support?
RelayPlane is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created RelayPlane?
It is built and maintained by RelayPlane (@relayplane); the current version is v4.1.0.
More Skills