AI代理消息中继

技能简介

relay-to-agent 是一个命令行工具，用于向任何兼容 OpenAI Chat Completions API 的端点发送消息。支持与多种 AI 服务对接，包括 Connect Chat、OpenRouter、LiteLLM、vLLM、Ollama 等，实现与远程 AI 代理的多轮对话。

业务背景

为开发团队提供统一的AI服务接入层。通过单一命令行工具对接多种OpenAI兼容端点，避免为不同AI平台维护多套集成代码，简化远程代理调用与会话管理。

落地案例：开发人员需要测试多个AI模型效果，在agents.json中配置Connect Chat、OpenRouter等端点后，使用同一命令向不同代理发送相同提示词，工具自动保留对话上下文，支持快速切换对比各平台响应质量。

能做什么

• 列出配置文件中所有可用的 AI 代理
• 向指定代理发送单条或连续消息
• 自动维护对话上下文，支持多轮交互
• 重置会话状态，开始新的对话
• 使用自定义会话 ID 进行并行多会话

使用说明

安装要求：需要 Node.js 环境，通过 npm 或直接下载脚本使用。

配置步骤：

1. 创建 agents.json 配置文件，设置 baseUrl 和代理列表
2. 设置环境变量 RELAY_API_KEY（必需）
3. 可选：设置 RELAY_BASE_URL 覆盖配置中的地址，或 RELAY_CONFIG 指定自定义配置路径

常用命令：

# 列出可用代理
node {baseDir}/scripts/relay.mjs --list

# 发送消息
node {baseDir}/scripts/relay.mjs --agent 代理ID "消息内容"

# 继续同一会话的对话
node {baseDir}/scripts/relay.mjs --agent 代理ID "后续消息"

# 重置会话后发送
node {baseDir}/scripts/relay.mjs --agent 代理ID --reset "新话题"

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥以环境变量形式存储，注意避免泄露到日志或版本控制
• 会话数据本地存储于 ~/.cache/relay-to-agent/sessions/，多用户环境需注意权限隔离
• 每条会话保留最近 50 条消息，超出部分自动丢弃
• 依赖外部 API 可用性，网络中断会导致请求失败

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ericsantos/relay-to-agent/SKILL.md
来源类型：GitHub 开源项目