快速开始
快速开始
5 分钟内让 Oh My OpenAgent 运行起来。两种安装方式 — 让代理安装,或者自己动手。
前置条件
- 已安装并配置 OpenCode
- 至少拥有一个 LLM 订阅并具有 API 访问权限(Claude、ChatGPT、Kimi、GLM 等)
安装
方式 A:代理辅助安装(推荐)
复制以下提示词并粘贴到你的 LLM 代理(Claude Code、AmpCode、Cursor 等):
Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md
代理将:
- 下载并安装
oh-my-opencode包 - 在
opencode.json中注册插件 - 设置默认配置
方式 B:手动安装
按照 安装指南 逐步操作。
首次运行:ultrawork
安装完成后,立即尝试 ultrawork:
ultrawork
或者使用更短的别名:
ulw
一个词激活所有代理。它们不会停止,直到任务完成。
推荐订阅
Oh My OpenAgent 与以下订阅配合良好(非合作关系,个人推荐):
| 订阅 | 价格 | 说明 |
|---|---|---|
| ChatGPT | $20/月 | 稳定的多代理体验 |
| Kimi Code | $0.99/月 | 超高性价比,限时优惠价 |
| GLM 编码计划 | $10/月 | 适合 GLM 模型访问 |
如果你有按 token 计费的访问权限,Kimi 和 Gemini 模型非常经济实惠。
验证安装
运行内置的诊断命令:
bunx oh-my-opencode doctor
它会检查:
opencode.json中的插件注册- 配置文件有效性
- 模型可用性和 API 密钥
- 环境设置
上下文注入
Oh My OpenAgent 自动向每个会话注入上下文:
- AGENTS.md — 分层项目上下文(参见 /init-deep)
- README.md — 项目概览
- 条件规则 — 根据文件类型、代理或任务阶段自动激活
遥测
默认通过 PostHog 启用匿名遥测。它使用哈希化的安装标识符 — 不会使用你的原始主机名。
禁用方法:
export OMO_SEND_ANONYMOUS_TELEMETRY=0
# 或
export OMO_DISABLE_POSTHOG=1
详见 隐私政策。
卸载
要移除 Oh My OpenAgent:
- 移除插件条目,从
opencode.json中:
# 使用 jq
jq '.plugin = [.plugin[] | select(. != "oh-my-openagent" and . != "oh-my-opencode")]' \
~/.config/opencode/opencode.json > /tmp/oc.json && \
mv /tmp/oc.json ~/.config/opencode/opencode.json
- 移除配置文件(可选):
rm -f ~/.config/opencode/oh-my-openagent.jsonc ~/.config/opencode/oh-my-openagent.json \
~/.config/opencode/oh-my-opencode.jsonc ~/.config/opencode/oh-my-opencode.json
rm -f .opencode/oh-my-openagent.jsonc .opencode/oh-my-openagent.json \
.opencode/oh-my-opencode.jsonc .opencode/oh-my-opencode.json
- 验证移除:
opencode --version— 插件不应再出现。