KomeijiReimu的博客

KomeijiReimu笔记、博客与灵感。

opencode+omo

1,208 字7分钟阅读

安装

https://github.com/code-yeongyu/oh-my-openagent/blob/dev/README.zh-cn.md

根据官方文档的说法，他建议让 agent 帮你安装。

omo安装

给人类看的 复制并粘贴以下提示词到你的 LLM Agent (Claude Code, AmpCode, Cursor 等):

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

然而我并不建议你这么做。因为他的一键安装流程会询问你是否有多种不同的模型订阅，然而我们并没有，并且他自动配置的多 agent 默认使用的供应商是官方途径，同时我们也要对他的子 agent 进行一些修改，因此我建议手动安装。

手动安装

莎士比亚

高傲的 omo 在最新版的 README 中删除了手动安装的指南跳转链接，他们有一种蜜汁自信，认为自己写的提示词就是天下无敌。

The TUI walks you through it. Do NOT use npm install -g, bun add -g, or bun install -g — global installation is not officially supported. oh-my-openagent is a plugin that must resolve from where OpenCode/Codex loads plugins, and the prepare script requires Bun. Always invoke via bunx.

但是他们至少终于知道在文档中说明了 opencode 插件的工作方式。

运行下面的命令安装 omo 的CLI，注意，这不是插件本体。

bunx oh-my-openagent install
 
# 如果上面那个报错就试试下面这种写法
bun x oh-my-openagent install

实际上真正的插件安装只取决于 opencode 配置文件中的插件配置数组，因此我们查看 opencode.jsonc 是否有如下字段：

"plugin": [
    "oh-my-openagent@latest",
]

添加上述字段之后打开 opencode，会黑屏一段时间，这是 opencode 在下载 omo 插件本体。确保网络畅通，过了一会儿打开之后能在输入框下面看到 Sisyphus 即为安装成功。

之后我们直接在 opencode 的配置目录添加 omo 的配置 oh-my-openagent.json 并重启 opencode。

下列配置实现了 claude 指挥 chatgpt，其中 / 前代表供应商名称，后面表示使用的模型名称。与官方推荐不同的是，我将负责审计的 Oracle 思考强度调整到了 xhigh，负责直接写代码的 sisyphus-junior 思考强度调整到了 high。

有关更多 agent 适合的模型以及 omo 的完整体配置，请查阅官方文档

{
    "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/dev/assets/oh-my-opencode.schema.json",
    "agents": {
        "sisyphus": {
            "model": "codelink-claude/claude-opus-4-8"
        },
        "hephaestus": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "medium"
        },
        "oracle": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "xhigh"
        },
        "explore": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "low"
        },
        "multimodal-looker": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "medium",
            "fallback_models": [
                {
                    "model": "codelink-gpt/gpt-5.5",
                    "variant": "low"
                }
            ]
        },
        "prometheus": {
            "model": "codelink-claude/claude-opus-4-8"
        },
        "metis": {
            "model": "codelink-claude/claude-opus-4-8"
        },
        "momus": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "xhigh"
        },
        "atlas": {
            "model": "codelink-claude/claude-sonnet-4-6"
        },
        "sisyphus-junior": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "high",
            "permission": {
                "edit": "allow",
                "bash": "allow",
                "webfetch": "allow"
            }
        },
        "librarian": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "low"
        }
    },
    "categories": {
        "visual-engineering": {
            "model": "codelink-claude/claude-opus-4-8"
        },
        "ultrabrain": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "xhigh"
        },
        "deep": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "high"
        },
        "quick": {
            "model": "codelink-gpt/gpt-5.5",
            "variant": "low"
        },
        "unspecified-low": {
            "model": "codelink-claude/claude-sonnet-4-6"
        },
        "unspecified-high": {
            "model": "codelink-claude/claude-opus-4-8"
        },
        "writing": {
            "model": "codelink-claude/claude-sonnet-4-6"
        },
        "artistry": {
            "model": "codelink-claude/claude-opus-4-8"
        }
    },
    "tmux": {
        "enabled": true,
        "layout": "main-vertical",
        "main_pane_size": 60
    }
}

如何更新

请查看此文章omo更新失效。

配置与使用

tmux集成

omo 支持 tmux 集成，即每次调用子 agent 之后都会自动多开几个 pane，方便你随时掌握子 agent 的工作情况。

在 oh-my-openagent.json 中添加如下字段：

"tmux": {
    "enabled": true,
    "layout": "main-vertical",
    "main_pane_size": 60
}

tmux 集成异常/无法生效？

请查阅omo的Tmux集成失效。

高级功能

最新版更新了一个团队模式，我不懂是什么情况。

我在使用 omo 的时候，主要用法如下：

  • ulw

在对话前输入 ulw 这个魔法词就能激活他的火力全开模式，有什么用？有魔法了可能是。

  • ralph-loop / ulw-loop

在没达成目的之前自动继续，直到全部完成任务后再停止。如果玩好了可以让他连续工作几十个小时。

ulw-loop 就是在每次循环的时候激活 ulw 模式。

更多的，可以阅读这里面的核心亮点。

快速切换agent配置

你可以搞个 py 脚本，提前准备好多种组合方式，要用哪一种直接用脚本覆盖即可，比如下面这种： 

import sys
import shutil
from pathlib import Path
 
 
def main():
    if len(sys.argv) < 2:
        print("请提供数字参数喵，例如: python script.py 1")
        sys.exit(1)
 
    num_param = sys.argv[1]
 
    # 获取当前脚本所在的绝对目录
    script_dir = Path(__file__).resolve().parent
 
    # 构造通配符查找模式，忽略连字符后面的备注内容
    search_pattern = f"oh-my-openagent.json-{num_param}*"
    matching_files = list(script_dir.glob(search_pattern))
 
    if not matching_files:
        print(f"没有找到匹配的文件喵！请确认源文件是否存在。")
        sys.exit(1)
 
    # 直接取第一个匹配到的文件作为源文件
    source_file = matching_files[0]
 
    # 定义目标路径: ~/.config/opencode/oh-my-openagent.json
    target_dir = Path.home() / ".config" / "opencode"
    target_file = target_dir / "oh-my-openagent.json"
 
    # 确保目标目录存在，如果不存在则自动创建
    target_dir.mkdir(parents=True, exist_ok=True)
 
    # 复制并覆盖目标文件，copy2会尽可能保留文件的元数据
    shutil.copy2(source_file, target_file)
    print(f"替换完成喵！已经将 {source_file.name} 覆盖写入到 {target_file}")
 
 
if __name__ == "__main__":
    main()

反向链接