MiniMax 开源 OpenAgentCore：自托管的 OpenAI Agents API，会话里可跑 Codex、Claude Code 或 MiniMax Code

01它解决什么问题

想让应用调用“会写代码、会用沙箱的智能体”，目前通常得用某家厂商的托管服务。OpenAgentCore 把这一层做成可自托管的服务：接口与 OpenAI 的 Agents API 一致，数据和计算留在自己的机器上，模型换成自己配置的提供商。

02四个特点（据 README）

• 同款 API：设置 OPENAI_BASE_URL 后，官方 OpenAI SDK 或普通 HTTP 请求照常工作。
• 你的智能体、你的模型：每个会话原生运行 Codex、Claude Code 或 MiniMax Code，模型走你配置的 provider，各 harness 的能力差异见官方 Harness capabilities 页。
• 算力可休眠、工作区保留：用 microsandbox 时，空闲沙箱释放算力，之后在兼容节点上带着文件恢复；E2B 则原地暂停；Docker 以及自己的 Linux、macOS、Windows 机器也能跑会话。
• 部件可替换：沙箱提供方、工作区文件系统、harness、模型提供方都通过既定协议接入。

03怎么装、怎么调

README 给的安装方式：Linux 或 macOS 上有 Docker 时运行下面第一条，会装好 Core、Web 控制台和 PostgreSQL；Windows 用 PowerShell 的第二条。装完在 Web 里用安装器打印的 Core key 登录，配置公开地址、默认模型，签发项目 API key，再添加沙箱算力（节点或 E2B）。以下命令按官方文档，未在本站实测。

curl -fsSL https://openagentcore.dev/install.sh | bash

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

调用示例（官方 README）：用 harness 字段选择 codex。

from openai import OpenAI

client = OpenAI()  # 读取 OPENAI_BASE_URL 和 OPENAI_API_KEY
session = client.beta.agents.sessions.create(
    environment={"type": "openai_hosted"},
    input="Create /workspace/hello.txt with a short greeting, then describe it.",
    extra_body={"agent": {"x_agents_core": {"harness": "codex"}}},
)
print(session.id)

04架构一览

Core 加 PostgreSQL 负责鉴权、冻结配置、调度每个回合、取消与交互，并持久化执行记录；沙箱节点负责申请和回收算力；工作区文件系统与算力生命周期分开存储；Runtime 准备环境并运行会话执行器；harness 适配器调用上游 SDK 并翻译事件；Web 是运维控制台。对外是 /v1（应用用），对运维是 /core/v1。

05适合谁与限制

• 适合：想在自己的环境里统一调度多种编程智能体、又不想改应用侧 SDK 的团队。
• 门槛：需要 Docker、PostgreSQL 和沙箱算力，运维成本不低；个人只想用一次 Codex 或 Claude Code 的，直接装对应命令行更省事。
• 限制：项目较新，star 不多，各 harness 实际支持哪些能力要对照官方能力表；我们没有实际部署测试。