Wonda CLI
Wonda CLI ist ein Toolkit zur Inhaltserstellung für terminalbasierte KI-Agenten. Verwenden Sie es, um Bilder, Videos, Musik und Audio zu generieren; Medien zu bearbeiten und zu erstellen; auf sozialen Plattformen zu veröffentlichen; und LinkedIn, Reddit sowie X/Twitter zu recherchieren und zu automatisieren.
Installation
Falls wonda nicht im PATH gefunden wird, installieren Sie es zuerst:
# npm
npm i -g @degausai/wonda
# Homebrew
brew tap degausai/tap && brew install wonda
Einrichtung
- Authentifizierung:
wonda auth login(öffnet Browser, empfohlen) oder setzen Sie die UmgebungsvariableWONDA_API_KEY - Überprüfung:
wonda auth check
OAuth-Connector-Authentifizierung
Claude Web und Cowork-Connectors verwenden den OAuth 2.1-Flow von Wonda anstelle eines CLI-API-Key-Feldes. Der Connector meldet sich über Wonda im Browser an, gewährt den angeforderten Kontozugriff und erhält OAuth-Tokens, die an die Wonda-API-Ressource gebunden sind. Der Server tauscht diese Tokens nur innerhalb von Wonda gegen den internen API-Key des Kontos aus, sodass Agenten und Connector-Hosts niemals den sk_...-Key sehen. Für den CLI- und lokalen stdio-MCP-Pfad verwenden Sie weiterhin wonda auth login oder WONDA_API_KEY.
Claude Cowork Local Relay
Claude Cowork (die Desktop-App) führt lokale MCP-Server auf dem Host aus, sodass sie das .mcpb-Bundle oder eine lokale stdio-wonda-mcp-Konfiguration direkt laden kann (inklusive WAB-Schreibvorgänge, verifiziert am 07.07.2026). Claude Web kann das nicht. Der Wonda Local Relay ist der alternative Pfad: Er ermöglicht es dem REMOTE-Connector (Web oder Cowork), Aktionen auf dem eigenen Mac des Benutzers und der privaten IP auszuführen, ohne dass eine lokale MCP-Konfiguration erforderlich ist:
- Öffnen Sie
https://wonda.sh/downloadwährend Sie angemeldet sind und installieren Sie das notarisierte Mac-Paket. - Koppeln Sie den Relay mit
wonda relay pairoder dem Browser-Handoff beim ersten Start. Dabei wird der bestehendecli-auth-Flow mit einem Relay-bezogenenwrelay_...-Credential verwendet, das in der macOS-Tresorverwaltung gespeichert wird. Bitten Sie den Benutzer nicht, einen API-Key oder Gerätecode einzufügen. - Öffnen Sie
https://wonda.sh/setup, verbinden Sie LinkedIn, X und Reddit über den headful lokalen WAB, und genehmigen Sie dann den Wonda-Connector einmal in Claude.
Die Engine-Policy lautet auto | my_machine | cloud. auto verwendet den lokalen Relay, wenn er online ist, andernfalls die Cloud. my_machine darf nicht stillschweigend zurückfallen: Wenn der Relay offline ist, fragen Sie, ob zur Cloud gewechselt werden soll.
Organisationen & Ausgabenkontext
Wondercat-Organisationen sind gemeinsame Wallets mit eigenen Plätzen und Abrechnung. Mitglieder können aus dem Organisations-Wallet (anstelle ihrer persönlichen Credits) ausgeben, indem sie den Kontext wechseln:
wonda organizations list(Aliase:wonda orgs list,wonda org list) – zeigt jede Organisation, in der Sie Mitglied sind, mit Ihrer Rolle und Ihrem Sitzplatzplan.wonda use --org <slug>– setzt den Organisationskontext für diesen Rechner. FügtX-Wonda-Orgzu jeder Anfrage hinzu; Buchungen, Belastungen undwonda balancelaufen über das Organisations-Wallet.wonda use --personal– zurück zum persönlichen Kontext.wonda usage– ausgabenbezogene Nutzungsübersicht (Gesamtsumme + Aufschlüsselung nach Modell und Projekt) für einen Zeitraum (--month 2026-05, oder--from/--to; Standard ist der aktuelle Monat, UTC).--project <name>schränkt den Bericht auf ein Projekt ein. Im Organisationskontext wird der organisationsweite Verbrauch einschließlich einer Aufschlüsselung pro Mitglied gemeldet – Admin/Besitzer-Rolle erforderlich. Admins können auch einen vollständigen Excel-Bericht von der Organisationsseite im Web herunterladen.
Projekte (Ausgaben-Tagging)
Projekte ordnen Ausgaben einem benannten Arbeitsbereich zu, um die Überwachung zu erleichtern. Agenten sollten das aktive Projekt zu Beginn einer Aufgabe überprüfen (wonda use gibt es aus) und eines pro Aufgabe setzen, wenn der Betreiber die Ausgaben nach Projekt überwacht:
wonda use --project <name>– dauerhaft: jede nachfolgende Belastung trägt das Projekt (inwonda usage, der API und dem Organisations-Excel-Bericht).wonda use --no-projectbeendet das Tagging; ein Wechsel des Organisations-/persönlichen Kontexts löscht das Projekt automatisch (Projekte sind kontextbezogen).--project <name>bei jedem Befehl – einmalige Überschreibung für diesen Aufruf.wonda project list|create|delete– Verwaltung des Registers im aktiven Kontext. Organisationsprojekte werden nur von Organisations-Admins/Besitzern erstellt; persönliche Projekte sind Selbstbedienung. Das Tagging mit einem Namen, der nicht existiert, schlägt mitunknown_projectfehl (keine stillen neuen Eimer, sodass Tippfehler die Überwachungsdaten nicht aufspalten können).
wonda topup lädt immer Ihr persönliches Wallet auf, unabhängig vom Kontext. Das Aufladen des Organisations-Wallets (und die Konfiguration von automatischen Aufladungen) ist nur für Admins möglich und erfolgt im Web unter /organizations/<slug>. Wenn einem Mitglied die Organisations-Credits ausgehen, teilt der Fehler mit, dass es einen Admin bitten soll oder zum persönlichen Kontext zurückwechseln kann – es kann das Organisations-Wallet nicht über die CLI aufladen.
Rollen innerhalb einer Organisation sind getrennt vom Sitzplatzplan:
- Besitzer: der ursprüngliche Ersteller. Kann nicht degradiert oder entfernt werden. Kann das Eigentum an ein anderes Mitglied von der Organisationsseite übertragen (selten).
- Admin: kann einladen (einzeln oder per Bulk-Einfügen), entfernen, Rollen ändern, Sitzplätze ändern, aufladen, automatische Aufladungen konfigurieren, monatliche Limits ändern.
- Benutzer: kann nur innerhalb des Organisations-Wallets ausgeben (vorbehaltlich eines monatlichen Limits pro Mitglied, falls vom Admin festgelegt).
Ein bezahlter Organisationssitz (WONDA / WONDA_PREMIUM) gewährt den gleichen Zugriff auf kostenpflichtige Funktionen (Skills usw.) wie ein persönlicher bezahlter Plan, jedoch nur im Organisationskontext. wonda use --personal fällt auf den persönlichen Account-Plan des Benutzers zurück.
Zugriffsstufen
Wonda ist kostenpflichtig: Jede Produktoberfläche (Generierung, Medien, Veröffentlichung, Scraping, Analyse, Skills, Cloud-Twin) erfordert einen kostenpflichtigen Plan. Neue Konten erhalten keine Credits und keinen Produktzugriff, bis sie ein Abonnement abschließen.
| Stufe | Zugriff |
|---|---|
| Anonym (temporäres Konto, kein Login) | Kein Produktzugriff. Die CLI erstellt beim ersten Start ein temporäres Konto, erreicht aber nur die unten aufgeführten lokalen Befehle sowie die Authentifizierungs-/Abrechnungsendpunkte. Führen Sie wonda auth login aus und abonnieren Sie dann. |
| Kostenlos (eingeloggt, kein kostenpflichtiger Plan) | Kein Produktzugriff. Abonnieren Sie unter https://wonda.sh/account, um das Produkt zu nutzen. |
WONDA ($19.99/Monat, "Pro") | Alles außer Cloud-Twin: Generierung (image/generate, video/generate, ...), Medien-Upload/-Download, Veröffentlichung, Scraping, Analysen, Videoanalyse, Skills (wonda skill install/list/get), Übergänge, Ausschneiden, E-Mail, Reddit-/LinkedIn-Kontoerstellung, Styles, Brand. |
WONDA_PREMIUM ($49.99/Monat, "Premium") | Alles in WONDA, plus Cloud-Twin (wonda twin: Bereitstellung, geplante Läufe, gestreamter Login) mit Antidetect-/Schattenbannschutz, keine Limits und US-Kontoerstellung. |
| Gekennzeichnet (pro-Konto PostHog-Kill-Switches) | Im kostenpflichtigen Plan enthalten, aber dennoch durch ein pro-Konto-Flag steuerbar: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), öffentliche LinkedIn-Profilanreicherung (linkedinProfileEnrichmentEnabled). |
| Lokal (kein API-Aufruf, keine Credits, kein Plan) | Läuft vollständig auf Ihrem Rechner, funktioniert also ohne Plan: wonda brand extract <url> (ohne --save), wonda compose motion/wonda compose text, wonda wab record <url>, wonda edit ... ffmpeg-Primitivtransformationen auf lokalen Dateien und wonda doctor. Die Chromium-basierten benötigen eine einmalige wonda wab install. |
Wenn ein Befehl einen 403 (paid_plan_required) zurückgibt, abonnieren Sie unter https://wonda.sh/account.
Sprachklonung
Klonen Sie eine Stimme aus einem 10s+ Audio-Clip und verwenden Sie sie in TTS. Hartes Limit: 20 geklonte Stimmen pro Konto. Kosten: 1,50 $ pro Klon.
# Von einer lokalen Datei klonen (lädt automatisch zuerst in die Medienbibliothek hoch)
wonda voice create "Andu" --file ./sample.mp3 --description "Meine Stimme"
# Von vorhandenen Wonda-Medien klonen
wonda voice create "Brand" --media-id <uuid>
# Optionale Vorverarbeitung des Quell-Audios
wonda voice create "Clean" --file ./raw.wav --noise-reduction --normalize-volume
# Geklonte Stimmen auflisten (jede Zeile zeigt isExpired und expiresInDays)
wonda voice list
# Eine Stimme abrufen
wonda voice get <voice-id>
# Umbenennen / Neubeschreibung (lokal, kein Provider-Aufruf)
wonda voice update <voice-id> --name "Neuer Name" --description "..."
# Löschen
wonda voice delete <voice-id>
Eine geklonte Stimme in TTS verwenden, indem Sie die providerVoiceId aus voice get als voiceId an /audio/speech übergeben:
wonda audio speech "Hallo Welt" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
7-Tage-Verfall: Geklonte Stimmen, die innerhalb von 7 Tagen nicht in TTS verwendet wurden, laufen automatisch ab. Die Ausführung von TTS mit einer geklonten Stimme verlängert automatisch deren Verfallsdatum. Leerlaufende Stimmen, die ablaufen, müssen neu geklont werden (wieder 1,50 $).
Credentials-Vault
Speichern Sie Logins, die auf externen Plattformen (Instagram, TikTok, Twitter usw.) erstellt wurden, dauerhaft, sodass sie beim nächsten Durchlauf wiederverwendet werden können. Passwörter werden mit AES-256-GCM mit einem serverseitigen Schlüssel verschlüsselt und nur bei get entschlüsselt.
# Erstellen
wonda credentials create --website instagram.com --username meinbenutzername \
--email [email protected] --password-stdin <<< "geheim123" \
--metadata '{"signup_source":"wonda-email"}'
# Auflisten (Passwörter werden weggelassen)
wonda credentials list --website instagram.com
# Vollständigen Datensatz inklusive entschlüsseltem Passwort abrufen
wonda credentials get <id>
# Ein beliebiges Feld aktualisieren (--password-stdin zum Drehen; --username "" zum Löschen)
wonda credentials update <id> --username neuerbenutzername
# Löschen
wonda credentials delete <id>
# Abrufen + Grund für die Verwendung in einem Aufruf protokollieren – POST, nicht GET, weil
# es ein 'used'-Ereignis mit dem Grund schreibt. Bevorzugen Sie dies gegenüber `get`, wenn Sie
# den Grund angeben können.
wonda credentials use <id> --reason "instagram-anmelde-flow"
# Aktuelle Ereignisse (erstellt / verwendet / gedreht / aktualisiert) zur Prüfung anzeigen
wonda credentials events <id>
Felder: website (erforderlich – die Texteingabe wie insta wird zu instagram.com kanonisch normalisiert), username, email, password (erforderlich), metadata (beliebiges JSON). Mindestens eines von username/email muss vorhanden sein. Mehrere Datensätze pro (website, username) sind erlaubt – deduplizieren Sie bei Bedarf selbstständig.
Ereignisprotokoll: Jeder credentials get/use, create, Passwort-Drehung und andere Aktualisierungen werden als Ereignisse auf dem Credential protokolliert (Akteur: cli | web | system). Verwenden Sie credentials events <id> oder das Verlaufs-Symbol in der Weboberfläche zur Prüfung. Das Ereignisprotokoll ist anfügbar und wird beim Löschen von Credentials mitgelöscht.
Globale Ausgabeflags
Alle Befehle unterstützen diese Steuerungsflags für die Ausgabe:
--json– JSON-Ausgabe erzwingen (automatisch aktiviert, wenn stdout weitergeleitet wird)--quiet– Nur die primäre Kennung (Job-ID, Medien-ID usw.) ausgeben – ideal für Skripting-o <pfad>– Ausgabe in Datei herunterladen (impliziert--wait)--fields status,outputs– Bestimmte JSON-Felder auswählen--jq '.outputs[0].media.url'– JSON-Ausgabe mit einem jq-Ausdruck filtern
CLI-Ankündigungen & Veraltungswarnungen
Bei jedem Befehl fragt die CLI GET /api/v1/updates ab (anonym, 1h Cache in ~/.wonda/state.json) nach aktiven Ankündigungen: Veraltungshinweise, Vorfall-Hinweise, Upgrade-Aufforderungen. Nachrichten werden nur auf stderr ausgegeben, sodass stdout/JSON für die Weiterleitung sauber bleibt.
Veraltungshinweise pro Anfrage erscheinen als der standardmäßige HTTP-Header Warning: 299 - "<message>" und werden vom HTTP-Client der CLI als [deprecated METHOD /path] <message> auf stderr ausgegeben.
Beide Kanäle können mit WONDA_QUIET=1 (Umgebungsvariable) oder --quiet (Flag) stummgeschaltet werden. Nur die Netzwerkprüfungen werden mit WONDA_NO_UPDATE_CHECK=1 deaktiviert.
WAB / Wonda Automation Browser (wonda wab)
Der Wonda Automation Browser (WAB) ist ein Premium-Stealth-Antidetect-Browser, der so gehärtet ist, dass Plattformen ihn nicht als Automatisierung erkennen können. wonda wab ist der einzige Befehl für den Antidetect-Chromium-Stack (ein unerkannter Playwright-Fork). Er hat zwei Gesichter:
- Authentifizierte Sitzungen. Ein persistenter headful Chromium pro Persona, der angemeldete Sitzungen für LinkedIn, X, Reddit und Freunde hält. Die CLI startet ihn bei Bedarf, lässt ihn im Leerlauf auslaufen und leitet Plattform-Lese-/Schreibvorgänge durch ihn, wann immer ein Befehl mit
--via wabausgeführt wird. Cookies befinden sich im Chromium-Profil der Persona, nicht in~/.wonda/config.json. - Anonyme Erfassung.
wonda wab record <url>(undwonda brand extract) steuern einen ephemeren Chromium mit einem frischen Fingerabdruck, ohne Persona, ohne Cookies. Siehe denrecord-Block unten.
Das mentale Modell: Sie haben Konten (eine Identität pro Plattform). Jeder Plattformbefehl leitet zu den Cookies dieses Kontos entweder über den flachen JSON-Speicher (--via cookies, schnell, kein Chromium) oder über die Persona des Kontos (--via wab, Live-Antidetect-Chromium). Eine Persona ist die Chromium-Hülle, die mehrere Konten unter einem Fingerabdruck halten kann. In fast allen Fällen wird die Persona bei der ersten Verwendung von --via wab automatisch erstellt, benannt nach dem Konto, sodass Sie nie einen Persona-Namen eingeben müssen.
Die lokale wonda.mcpb-Desktop-Erweiterung verwendet diesen gleichen lokalen WAB-Pfad von Claude Desktop oder Claude Code: Plattform-Cookies bleiben auf dem Gerät, Lesevorgänge verwenden lokale Cookies und Schreibvorgänge verwenden den lokalen WAB. Claude Web und Cowork benötigen stattdessen den Remote-MCP-Connector.
Native Login-In...
[gekürzt für die Übersetzung]