oh-my-openagent

项目地址： https://github.com/code-yeongyu/oh-my-openagent

官网 / 文档： https://omo.dev ｜ https://omo.dev/docs

npm 包： omo-ai（5.1.48，截至 2026-10）｜ CLI 命令：omo

许可证： SUL-1.0（Sustainable Use License，商用前阅读条款）

版本关键变化： OmO 5.0 起是独立应用（"OmO Native"），跑在作者维护的 senpi（pi 的 fork）上，不再需要 OpenCode。4.x 及更早才是 OpenCode 插件（oh-my-opencode），旧装可用 omo setup 迁移。

概述

OmO 不是模型、也不是 IDE 插件，而是"一条 omo 命令把 token 变成交付物"的终端 Agent：调研、出稿、写后端前端、写代码都在同一套内置能力里。

• 独立运行时：自带 senpi 引擎，不依赖 OpenCode 的插件注册
• 多模型编排：不同角色分配不同模型并行跑（订阅型 provider 也支持）
• 并行后台智能体：任务分给多个后台 agent 并行推进
• 内置工具集：结构化检索/编辑、浏览器使用等以 skills 形式按需加载
• 思考档位：/thinking <level>、/efforts <level> 控制推理强度，Shift+Tab 循环切换
• 会话续接：/resume（或 /sessions）翻历史；shell 里 omo -c 续上一个会话、omo -r 打开选择器
• 自诊断：omo doctor 看各任务类别能跑哪些 provider、旧安装留下了什么

---

安装

方式一：官方安装脚本（推荐）

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

Windows PowerShell：

irm https://get.omo.dev/install.ps1 | iex

脚本会把对应 OS/CPU 的原生 omo 二进制装到 ~/.local/bin，用发布校验和校验；镜像不可达时回退到 GitHub Releases。要换频道或锁版本，在 bash 后面追加：

curl -fsSL https://get.omo.dev/install.sh | bash -s -- beta
curl -fsSL https://get.omo.dev/install.sh | bash -s -- 5.1.1

方式二：包管理器（bun / npm）

bun add -g omo-ai          # 或 npm i -g omo-ai

npm 上名为 omo 的包是别人的，与本项目无关；认准 omo-ai。

方式三：从旧版（OpenCode 插件）迁移

bunx oh-my-openagent install --platform=native     # 没有 bun 用 npx

这条命令会：① 找到被 oh-my-openagent/oh-my-opencode/lazycodex 占用的全局 omo 并只删这一个文件；② 执行 bun add -g omo-ai（或 npm i -g omo-ai）；③ 校验 omo --version 现在确实答的是 omo-ai；④ 询问是否立刻跑 omo setup（--no-tui 时只打印命令）。

验证：

omo --version        # 期望：omo 5.x.x (engine: senpi ...)
omo doctor           # provider/模型可用性 + 旧安装残留

要求：bun（推荐）或 npm，Node 24 或更新。

---

核心命令

命令	作用
omo	启动交互式会话
omo -c / omo -r	续上一个会话 / 打开历史选择器
omo setup	从 OpenCode 版或 LazyCodex 迁移 provider keys、自定义 provider、MCP、skills 与模型选择
omo doctor	诊断：哪些任务类别能跑、旧安装残留
omo doctor --models	看每个类别与 agent 用哪个模型、按什么顺序回退
omo update	包管理器安装方式下的自更新
omo --version	版本 + 引擎标识