【AI Agent 实战】omnigent 中文版：统一编排多个编码代理的 meta-harness 上手指南

项目简介

omnigent 是一个开源的 meta-harness（元框架），为 Claude Code、Codex、Cursor、OpenCode、Hermes、Pi 以及自定义代理提供统一编排层。Python 编写，Apache-2.0 许可，GitHub 9068 stars。

• 原项目：https://github.com/omnigent-ai/omnigent
• 中文版：https://github.com/yangshun2005/omnigent-cn
• 官网：https://omnigent.ai

核心价值：无需重写即可切换或组合代理框架，强制执行策略和沙箱隔离，从任何设备（终端/浏览器/手机/桌面应用）实时协作。

快速开始

一条命令安装：

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh

可选集成通过 --extra 传递：

curl -fsSL https://raw.githubusercontent.com/omnigent-ai/omnigent/main/scripts/install_oss.sh | sh -s -- --extra modal,e2b

可选附加组件包括：模型提供商（databricks、bedrock、vertex）、沙箱提供商（modal、daytona、e2b、kubernetes 等）、SDK 框架（cursor、agents-sdk 等）、存储与记忆（s3、hindsight）。

核心能力

1. 跨设备使用，包括手机

会话"随身而行"：终端开始、浏览器继续、手机接着处理。消息、子代理、终端、文件全部保持同步。

2. 一个会话监督多个代理

在同一个会话中混合使用 Claude Code、Codex、Cursor、Pi 以及 YAML 定义的自定义代理。让一个代理审查另一个代理的工作，或将任务拆分给各有所长的不同代理。

3. 使用任何模型

第一方 API 密钥、Claude/ChatGPT 订阅，或任何兼容网关，全都是一等公民。

4. 协作

共享会话，让队友与你的代理聊天、实时观看工作、共同驾驶，或 Fork 对话自行继续。

5. 云端沙箱运行

在 Modal、Daytona、Blaxel、E2B、CoreWeave、Kubernetes、OpenShell 等十几种沙箱中运行会话，可从 CLI 启动或由服务器按会话分配。

6. 策略治理

创建策略，在风险操作前暂停等待批准、限制支出、限制代理可访问的工具。粒度可作用于整个服务器、单个代理或单个聊天。

使用边界

• 项目状态为 alpha，接口和行为可能调整，生产环境引入前建议小范围验证。
• 它是编排层，不是替代品，仍需理解底层代理各自的能力和限制。
• 完整能力（跨设备同步、实时协作、云沙箱、托管主机）需要服务端组件支撑，单机模式只覆盖部分。

中文版说明

中文版保留了原项目的全部代码和功能，仅对 README 与核心文档做了完整中文化，元框架定位、设备同步、多代理监督、云沙箱、策略治理、安装方式等均可直接以中文阅读。

如果这个项目对你有帮助，也欢迎动动小手去原仓库点个 Star，支持作者持续维护。