Oh My OpenAgent 使用教程

📖 项目简介

Oh My OpenAgent（原 Oh My OpenCode）是一个基于 OpenCode 的超级插件/Agent Harness，让你用一条命令就能启动一整支 AI 编程团队。它内置 Sisyphus 编排器、Hephaestus 深度工作者、 Prometheus 规划器等多个专业 Agent，能同时调度 Claude、GPT、Gemini、Kimi 等多个大模型，自动将任务分配给最擅长的 Agent 并行执行。

项目使用 TypeScript 开发，在 GitHub 上已获得 50.5K Star，累计下载超过 38K 次。它的目标是：输入 ulw 三个字母，然后走人。AI团队会自动完成所有编程工作。

💡

GitHub 地址： https://github.com/code-yeongyu/oh-my-openagent
官网： https://ohmyopenagent.com/zh

✨ 核心亮点

⚡

ultrawork / ulw

一条命令激活所有 Agent，自动规划、并行执行、自我纠错，完成才停

🤖

多Agent编排

Sisyphus 编排器 + Hephaestus 深度工作者 + Prometheus 规划器，分工协作

🔗

Hash锚定编辑

每行代码带内容哈希标签，编辑成功率从 6.7% 飙升到 68.3%

🧠

多模型调度

Claude 做编排、GPT 做推理、Gemini 做创意、Kimi 做速度，各取所长

🛠️

LSP + AST-Grep

IDE 级精度的重命名、跳转定义、AST 感知代码重写

🔌

Claude Code 兼容

你的 hooks、commands、skills、MCPs、plugins 全部可用

🏗️ Agent 架构

Oh My OpenAgent 内置多个专业 Agent，各司其职：

Agent	模型	职责
Sisyphus	Claude Opus 4.6 / Kimi K2.5	主编排器，分析意图、委派任务、验证结果
Hephaestus	GPT 5.4	深度工作者，自主探索代码库并端到端执行
Prometheus	Claude Opus 4.6 / Kimi K2.5	战略规划器，访谈式需求分析，制定执行计划
Oracle	GPT 5.4	架构顾问，复杂调试和架构决策
Librarian	MiniMax M2.5	文档搜索，查找 GitHub 示例和官方文档
Explore	MiniMax M2.5	超高速代码库搜索，并行后台运行

🚀 安装方法

前置要求

已安装 Node.js（v18+）和 Bun
已安装 OpenCode（Claude Code 开源版）
至少一个 LLM API Key（如 OpenAI、Anthropic、Kimi 等）

一键安装

在终端中运行以下命令，自动安装并配置 Oh My OpenAgent：

                        bash
                        bunx oh-my-openagent install
                    

或者让你的 LLM Agent（Claude Code / Cursor 等）代劳：

                        prompt
                        Install and configure oh-my-opencode by following:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
                    

配置模型 API

根据你的订阅情况配置模型。推荐最低配置（每月约 $31）：

ChatGPT 订阅（$20/月）— 用于 Hephaestus 深度推理
Kimi Code 订阅（$0.99/月）— 用于编排和速度任务
GLM Coding Plan（$10/月）— 备选编排模型

开始使用

进入你的项目目录，输入一条命令即可开始：

                        bash
                        # 进入项目目录
cd your-project

# 启动 ultrawork 模式
opencode
# 然后输入: ulw
                    

输入 ulw（ultrawork 缩写）后，系统会自动：

扫描你的代码库结构
启动多个 Explore Agent 并行探索
构建执行计划
部署并行 Agent 执行任务
运行验证测试，确保零问题

🎯 常用命令

命令	说明
`ulw` / `ultrawork`	启动全自动模式，所有 Agent 上线，直到完成
`/start-work`	启动 Prometheus 规划器，先访谈再执行
`/init-deep`	自动生成层级 AGENTS.md 文件，给 Agent 提供上下文
`/ulw-loop`	自我循环模式，不到 100% 完成不停止

❓ 常见问题

Q: 它和 Claude Code 有什么区别？

Oh My OpenAgent 是 OpenCode（Claude Code 开源版）的增强插件。Claude Code 是单模型单 Agent，而 OmO 内置多个专业 Agent，能同时调度多个模型并行工作，并提供 Hash 锚定编辑、后台 Agent、LSP 集成等高级功能。

Q: 需要哪些 API Key？

最低只需一个 LLM API Key 即可运行。推荐配置 ChatGPT + Kimi + GLM，这样 ultrawork 可以充分利用多模型编排。每月费用约 $31。

Q: 支持哪些编程语言？

支持所有主流编程语言。它通过 LSP（语言服务协议）提供 IDE 级的代码理解能力， AST-Grep 支持 25 种语言的语法感知搜索和重写。

Q: 中断了怎么办？

Oh My OpenAgent 内置 Boulder 会话恢复系统。即使断电或系统崩溃，重启后会从上次停下的位置精确恢复，零上下文丢失。