Remote Agent Server Vibe 项目

项目简介

Remote Agent Server 是一个开源项目，旨在将 Claude Code、Codex 和 Hermes 等主流 Agent 接入已有的工单系统、运维平台和内部业务系统。业务系统负责派发任务，Agent 负责执行执行，结果再回到业务流程中。项目采用 MIT 开源协议，支持 macOS（APFS）和 Linux（Btrfs）自托管部署，适合需要在业务流程中集成 AI 编程能力的企业和开发者。

核心功能

• HTTP API 任务接入：通过 RESTful API 提交任务、日志或附件，Agent 在预先准备好的项目环境中执行
• 多种结果获取方式：支持主动查询轮询、SSE 实时事件推送和带签名验证的 Webhook 回调三种结果获取机制
• 连续对话上下文保持：同一会话支持补充信息、继续追问，保留完整的处理上下文
• 统一执行管理：内置任务排队机制、独立的会话工作区、完整执行记录和并发控制
• Skills 与 MCP 工具支持：通过 acpx/ACP 协议与 Agent 通信，支持为每个 Agent 配置 Skills 和 MCP 工具扩展能力
• 多 Agent 支持：目前支持 Claude Code、Codex 和 Hermes，未来计划持续接入更多 Agent
• 自托管部署：可完全部署在自有服务器，数据不经过第三方，保障业务隐私

技术实现

Remote Agent Server 的核心架构分为三层：业务接入层、执行管理层和 Agent 通信层。

业务接入层通过 HTTP API 接收业务系统发来的任务请求，支持 JSON 格式的任务描述和附件上传。任务进入执行管理层后，系统为每个任务分配独立的会话工作区，确保不同任务之间的环境隔离。执行管理层内置任务队列，支持优先级设置和并发控制，避免同一 Agent 实例被过度调用。

Agent 通信层通过 acpx/ACP 协议与 Claude Code、Codex 等 Agent 建立连接。该协议支持主动事件推送，使业务系统可以实时获取 Agent 的执行状态、日志输出和中间结果。同时，协议支持 Webhook 签名验证，确保回调来源的真实性。

在存储方面，项目利用文件系统作为任务工作区，macOS 上使用 APFS 的快照能力实现环境隔离，Linux 上使用 Btrfs 的子卷机制实现类似效果。每次任务执行后生成完整的执行记录，包含输入、输出、日志时间戳，可用于审计和问题追溯。

快速上手

• 步骤一：环境准备 确认系统环境为 macOS（APFS）或 Linux（Btrfs），安装 Node.js 18+ 环境，克隆项目仓库并执行 npm install 安装依赖

• 步骤二：配置 Agent 在 config.yaml 中配置要接入的 Agent 类型（Claude Code / Codex / Hermes），填入对应的 API Key 或访问令牌，设置 Agent 的工作目录和默认项目路径

• 步骤三：启动服务 执行 npm start 启动 Remote Agent Server，服务默认监听 3000 端口，通过 POST /api/tasks 接口接收任务

• 步骤四：提交第一个任务 向 POST /api/tasks 发送任务请求，包含任务描述、工作环境路径和期望结果格式，通过 SSE 或 Webhook 接收执行结果

• 步骤五：接入现有系统 将任务触发和结果处理接入工单系统或运维平台的现有流程，通过 Webhook 将 Agent 执行结果写回业务数据库或通知相关人员

适用人群

• 需要在 CI/CD 流水线中集成 AI 编程能力的 DevOps 团队
• 希望用 AI Agent 自动化处理工单的技术支持团队
• 需要将 Claude Code / Codex 能力嵌入内部管理系统的企业开发者
• 研究 AI Agent 与业务系统集成方案的技术团队
• 运维平台希望引入 AI 辅助故障排查和修复的 SRE 工程师

开源协议与项目链接

项目采用 MIT 开源协议，完全开源免费，支持自托管部署。

GitHub：https://github.com/ma-pony/remote-agent-server