oh-my-openagent 中文教程：先选对 Ultimate、Light 或 Native
oh-my-openagent 常简称 OMO。它不是一个固定命令对应一个固定产品：当前官方同时维护 OpenCode Ultimate 插件、Codex Light 插件和 OmO Native beta。旧教程最容易错在包名、宿主和安装命令混用。
1. 先选运行版本
| 你的情况 | 版本 | 官方入口 |
|---|---|---|
| 已经使用 OpenCode，想要完整的 Agent、hooks、MCP 和 Team Mode | Ultimate | bunx oh-my-openagent install |
| 主要使用 Codex CLI | Light | npx lazycodex-ai install |
| 不想先安装宿主，能接受 beta | OmO Native | bun add -g omo-ai@beta |
Ultimate 和 Light 都是宿主插件。Native 才是独立 omo 命令，它把固定的 senpi 引擎和 OMO 扩展一起交付。
2. 安装前先看它会改什么
Ultimate 会注册 OpenCode 插件、Agent/模型配置和 provider 授权。Light 会写入 ~/.codex/ 下的 marketplace、插件和 Agent 配置；自动权限模式还可能把 Codex 设为无需反复确认的运行方式。Native 把状态放在 ~/.omo/agent。
~/.config/opencode、~/.codex 和 ~/.omo 的差异，并确认是否接受权限和遥测设置。3. 三条安装路径
# OpenCode Ultimate
bunx oh-my-openagent install
# Codex Light
npx lazycodex-ai install
# 独立 Native beta
bun add -g omo-ai@beta
omo setup不要运行 npx omo 或 bunx omo。官方安装指南明确说明 npm 上的 omo 是另一位作者的无关包。插件版也不支持普通的全局安装。
4. 和直接使用 OpenCode 的区别
相比直接使用 OpenCode，OMO 是额外的编排层。OpenCode 官方默认有 build、plan 和 general agent；OMO Ultimate 再增加 11 个 Agent、54 个以上生命周期 hooks、4 个内置 MCP、Team Mode 和 ultrawork。任务简单时先用宿主自带能力；确实需要角色分工、多阶段计划和并行协作时，再接受 OMO 的配置与升级成本。
5. 遥测、许可和验证边界
官方说明匿名遥测默认开启，每台机器每天最多发送一次带哈希标识的事件，并提供配置和环境变量关闭。主体代码使用 Sustainable Use License，允许内部业务、非商业或个人使用，但分发和商业场景有额外限制，应直接阅读 官方 LICENSE。
后续核查应记录：选用的版本、安装器改动清单、doctor 输出、实际加载的 Agent/MCP、权限设置和遥测开关。v5 beta 更新频繁，不能只记住一次命令长期复用。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
近期变化与关注原因
数值只用于判断持续需求。官方项目正在从单一 OpenCode 插件扩展为三种版本，并频繁发布 v5 beta，安装入口、包名和命令都在变化，因此准确的版本化教程有现实价值。
适合谁用
适合需要把规划、检索、实现和复核分给不同 Agent，或希望在 OpenCode、Codex 与独立命令之间复用一套工作流的人。只做一次短任务，或不愿让安装器写入宿主配置时，直接使用宿主自带 Agent 更简单。
采用建议
OMO 适合愿意管理宿主、provider、配置迁移和高频 beta 更新的重度 Agent 用户。先选清 Ultimate、Light 或 Native，再审查安装器将写入的目录、权限和遥测设置；如果宿主自带的少量 Agent 已够用，没有必要为了功能数量增加一层编排。
原教程未展开的系统信息
核心功能
可检查的安装与诊断路径
Ultimate 使用交互式安装器；Light 有单独的 npx 安装器和 doctor；Native 的 omo setup 会先只读检测其他 Agent 凭据，再经用户同意导入兼容的 API key。
架构与数据流
主仓库用 TypeScript/Bun 维护，并拆出 rules、delegate、MCP、LSP、model、prompts、team、memory、isolation、telemetry、Codex 与 senpi 等工作区包。Ultimate 和 Light 由宿主加载插件；Native 把固定引擎与扩展合并成一个 omo 命令。运行配置统一迁到 ~/.omo/omo.jsonc，并支持项目目录中的 .omo/omo.jsonc；Native 状态放在 ~/.omo/agent。
技术栈和运行条件
语言
TypeScript
框架
Agent harness 插件与独立 senpi 版本
关键依赖
- Bun（Ultimate 与 Native 推荐）
- Node.js/npm（Codex Light 安装器）
- OpenCode 或 Codex CLI（插件版本的宿主）
- MCP、LSP、tmux Team Mode
运行环境
本地 CLI 与配置目录；模型和订阅凭据由所选 provider 与宿主管理
常见问题
Ultimate、Light 和 OmO Native 应该怎么选？
已经使用 OpenCode，选 Ultimate；主要使用 Codex CLI，选 Light；不想先安装宿主且愿意接受 beta，才选 OmO Native。
可以用 npm install -g oh-my-openagent 安装吗？
官方不支持这样安装插件版。Ultimate 使用 bunx oh-my-openagent install，Light 使用 npx lazycodex-ai install；Native 才是 bun add -g omo-ai@beta。
为什么不能运行 npx omo 或 bunx omo？
官方明确说明 npm 上名为 omo 的包属于另一位作者，与本项目无关；本项目的独立版本包名是 omo-ai，而且当前必须带 @beta。
oh-my-openagent 的匿名遥测能关闭吗？
可以。主插件可在配置中设置 telemetry: false，或使用 OMO_DISABLE_POSTHOG=1、OMO_SEND_ANONYMOUS_TELEMETRY=0；Codex Light 还有对应的 OMO_CODEX_* 变量。