当前 AI 团队面临的主要挑战已从模型能力转向运维治理:Agent 数量激增,本地与服务器混杂,导致权限管理混乱、调用追溯困难。8 月底,GitHub 开源了 MIT 协议项目 OpenClaw Enterprise(OCE),其核心定位明确为“管理 Agent 的开源、厂商中立平台”,可被视为 Agent 领域的 Kubernetes。
一、核心架构:控制平面与数据平面分离
控制平面(OCC,OpenClaw Control Plane) 负责配置管理与部署调度。API 进行鉴权后,由 Worker 通过 Driver 异步创建工作负载。
数据平面 负责实际执行:Agent Gateway 接收消息、调用模型并运行工具。
该架构的关键在于明确界限:部署属于控制平面,消息处理属于数据平面。此举解决了传统框架中“修改配置需重启进程”及“缺乏版本回滚机制”的痛点。
二、四大关键设计特性
1. 不可变版本与持久定义
创建 Agent 仅生成持久工作负载定义,不直接启动进程。部署动作会生成不可变的 AgentRevision(配置快照),Worker 据此激活服务。修改配置不会影响正在运行的版本,新变更需通过重新部署生效。这种借鉴 Kubernetes Deployment 与 ReplicaSet 的设计,确保了版本的可回滚性。
2. Gateway 与 Harness 分离执行
每个部署的 Agent 拥有独立的 Gateway(处理连接与消息),而 Harness 负责执行回合与工具调用。支持两种模式:Embedded OpenClaw(Gateway 与 Harness 同驻一个工作负载)及 Dedicated Codex(Gateway 连接独立的 Codex Harness 工作负载)。
3. 密钥元数据隔离机制
配置与密钥(Secret)分离存储。控制平面仅返回 Secret 元数据而非具体值;通过配置绑定将指定密钥送至 Agent Gateway,由 OpenClaw 解析 SecretRef。密钥不进入 API 响应或聊天记录,从底层保障企业数据安全。
4. 独立身份与权限隔离
采用三段式权限模型:Role(定义权限)、AccessBinding(授予范围)、Restriction(拒绝策略)。人与自动化程序分别对应 Principal 与 ServicePrincipal,而每个 Agent 拥有独立的 ServicePrincipal,不继承创建者权限。Agent 被视为独立主体进行管理,而非用户的影子。
三、技术栈构成
项目采用 TypeScript 单仓结合 Go CLI 的模式,运行于 Kubernetes 之上。主要模块分工如下:
apps/controller/:HTTP API、浏览器控制台、Worker 及 Driverpackages/contracts/:资源模型、Driver 接口及 API Schemapackages/occ/:资源生命周期管理、持久化及工作队列packages/iam/:身份认证、角色管理及资源鉴权packages/audit/:审计事件记录及敏感值脱敏cmd/occ/+internal/occcli|occclient:Go 语言编写的 CLI 工具tests/:一致性测试与集成测试
简而言之:Go 负责 CLI 与客户端,TypeScript 构建控制平面与控制台,Postgres 存储状态,Kubernetes 承载运行环境。
四、部署成本与环境要求
本地部署需准备 Docker/Podman、k3d、kubectl、Helm、Bash、Python 3、Go 及 Node.js 24+ 等依赖。启动控制平面命令示例:
部署首个 Agent 的命令:
关键资源指标:Gateway Pod 请求内存约 1.75 GiB(1792Mi),集群需预留相应资源。默认模型为 gpt-6-astra,可通过 OPENCLAW_FIRST_AGENT_MODEL环境变量更换。密钥建议通过 OPENAI_API_KEY_FILE指向私有文件或注入环境变量,严禁明文写入命令、配置文件或聊天窗口。
五、核心团队背景
项目贡献者包括 derekwaynecarr、sjenning、mrunalp 等资深工程师,以及多位来自 OpenAI 的开发人员。团队背景涵盖 Kubernetes、容器运行时(CRI-O/Podman)及 OpenShift 领域。这解释了该项目为何具备浓厚的基础设施基因,侧重命名空间隔离、不可变版本、鉴权与审计,而非单纯的 Prompt 技巧。
六、评估与建议
直击痛点:OCE 将审批、密钥管理、回滚及审计作为一等公民,解决了 Agent 规模化后的治理瓶颈。
类比恰当:“Agent 的 Kubernetes”并非营销噱头。其控制/数据平面分离、不可变 Revision 及 Driver 供应机制,是将 Kubernetes 理念应用于 Agent 工作负载的成功实践。
早期阶段:截至当前,项目处于极早期阶段(0 个 Release,Backend 抽象标注为 experimental)。生产环境使用需承担跟随主分支迭代的风险。
适用场景:适合已具备 Kubernetes 基础设施且 Agent 数量失控、面临合规审计压力的团队。对于仅需运行 Demo 的个人开发者而言,该方案过重。
仓库地址:github.com/openclaw/openclaw-enterprise
模型能力决定 Agent 的功能上限,而控制平面决定 Agent 的企业可用性。后者将是未来两年行业发展的重点补强方向。

