OpenCode oh-my-openagent Nutzungs-Tutorial
Oh My OpenAgent(abgekürzt alsOmO) ist ein Open-Source-Erweiterungs-Plugin für KI-Programmierassistenten, früher genanntoh-my-opencode。
oh-my-openagent läuft auf OpenCode, dem KI-Programmierwerkzeug, auf und verwandelt es in11 professionelle KI-Agenten,die ein Entwicklungsteam bilden.
In einem Satz erklärt:
Du sendest eine Anfrage → OmO orchestriert automatisch mehrere KIs, die parallel arbeiten → Um ein Vielfaches schneller als eine einzelne KI
Verzeichnet derzeit auf GitHub54k+ Stars, es ist das beliebteste OpenCode-Plugin.
- GitHub-URL:https://github.com/code-yeongyu/oh-my-openagent
- Offizielle Website:https://ohmyopenagent.com/zh
Installation
Kopiere den folgenden Prompt und füge ihn in dein LLM-Tool ein (OpenCode, Claude Code, AmpCode, Cursor usw.):
按照此链接说明安装并配置 oh-my-opencode:https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Nach der Ausführung installiert es sich selbst. Während der Installation kann es API-Schlüssel-Konfigurationsoptionen geben; du kannst sie konfigurieren oder nicht:

Lerne die 11 KI-Teammitglieder kennen (Agenten)
OmO hat 11 spezialisierte Agenten integriert, jeder mit seiner eigenen Rolle:
Kern-Agenten
| Agent | Rolle | Standardmodell | Wann verwenden |
|---|---|---|---|
| Sisyphus | Hauptkoordinator, Allround-Entwickler | Claude Opus | Einstiegspunkt für alle Aufgaben, orchestriert automatisch andere Agenten |
| Prometheus | Strategischer Planer | Claude Opus / GPT-5.4 | Planung für komplexe Aufgaben |
| Atlas | Todo-Aufgabenverwaltung | Kimi K2.5 | Fortschritt mehrstufiger Aufgaben verfolgen |
Professionelle Agenten
| Agent | Rolle | Standardmodell | Spezialisiert auf |
|---|---|---|---|
| Hephaestus | Hochgradig autonomer Worker | GPT-5.3-codex | Lang andauernde, hochintensive unabhängige Coding-Aufgaben |
| Oracle | Architekturberater/Debugging-Experte | GPT-5.4 | Systemdesign, Auffinden schwieriger Bugs |
| Momus | Hochpräziser Reviewer | GPT-5.4 | Code-Review, Ausgabeverifizierung |
| Metis | Planüberprüfung | Claude Opus | Prüfen, ob der Plan von Prometheus Auslassungen enthält |
Werkzeug-Agenten (Schnell, kostengünstig)
| Agent | Rolle | Standardmodell | Warum günstige Modelle verwenden |
|---|---|---|---|
| Explore | Schnelle Codebasis-Suche | MiniMax / Grok Code Fast | Suchaufgaben erfordern keine hohe Intelligenz; Geschwindigkeit ist wichtiger |
| Librarian | Dokument-/Code-Abruf | MiniMax (Kostenlos) | Dokumentenabruf erfordert kein tiefgehendes Reasoning |
| Multimodal Looker | Screenshot/visuelle Analyse | Kimi K2.5 | Kimi ist hervorragend im multimodalen Verständnis |
💡 Anfängertipp: Du musst Agenten nicht manuell auswählen. Sisyphus orchestriert automatisch die passende Agent-Kombination basierend auf deinem Aufgabentyp.
Drei Arbeitsmodi
Modus 1: ultrawork (Am einfachsten)
Zum Prompt hinzufügenultraworkoderulw, alles ist automatisiert:
ultrawork 帮我把这个 React 组件改成 TypeScript
Geeignet für: tägliche Entwicklungsaufgaben, Szenarien, in denen Sie möchten, dass die KI alles automatisch erledigt.
Modus 2: Prometheus-Planungsmodus (Am präzisesten)
Drücken SieTab-Taste, um den Prometheus-Modus zu betreten. Die KI versteht zunächst Ihre Anforderungen durch Fragen und Antworten, erstellt einen detaillierten Ausführungsplan und startet die Ausführung, nachdem Sie bestätigt haben.
Workflow:
- drücken
TabZum Prometheus-Modus wechseln - Beschreiben Sie Ihre Anforderungen; die KI stellt Ihnen einige klärende Fragen
- KI generiert einen Ausführungsplan, Sie bestätigen
- Enter
/start-workum mit der Ausführung zu beginnen
Geeignet für: komplexe Feature-Entwicklung, Architektur-Refactoring und andere Szenarien, die eine präzise Planung erfordern.
Modus 3: Normale Konversation (Am flexibelsten)
Geben Sie Ihre Frage oder Anforderung direkt ein, ohne Schlüsselwörter hinzuzufügen:
解释一下 src/auth.ts 里的 JWT 验证逻辑
Geeignet für: leichte Aufgaben wie Fragen stellen, Code-Erklärung und kleine Änderungen.
Details zur Konfigurationsdatei
OmO hat zwei Konfigurationsdateien mit unterschiedlichen Prioritäten:
- Projektweite Konfiguration (höhere Priorität):.opencode/oh-my-opencode.jsonc
- Benutzerweite Konfiguration (globale Standardeinstellung):~/.config/opencode/oh-my-opencode.jsonc
Konfigurationsdateien unterstützen Kommentare (JSONC-Format) und JSON-Schema-Autovervollständigung:
{
"$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"
}
}
}
Hinweis für Anfänger: Ändern Sie die Konfiguration nicht direkt nach der Installation; die Standardeinstellungen sind bereits gut.
Kurzreferenz für gängige Befehle
| Befehl | Beschreibung |
|---|---|
opencode |
OmO starten |
bunx oh-my-opencode install |
Plugin installieren/neu konfigurieren |
bunx oh-my-opencode doctor |
Konfigurationsprobleme diagnostizieren |
opencode auth login |
Beim KI-Anbieterkonto anmelden |
opencode models |
Alle verfügbaren Modelle anzeigen |
bunx oh-my-opencode refresh-model-capabilities |
Cache für Modellfähigkeiten aktualisieren |
Innerhalb der Konversationsoberfläche:
| Tastenkürzel/Befehl | Beschreibung |
|---|---|
Tab |
Zum Prometheus-Planungsmodus wechseln |
/start-work |
Mit der Ausführung des Plans im Prometheus-Modus beginnen |
ultrawork / ulw |
Zum Prompt hinzufügen, um den vollfunktionsfähigen Parallelmodus zu aktivieren |
Fehlerbehebung bei häufigen Problemen
F: Nach der Installation, beim Ausführenopencodezeigt keine OmO-Funktionen an
Lösung: Prüfen Sie, ob das Plugin korrekt in der Konfigurationsdatei registriert ist:
cat ~/.config/opencode/opencode.json
BestätigenpluginFeld enthält"oh-my-opencode". Falls nicht, erneut ausführenbunx oh-my-opencode install。
F: Laufzeitwarnung "Using legacy package name"
Lösung: Ändernopencode.jsonden Plugin-Namen in ... von"oh-my-opencode"auf"oh-my-openagent":
{
"plugin": ["oh-my-openagent"]
}
F: Sisyphus Agent schneidet schlecht ab, fühlt sich an wie normales Claude
Ursache: Möglicherweise wird das Claude Opus-Modell nicht verwendet oder nicht hinzugefügtultrawork。
Lösung:
- Bestätigen Sie, dass Sie bei einem Claude Pro/Max-Konto angemeldet sind
- Add
ultraworkSchlüsselwort zum Prompt - Führen Sie
bunx oh-my-opencode doctorum die Modellkonfiguration zu überprüfen
F: Aufgabe stoppt mittendrin
Lösung: Weiter promptenultrawork 继续之前的任务, Sisyphus setzt den Fortschritt über das Todo-System fort.
F: Möchten Sie anonyme Telemetriedaten deaktivieren
OmO aktiviert standardmäßig anonyme Telemetrie (verwendet PostHog, Daten werden gehasht). Um sie zu deaktivieren:
export OMO_SEND_ANONYMOUS_TELEMETRY=0 # 或 export OMO_DISABLE_POSTHOG=1Andere Erweiterungen