# MiniMax open-sources OpenAgentCore, a self-hosted OpenAI Agents API

> Original title: MiniMax 开源了自托管的 OpenAI Agents API「OpenAgentCore」：一套 Core，多种 Harness；官方 SDK 只改 OPENAI_BASE_URL，Session 里原生跑 Codex / Claude Code / MiniMax ...

- Source: meng shao
- Published: 2026-10-27T03:16:26.000Z
- Bad Influence: https://badinfluence.news/items/lqptdqsr1x6yjpv6e963422y8
- Original: https://x.com/shao__meng/status/2114919123281117195

## Summary

MiniMax has open-sourced OpenAgentCore, a self-hosted OpenAI Agents API. Developers can point the official OpenAI SDK at its Core /v1 endpoint, choose harnesses such as Codex, Claude Code, or MiniMax Code per session, and swap models and sandboxes through defined protocols.

## Why it matters

The post shows how a self-hosted agent API lets one OpenAI-compatible interface run several agent harnesses and swappable models, sandboxes, and storage behind it.

## Post

MiniMax 开源了自托管的 OpenAI Agents API「OpenAgentCore」：一套 Core，多种 Harness；官方 SDK 只改 OPENAI_BASE_URL，Session 里原生跑 Codex / Claude Code / MiniMax Code，模型与沙箱按协议可换

开源地址：
https://github.com/MiniMax-AI/OpenAgentCore

主要想解决的问题
1. 同款 API：官方 OpenAI SDK 或裸 HTTP，指向你的 Core /v1。
2. 你的 Agent + 你的模型：每个 Session 选 harness（如 extra_body.agent.x_agents_core.harness = "codex"），模型走你配置的 provider。
3. 计算可休眠、工作区可留：microsandbox 上空闲释放算力、文件随独立存储在兼容节点恢复；E2B 可就地 pause；也支持 Docker 与本机 Linux/macOS/Windows。
4. 边界可替换：Sandbox Provider、工作区文件系统、Harness、模型提供商都走既定协议（见 AGENTS.md）。

项目架构
· Core + PG：鉴权、冻结配置、调度 Turn、取消/交互、持久化执行事实
· Sandbox Provider / Node：申请与回收算力；节点跑 Docker 或 microsandbox
· Workspace FS：环境持久存储（与算力生命周期分开）
· Runtime：准备环境与能力快照，跑 Session Executor，上报事件与收据
· Harness adapter：调上游 SDK/协议，翻译事件；原生 agent 循环与上下文归 Harness
· Model provider：Responses / Anthropic / chat_completions 等协议
· Web：运维控制台（走 /core/v1）

## AI translation

MiniMax has open-sourced OpenAgentCore, a self-hosted OpenAI Agents API: one Core, multiple Harnesses. With the official SDK you only change OPENAI_BASE_URL, and within a Session you can natively run Codex / Claude Code / MiniMax Code; the model and sandbox are swappable under the protocol.

Open source repo:
https://github.com/MiniMax-AI/OpenAgentCore

Main problems it aims to solve
1. Same API: use the official OpenAI SDK or raw HTTP, pointed at your Core /v1.
2. Your Agent + your model: each Session selects a harness (e.g. extra_body.agent.x_agents_core.harness = "codex"), and the model goes through the provider you configured.
3. Compute can sleep, workspace can persist: microsandbox releases compute when idle, and files persist separately, restorable on compatible nodes; E2B can pause in place; Docker and local Linux/macOS/Windows are also supported.
4. Replaceable boundaries: Sandbox Provider, workspace filesystem, Harness, and model provider all go through defined protocols (see AGENTS.md).

Project architecture
· Core + PG: authentication, frozen configuration, Turn scheduling, cancellation/interaction, persisted execution facts
· Sandbox Provider / Node: request and reclaim compute; nodes run Docker or microsandbox
· Workspace FS: persistent environment storage (separate from compute lifecycle)
· Runtime: prepares the environment and capability snapshot, runs the Session Executor, reports events and receipts
· Harness adapter: calls upstream SDKs/protocols and translates events; the native agent loop and context belong to the Harness
· Model provider: Responses / Anthropic / chat_completions and other protocols
· Web: operations console (goes through /core/v1)

![](https://badinfluence.news/api/img-proxy?u=https%3A%2F%2Fpbs.twimg.com%2Fmedia%2FHVmztjJawAAkkym.jpg&mode=thumb&exp=1793404800&sig=367a2fe5f987952b)

## Quoted post @saladday

> [1/n] 以前大家调 API 是 Tokens as a Service，现在慢慢变成了 Agents as a Service。
> 
> 但做这层存在一个很现实的问题：现在模型和harness基本几个月就迭代一轮，如果把业务直接绑死在某套实现上，后面换起来会非常痛苦。所以底层的 Agent Infra 尽可能需要做到对外的接口足够稳定，但是对内得能够随时换上最 frontier 的组件。
> 
> 这就是我们做 OpenAgentCore 的初衷，一个开源的 Agent Infra：对外只提供一套标准的 API，对内不管是 harness、model、sandbox 还是 Filesystem 全部协议化，都可以随意更换，不会被绑在某一家上。
> 
> https://github.com/MiniMax-AI/OpenAgentCore

https://x.com/saladday/status/2114613174620061856

### Quoted post, AI translation

> [1/n] Previously, people called APIs Tokens as a Service; now it's gradually becoming Agents as a Service.
> 
> But building this layer has a very practical problem: models and harnesses basically iterate every few months, so if you tie your business directly to a specific implementation, swapping things later becomes very painful. So the underlying Agent Infra needs to keep its external interface as stable as possible, while internally being able to swap in the most frontier components at any time.
> 
> This is why we built OpenAgentCore, an open-source Agent Infra: externally it provides only one standard API, internally the harness, model, sandbox, and Filesystem are all protocolized, so they can be swapped freely without being locked to any one vendor.
> 
> https://github.com/MiniMax-AI/OpenAgentCore