← Back to Skills Marketplace
Relay To Agent
by
Eric Santos
· GitHub ↗
· v0.0.1
2761
Downloads
6
Stars
13
Active Installs
2
Versions
Install in OpenClaw
/install relay-to-agent
Description
Relay messages to AI agents on any OpenAI-compatible API. Supports multi-turn conversations with session management. List agents, send messages, reset sessions.
Usage Guidance
This skill appears to do what it says: it sends messages to an OpenAI-compatible API and stores local session history. Before installing or running it: 1) Verify agents.json (or the RELAY_CONFIG path) to ensure baseUrl points to a trusted provider — your RELAY_API_KEY will be sent to that base URL. 2) Be aware that message contents are written to ~/.cache/relay-to-agent/sessions (up to 50 messages) — remove these files if you need to protect sensitive data. 3) If you run npm install to use the supplied package.json, review dependencies (package-lock.json shows openai-fetch and ky) and ensure node >= 18. 4) Avoid using high-privilege or production API keys with untrusted or unknown endpoints; prefer a scoped/test key. 5) If you want stronger guarantees, inspect agents.json for any unexpected agent entries and set RELAY_BASE_URL explicitly rather than relying on a bundled config. Overall there are no incoherent or suspicious requirements, but treat the configured endpoint and stored session data as the primary privacy risk.
Capability Analysis
Type: OpenClaw Skill
Name: relay-to-agent
Version: 0.0.1
The skill bundle is benign. It functions as a straightforward relay for messages to OpenAI-compatible AI agents, as described in its documentation. The `scripts/relay.mjs` script uses standard Node.js modules and the `openai-fetch` library to interact with external AI APIs, storing conversation sessions in a user's cache directory (`~/.cache/relay-to-agent/sessions`). There is no evidence of data exfiltration, unauthorized command execution, persistence mechanisms, or prompt injection attempts targeting the OpenClaw agent itself. The user's message is passed directly to the remote AI, which is the intended functionality for an AI interaction skill.
Capability Assessment
Purpose & Capability
Name/description, required binary (node), primary credential (RELAY_API_KEY), and the included script all align: the tool reads agents.json, calls an OpenAI-compatible base URL, and returns replies. No unrelated credentials or binaries are requested.
Instruction Scope
Runtime instructions and the script perform expected actions: they read agents.json (or RELAY_CONFIG), use RELAY_API_KEY and optional RELAY_BASE_URL, send chat completions to the configured endpoint, and persist up to 50 messages per agent+session under ~/.cache/relay-to-agent/sessions. Note: user content is written to disk (session files) and transmitted to the configured remote endpoint — verify that endpoint is trusted for sensitive content.
Install Mechanism
This is instruction-only (no install spec). A node script and package.json/package-lock are included; there is no automated download-from-URL or other high-risk installer. Running it may require doing an npm install locally; the declared dependency (openai-fetch) is reasonable for the stated purpose.
Credentials
Only RELAY_API_KEY is required as the primary secret; optional RELAY_BASE_URL and RELAY_CONFIG are documented. The requested env vars are proportional and justified by the skill's function.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or system-wide settings. It stores session data under the user's home directory (~/.cache/relay-to-agent/sessions), which is expected for multi-turn state; this is a moderate local persistence but scoped to the user's home.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install relay-to-agent - After installation, invoke the skill by name or use
/relay-to-agent - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.1
Initial release of relay-to-agent.
- Added support for relaying messages to AI agents on any OpenAI-compatible API.
- Supports multi-turn conversations with session management.
- Includes script to list available agents, send messages, and reset sessions.
- Configuration via agents.json and environment variables.
- Compatible with Connect Chat, OpenRouter, LiteLLM, vLLM, Ollama, and other OpenAI-compatible services.
v1.0.0
Initial release: OpenAI-compatible agent relay with multi-turn sessions, configurable agents.json, works with Connect Chat, OpenRouter, LiteLLM, vLLM, Ollama
Metadata
Frequently Asked Questions
What is Relay To Agent?
Relay messages to AI agents on any OpenAI-compatible API. Supports multi-turn conversations with session management. List agents, send messages, reset sessions. It is an AI Agent Skill for Claude Code / OpenClaw, with 2761 downloads so far.
How do I install Relay To Agent?
Run "/install relay-to-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Relay To Agent free?
Yes, Relay To Agent is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Relay To Agent support?
Relay To Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Relay To Agent?
It is built and maintained by Eric Santos (@ericsantos); the current version is v0.0.1.
More Skills