OpenAgentCore - 自托管的 OpenAI Agents API 实现，可挂多种原生 harness

OpenAgentCore 是一个自托管的 AI Agent 运行层：它把 OpenAI Agents API 这套协议实现在你自己的基础设施上，让应用继续用熟悉的接口调用，而 Agent 实际跑在你控制的机器或沙箱里。据项目自述，它的目标可以概括为四点——接口与 OpenAI 一致、Agent 实现可选、执行机器可选、每个部件都可替换。它适合两类人：一类是想在自有环境里跑 Agent、又不愿意改写客户端代码的应用开发者；另一类是需要统一管理执行容量、模型供应商与运行状态的运维或平台团队。

维护者与状态

项目由 MiniMax-AI 维护，仓库创建于 2026-09-21，最后提交时间为 2026-10-09。最新 release 为 v0.0.9，发布于 2026-10-03。截至 2026-10-09，仓库星标数为 205。许可证为 MIT。从时间线看，这是一个非常年轻的项目：创建到最近一次提交不足三周，版本号仍处于 0.0.x 阶段，使用前应对接口与行为的变动留出预期。

主要能力

以下能力均来自项目自述（README 与官网说明），未经本站实测：

• 与 OpenAI Agents API 同协议。据项目说明，可以把 OpenAI Agent API 或普通 HTTP 请求指向自建的 OpenAgentCore 实例，不需要学习新的客户端。README 中称「Same API as OpenAI. Point the OpenAI Agent API, or plain HTTP, at your installation. No new client to learn.」
• 每个 Session 可选不同 harness。项目自述每个 Session 运行一个原生 harness，可选 Codex、Claude Code 或 MiniMax Code，模型供应商由使用者自行配置。
• 执行位置可选。据项目说明，Agent 既可以在托管沙箱中工作（Docker、microsandbox 或 E2B），也可以直接跑在自己的 Linux、macOS 或 Windows 机器上。
• 部件可替换。项目自述沙箱、harness 与模型供应商都通过定义好的协议接入，因此每一部分都可以单独替换。
• 两套 API 分工。据 README 的表格，Agents API 位于 /v1 路径，供应用调用，协议与 OpenAI 的 Agents API 相同；Core API 位于 /core/v1 路径，供运维人员通过 Web 控制台使用。Core 保存持久化的执行状态，Runtime 在 Environment 内运行选定的 harness。

使用入口

仓库地址：MiniMax-AI/OpenAgentCore；官网：openagentcore.dev。

据项目自述，在已配置 Docker 的 Linux 或 macOS 上，安装命令为：

curl -fsSL https://github.com/MiniMax-AI/OpenAgentCore/releases/latest/download/install.sh | bash

Windows PowerShell 下为：

irm https://github.com/MiniMax-AI/OpenAgentCore/releases/latest/download/install.ps1 | iex

安装完成后的流程，据 README 描述为四步：用安装器生成的 Core key 登录 Web 管理控制台，并配置域名与 HTTPS；设置默认模型并签发 Project API key；添加执行容量，可以是节点、E2B，或自己的机器；最后用 OpenAI SDK 跑通第一个 Session。README 提到安装指南中覆盖了每一步、HTTPS 配置以及本地快速试用，监听地址、端口等选项另见安装选项文档。

文档入口按用途划分：安装与运维、基于 API 构建应用（Quickstart 与 Agents API 指南）、完整示例应用、在自有机器上运行 Agent、查看 harness 能力与限制、理解架构设计，以及新增沙箱或 harness 等组件的开发者指南。README 同时提示，改动代码前应先阅读贡献者规则。

许可与限制

许可证为 MIT。需要留意的边界：项目自述中把 harness 的能力与限制单独列为一页文档，说明不同 harness 之间在能力上并不等价，选型时需要逐项核对；执行环境方面，托管沙箱依赖 Docker、microsandbox 或 E2B，自托管执行则需要 Linux、macOS 或 Windows 机器；模型供应商由使用者自行配置，项目本身不附带模型。此外，项目处于 0.0.x 阶段且更新频繁，README 中提到的安装脚本、API 路径与配置步骤都可能随版本调整，落地前建议以仓库内最新文档为准。