HoRain云--OpenCode oh-my-openagent 使用教程
🎬 HoRain云小助手：个人主页
🔥 个人专栏: 《Linux 系列教程》《c语言教程》
⛺️生活的理想，就是为了理想的生活!
⛳️ 推荐
前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。
专栏介绍
|
专栏名称 |
专栏介绍 |
|
本专栏主要撰写C干货内容和编程技巧，让大家从底层了解C，把更多的知识由抽象到简单通俗易懂。 |
|
|
本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘，一起解密网络协议在运行中协议的基本运行机制！ |
|
|
全面深入解析 docker 容器，从基础到进阶，涵盖原理、操作、实践案例，助您精通 docker。 |
|
|
本专栏主要撰写Linux干货内容，从基础到进阶，知识由抽象到简单通俗易懂，帮你从新手小白到扫地僧。 |
|
|
本专栏着重撰写Python相关的干货内容与编程技巧，助力大家从底层去认识Python，将更多复杂的知识由抽象转化为简单易懂的内容。 |
|
|
本专栏主要是发布一些考试和练习题库（涵盖软考、HCIE、HRCE、CCNA等） |
目录
Q：运行时提示 "Using legacy package name" 警告
Q：Sisyphus Agent 效果很差，感觉和普通 Claude 差不多
Oh My OpenAgent（简称 OmO）是一个开源的 AI 编程助手增强插件，前身叫 oh-my-opencode。
oh-my-openagent 运行在 OpenCode这个 AI 编程工具之上，把它变成一个由 11 个专业 AI Agent 组成的开发团队。
用一句话解释：
你发一个需求 → OmO 自动调度多个 AI 并行工作 → 比单个 AI 快数倍
目前在 GitHub 上有 54k+ Stars，是最受欢迎的 OpenCode 插件。
安装
将以下提示词复制粘贴到你的大模型工具（ OpenCode、Claude Code、AmpCode、Cursor 等）：
按照此链接说明安装并配置 oh-my-opencode：https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
执行后，它就会自己安装好，安装过程可能有 API key 的配置选项，可以选择配置，也可以不配置：
认识 11 位 AI 团队成员（Agent）
OmO 内置了 11 个专门的 Agent，各司其职：
核心 Agent
| Agent | 角色 | 默认模型 | 什么时候用 |
|---|---|---|---|
| Sisyphus | 主协调者、全能开发 | Claude Opus | 所有任务的入口，自动调度其他 Agent |
| Prometheus | 战略规划师 | Claude Opus / GPT-5.4 | 复杂任务的计划制定 |
| Atlas | 待办任务管理 | Kimi K2.5 | 跟踪多步骤任务进度 |
专业 Agent
| Agent | 角色 | 默认模型 | 擅长什么 |
|---|---|---|---|
| Hephaestus | 深度自主工作者 | GPT-5.3-codex | 长时间、高强度的独立编码任务 |
| Oracle | 架构顾问/调试专家 | GPT-5.4 | 系统设计、疑难 bug 定位 |
| Momus | 高精度审查员 | GPT-5.4 | 代码 review、输出验证 |
| Metis | 计划评审 | Claude Opus | 检查 Prometheus 的计划是否有遗漏 |
工具型 Agent（快速、低成本）
| Agent | 角色 | 默认模型 | 为什么用便宜模型 |
|---|---|---|---|
| Explore | 代码库快速搜索 | MiniMax / Grok Code Fast | 搜索任务不需要高智能，速度更重要 |
| Librarian | 文档/代码检索 | MiniMax（免费） | 文档检索不需要深度推理 |
| Multimodal Looker | 截图/视觉分析 | Kimi K2.5 | Kimi 擅长多模态理解 |
💡 新手提示：你不需要手动选择 Agent。Sisyphus 会根据你的任务类型自动调度合适的 Agent 组合。
三种工作模式
模式一：ultrawork（最轻松）
在提示词里加 ultrawork 或 ulw，一切自动化：
ultrawork 帮我把这个 React 组件改成 TypeScript
适合：日常开发任务，希望 AI 全自动完成的场景。
模式二：Prometheus 计划模式（最精准）
按 Tab 键 进入 Prometheus 模式。AI 会先通过问答了解你的需求，生成详细执行计划，确认后再开始执行。
流程：
- 按
Tab切换到 Prometheus 模式 - 描述你的需求，AI 会问你一些澄清问题
- AI 生成执行计划，你确认
- 输入
/start-work开始执行
适合：复杂功能开发、架构重构等需要精确规划的场景。
模式三：普通对话（最灵活）
直接输入你的问题或需求，不加任何关键词：
解释一下 src/auth.ts 里的 JWT 验证逻辑
适合：问问题、代码解释、小修改等轻量任务。
配置文件详解
OmO 有两个配置文件，优先级不同：
- 项目级配置（优先级更高）：.opencode/oh-my-opencode.jsonc
- 用户级配置（全局默认）：~/.config/opencode/oh-my-opencode.jsonc
配置文件支持注释（JSONC 格式），也支持 JSON Schema 自动补全：
{
"$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
"agents": {
// 主协调 Agent，建议用 Claude Opus 系列或 Kimi
"sisyphus": {
"model": "anthropic/claude-opus-4-6"
},
// 架构顾问，建议用 GPT 系列
"oracle": {
"model": "openai/gpt-5.4",
"variant": "high"
}
}
}
新手建议：安装完成后先不要修改配置，默认设置已经很好。
常用命令速查表
| 命令 | 说明 |
|---|---|
opencode |
启动 OmO |
bunx oh-my-opencode install |
安装/重新配置插件 |
bunx oh-my-opencode doctor |
诊断配置问题 |
opencode auth login |
登录 AI 提供商账号 |
opencode models |
查看所有可用模型 |
bunx oh-my-opencode refresh-model-capabilities |
刷新模型能力缓存 |
在对话界面内：
| 快捷键/命令 | 说明 |
|---|---|
Tab |
切换到 Prometheus 计划模式 |
/start-work |
在 Prometheus 模式下开始执行计划 |
ultrawork / ulw |
在提示词里加上，激活全功能并行模式 |
常见问题排查
Q：安装后运行 opencode 没有看到 OmO 的功能
解决：检查配置文件是否正确注册了插件：
cat ~/.config/opencode/opencode.json
确认 plugin 字段包含 "oh-my-opencode"。如果没有，重新运行 bunx oh-my-opencode install。
Q：运行时提示 "Using legacy package name" 警告
解决：把 opencode.json 中的插件名从 "oh-my-opencode" 更新为 "oh-my-openagent"：
{
"plugin": ["oh-my-openagent"]
}
Q：Sisyphus Agent 效果很差，感觉和普通 Claude 差不多
原因：可能没有使用 Claude Opus 模型，或没有在提示词中加 ultrawork。
解决：
- 确认已登录 Claude Pro/Max 账号
- 在提示词中加入
ultrawork关键词 - 运行
bunx oh-my-opencode doctor检查模型配置
Q：任务执行到一半停了
解决：继续提示 ultrawork 继续之前的任务，Sisyphus 会通过 Todo 系统恢复进度。
Q：想禁用匿名遥测数据
OmO 默认启用了匿名遥测（使用 PostHog，数据经过哈希处理）。如需关闭：
export OMO_SEND_ANONYMOUS_TELEMETRY=0 # 或 export OMO_DISABLE_POSTHOG=1
❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄
💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍
🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
4
0- 0
已为社区贡献231条内容
所有评论(0)