code-yeongyu/oh-my-openagent 是一个 TypeScript 写的 OpenCode 插件(不是独立 agent harness),GitHub 67728 颗星(实时变动,以 GitHub 为准)、5538 个 fork,2025-12-03 创建,最近一次 push 就在今天(2026-08-12),未归档,homepage 是 omo.dev。npm 包名 oh-my-opencode,当前版本 v5.0.0-beta.6。package.json 描述原话:"The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools."(电池全包的 OpenCode 插件,多模型编排 + 并行后台 agent + 自研 LSP/AST 工具。)差异点:它不跟 Claude Code 那样绑死 Anthropic,也不像 Cursor 做闭源 IDE 副驾,而是当"模型编排层"——把多家模型(Kimi K3、GPT-5.6 Sol 等)同时拉进一个 Team Mode 画面里协同干活。README 里一句最狠的钩子:"Anthropic blocked OpenCode because of us. Yes, this is true."(Anthropic 因为我们封了 OpenCode。是的,这是真的。)但避坑也在这:它的许可证不是 MIT 也不是 Apache,是 SUL-1.0(Sustainable Use License),非 OSI 标准,有竞争性使用限制。本文把这条和另外几条坑一起拆开。
本文基于 code-yeongyu/oh-my-openagent 的 GitHub README 与 LICENSE.md 梳理,事实截至 2026-08-12,星数实时变动。与本站 crush 资源盘、pi 资源盘、openclaw 资源盘 各管不同地盘,和 AI 编程套餐横评 互补但独立。
一、定位:OpenCode 的"电池全包"插件,不是又一个独立 agent
先说清楚一个容易误解的点:oh-my-openagent 不是从零造的独立编程 agent,它是 OpenCode 的插件。OpenCode 本身是一个开源的 AI 编程框架(terminal-based),oh-my-openagent 在它上面加了一层"电池"——多模型编排、并行后台 agent、自研 LSP/AST 工具,装上即用。这跟 crush(独立终端 agent)、Claude Code(Anthropic 官方闭源 agent)的路线不同:它不重新造轮子,而是把 OpenCode 当底座往上叠能力。
为什么这个定位有价值?因为 OpenCode 用户已经有代码基础设施,缺的是"编排多个模型"和"后台并行跑 agent"这两件事。oh-my-openagent 正好补这个缺口。bin 命令有五个:oh-my-opencode、oh-my-openagent、omo-agent-toolkit、lazycodex、lazycodex-ai——前三个是 OmO 主线,后两个是 LazyCodex(OmO for Codex 的安装路径,npx lazycodex-ai install,官网 lazycodex.ai)。
维护者是 code-yeongyu,背后是 Sisyphus Labs(sisyphuslabs.ai)。一个有意思的细节:项目用了一个叫 Jobdori 的 AI 助手(OpenClaw 的定制 fork)实时构建和维护,在 Discord 上 Building in Public 直播——你能看着它怎么被 AI 一行行搭起来。README 有日/韩/中/俄四语版本,说明它在东亚社区热度不低。
二、核心卖点:三张牌
多模型编排 Multi-Model Orchestration。 最硬的差异化。不是"选一个模型用到底",而是把多家模型拉进同一个工作流按任务分配。README 的 Team Mode 实测画面里,Kimi K3 和 GPT-5.6 Sol 同框出现——一个管推理、一个管代码生成,各干各的活。这呼应 README 那句主张:"The future isn't picking one winner; it's orchestrating them all. Models get cheaper every month."(未来不是选一个赢家,而是把它们全部编排起来。模型每个月都在变便宜。)逻辑是:模型迭代快、价格月月降,绑死一家等于赌错方向,不如做编排层让模型可插拔。
并行后台 agent Parallel Background Agents。 能同时跑多个 agent 干不同的子任务,不等一个干完再启动下一个。比如一个大任务拆成"查文档""改测试""写接口"三块,三个 agent 并行推进最后汇总。比单线程串行快很多,尤其在大型重构场景。
自研 LSP/AST 工具 Crafted LSP/AST Tools。 这条是"精度牌"。多数编程 agent 靠读文件加正则匹配理解代码,oh-my-openagent 用语言服务器协议(LSP)和抽象语法树(AST)拿结构化上下文——符号定义、引用关系、类型信息,跟 IDE 里你跳转看代码用的是同一套机制。结果就是改代码更准、误伤更少。
三、和 Claude Code、crush、pi 怎么分地盘
Claude Code 是 Anthropic 官方的终端/桌面 agent,闭源、绑 Anthropic 模型、订阅制。oh-my-openagent 的 README 直接点名开炮:"Claude Code is a nice prison, but it's still a prison. You don't need to pay $200 for 2 hours of work."(Claude Code 是个不错的监狱,但终究是监狱。你不需要为 2 小时的工作付 200 美元。)crush 是 Charm 的开源终端 agent,模型可换、许可证是 FSL-1.1-MIT(见本站 crush 资源盘)。pi(earendil-works/pi)是另一个轻量开源 agent(见本站 pi 资源盘)。
oh-my-openagent 跟它们的根本区别:它是 OpenCode 插件(寄生在框架上增强),不是独立 agent;它主打"多模型同框编排",crush 和 pi 偏"单模型可切换";它的 LSP/AST 工具是自研的,不是简单调现成的。
| 维度 | oh-my-openagent | Claude Code | crush | pi |
|---|---|---|---|---|
| 定位 | OpenCode 插件·模型编排 | 终端/桌面 agent | 终端 agent | 轻量 agent |
| 模型 | 多家同框编排 | 仅 Anthropic | 任意可切换 | 任意可切换 |
| 许可证 | SUL-1.0 | 闭源 | FSL-1.1-MIT | 开源 |
| 费用 | 软件免费·模型自付 | 订阅制 | 软件免费·模型自付 | 软件免费·模型自付 |
四、上手:装好、接模型、开 Team Mode
装。 oh-my-openagent 是 npm 包,最直接:
npm install -g oh-my-opencode装完命令行就有 oh-my-opencode(或 oh-my-openagent、omo-agent-toolkit)。如果你是 Codex 用户,走 LazyCodex 路径:npx lazycodex-ai install,官网 lazycodex.ai 有指引。
接模型。 因为是多模型编排,你可以同时配多家。设好各家的 API key(ANTHROPIC_API_KEY、OPENAI_API_KEY、MOONSHOT_API_KEY 等),然后在 Team Mode 里选你要编排的组合。README 的实测画面是 Kimi K3 + GPT-5.6 Sol,你也可以换成 DeepSeek + Qwen 之类的国产组合来控成本。
开 Team Mode。 核心玩法是给不同 agent 分配不同模型和子任务并行跑。具体配置语法看 README 和 omo.dev 文档——重点是"多模型同框"这个心智模型:不是切换,是编排。
五、避坑代价:许可证是 SUL 不是 MIT,还有这几条
坑一:许可证不是 MIT/Apache,是 SUL-1.0(最该读的一条)。 GitHub SPDX 探测器对 oh-my-openagent 返回 NOASSERTION。点进仓库读 LICENSE.md,开头写的是 "Sustainable Use License v1.0"(可持续使用许可),缩写 SUL-1.0,版权归 Sisyphus Labs。SUL 不是 OSI 认可的开源许可证,核心特点是"使用受限":你可以用、改、二次开发,但"竞争性使用"受限——简单说就是不能拿它去做一个跟 oh-my-openagent 本身竞争的产品或服务。第三方组件各自保留原 license。这跟 crush 的 FSL-1.1-MIT(两年后转 MIT)是不同的许可设计,别混为一谈。个人写代码、公司内部用一般没问题;想 fork 做竞品 SaaS,先找律师读 SUL 原文。
坑二:它是 OpenCode 插件,不是独立 agent。 冲着"装一个就能用"来的人要注意:oh-my-openagent 依赖 OpenCode 框架,你得先理解 OpenCode 的工作方式。如果你要的是开箱即用的独立工具,Claude Code 订阅或 crush 更省心。
坑三:v5.0.0-beta.6,还是 beta。 当前版本号带 beta,说明接口和功能还在变动。2025-12-03 创建、今天还在 push,迭代很快是好事,但生产接入前建议锁定版本号、自己跑一遍你的场景。
坑四:模型 API 自付,多模型编排更烧钱。 软件免费,但多模型同框意味着多个模型同时烧 token。Team Mode 里 Kimi + GPT 同时跑,成本是两家叠加的。建议:粗活用便宜模型,关键步骤才上强模型,别全程全开。
坑五(反过来的甜头):反围墙花园,国产模型友好。 整个项目的理念就是"不被一家锁死",所以接国产模型是设计意图而非兼容层补丁。Kimi(月之暗面)在 README 实测画面里就是主力之一,DeepSeek、Qwen 也能接。比起绑死单一海外模型的闭源 agent,oh-my-openagent 在国内可用性反而更强。选模型可参考本站 AI 编程套餐横评。
适合:已经在用 OpenCode、想加多模型编排能力的人;不愿被单一 AI 厂商锁定、想自由组合模型的人;需要并行后台 agent 处理大型重构的人;想接国产模型控成本的中国开发者。别凑热闹:你要开箱即用的独立 agent——Claude Code 或 crush 更对路;你要轻量极简——pi 更合适。
常见问题
Q1:oh-my-openagent 和 Claude Code、crush 有什么区别? A1:Claude Code 是 Anthropic 闭源订阅 agent,绑死自家模型;crush 是独立终端编程 agent(FSL-1.1-MIT 许可证,两年后转 MIT);oh-my-openagent 是 OpenCode 插件(非独立 agent),主打多模型编排,许可证 SUL-1.0 非 OSI 标准。三者定位与许可都不同。
Q2:SUL-1.0 许可证能商用吗? A2:个人写代码、公司内部用一般没问题。但"竞争性使用"受限——不能拿它做与 oh-my-openagent 本身竞争的产品或服务。想做竞品 SaaS 前先找律师读 LICENSE.md 原文。注意它不像 crush 的 FSL 有"两年转 MIT"机制。
Q3:必须先装 OpenCode 才能用吗? A3:是的。oh-my-openagent 是 OpenCode 的"电池全包"插件,依赖 OpenCode 框架,不是开箱即用的独立工具。要开箱即用独立 agent,选 Claude Code 或 crush。Codex 用户可用 LazyCodex(npx lazycodex-ai install)。
Q4:多模型编排怎么控成本? A4:软件免费,但多模型同框意味着多个模型同时烧 token,成本叠加。建议粗活用便宜模型、关键步骤才上强模型,别全程全开。国产模型(Kimi/DeepSeek/Qwen)成本更低,接入是设计意图而非补丁。
Q5:当前还是 beta,生产环境能用吗? A5:当前 v5.0.0-beta.6,接口与功能仍在变动,迭代很快。生产接入前建议锁定版本号、自跑一遍场景验证。2025-12-03 创建、今日仍 push,活跃度高但稳定性需自行验证。
参考来源
- code-yeongyu/oh-my-openagent GitHub 仓库(67728 star / 5538 fork,TypeScript,SUL-1.0 许可证):https://github.com/code-yeongyu/oh-my-openagent
- oh-my-openagent 官网(omo.dev):https://omo.dev
- LICENSE.md(SUL-1.0 全文,含使用限制条款):https://github.com/code-yeongyu/oh-my-openagent/blob/main/LICENSE.md
- npm 包 oh-my-opencode(v5.0.0-beta.6):https://www.npmjs.com/package/oh-my-opencode
- LazyCodex(OmO for Codex 安装路径,官网 lazycodex.ai):https://lazycodex.ai
- 本站相关:crush 资源盘 | pi 资源盘 | openclaw 资源盘 | AI 编程套餐横评