Relay To Agent

通过 node 脚本把消息转发到任意 OpenAI 兼容 Chat Completions 端点，支持列出 agent、指定会话维持多轮上下文、重置会话与 JSON 输出；消息及历史会发送到所配置的第三方端点，会话记录明文存于本地缓存，需自备 RELAY_API_KEY。

ericsantos

热度 73.37

最近更新 2026-07-04 23:18:04

分类：自动化依赖：代码执行 / 第三方 API / 读写文件 / 内部调用大模型应用场景：API 集成 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add relay-to-agent

Metadata

name: 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.
homepage: https://platform.openai.com/docs/api-reference/chat
metadata: {"clawdbot":{"emoji":"🤖","requires":{"bins":["node"]},"primaryEnv":"RELAY_API_KEY"}}

Relay To Agent

Send messages to AI agents on any OpenAI-compatible endpoint. Works with Connect Chat, OpenRouter, LiteLLM, vLLM, Ollama, and any service implementing the Chat Completions API.

List available agents

node {baseDir}/scripts/relay.mjs --list

Send a message to an agent

node {baseDir}/scripts/relay.mjs --agent linkedin-alchemist "Transform this article into a LinkedIn post"

Multi-turn conversation

# First message
node {baseDir}/scripts/relay.mjs --agent connect-flow-ai "Analyze our latest campaign"

# Follow-up (same session, agent remembers context)
node {baseDir}/scripts/relay.mjs --agent connect-flow-ai "Compare with last month"

Reset session

node {baseDir}/scripts/relay.mjs --agent linkedin-alchemist --reset "Start fresh with this article..."

Options

Flag	Description	Default
`--agent ID`	Target agent identifier	(required)
`--reset`	Reset conversation before sending	off
`--list`	List available agents	—
`--session ID`	Custom session identifier	`default`
`--json`	Raw JSON output	off

Configuration

agents.json

Configure agents and endpoint in {baseDir}/agents.json:

{
  "baseUrl": "https://api.example.com/v1",
  "agents": [
    {
      "id": "my-agent",
      "name": "My Agent",
      "description": "What this agent does",
      "model": "model-id-on-the-api"
    }
  ]
}

Environment variables

export RELAY_API_KEY="sk-..."          # API key (required)
export RELAY_BASE_URL="https://..."    # Override base URL from config
export RELAY_CONFIG="/path/to/agents.json"  # Custom config path

Compatible Services

Connect Chat — api.connectchat.ai/api
OpenRouter — openrouter.ai/api/v1
LiteLLM — localhost:4000/v1
vLLM — localhost:8000/v1
Ollama — localhost:11434/v1
Any OpenAI-compatible API

Session Management

Sessions are stored locally at ~/.cache/relay-to-agent/sessions/. Each agent+session combination keeps up to 50 messages. Use --session for parallel conversations with the same agent.

--agent and --session values are restricted to [A-Za-z0-9._-]; path separators and .. are rejected so session files stay inside the cache directory.

Privacy Notice

This skill is a relay: each message you send — plus prior session history — is transmitted to the configured OpenAI-compatible endpoint (baseUrl / RELAY_BASE_URL), which may be a third-party service. Conversation transcripts (up to 50 messages per session) are also persisted in plaintext on disk at ~/.cache/relay-to-agent/sessions/.

Do not send secrets, credentials, or regulated/sensitive data unless you trust the endpoint and control the machine.
Use --reset to clear a session before sending, or delete files under the cache dir to remove stored history.
Point baseUrl/RELAY_BASE_URL only at endpoints you trust.