Wonda CLI
Wonda CLI ist ein Toolkit zur Inhaltserstellung für terminalbasierte Agenten. Damit können Sie Bilder, Videos, Musik und Audio generieren, Medien bearbeiten und zusammenstellen, auf sozialen Plattformen veröffentlichen sowie auf LinkedIn, Reddit und X/Twitter recherchieren und automatisieren.
Installation
Wenn wonda nicht im PATH gefunden wird, installieren Sie es zuerst. Die empfohlenen Installationen sind die signierten Desktop-Installer (CLI + Tray-Icon + Always-On-Relay, ohne zusätzliche Schritte): macOS brew install --cask degausai/tap/wonda-app (oder die wonda-macos.pkg aus den Releases), Windows winget/wonda-windows-setup.exe. Die reinen CLI-Kanäle unten funktionieren überall und können später die Desktop-App mit wonda app install hinzufügen:
# 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-Schlüsselfelds. Der Connector meldet sich über Wonda im Browser an, gewährt den angeforderten Kontozugriff und erhält OAuth-Token, die an die Wonda-API-Ressource gebunden sind. Der Server tauscht diese Token nur innerhalb von Wonda gegen den internen API-Schlüssel des Kontos aus, sodass Agenten und Connector-Hosts den sk_...-Schlüssel nie sehen. Für den CLI- und lokalen stdio-MCP-Pfad verwenden Sie weiterhin wonda auth login oder WONDA_API_KEY.
Claude Cowork lokales Relay
Claude Cowork (die Desktop-App) führt lokale MCP-Server auf dem Host aus, sodass es 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. Das lokale Relay von Wonda ist der alternative Pfad: Es ermöglicht dem REMOTE-Connector (Web oder Cowork), Aktionen auf dem eigenen Mac des Benutzers und der eigenen IP auszuführen, ohne lokale MCP-Konfiguration:
- Öffnen Sie
https://wonda.sh/downloadwährend Sie angemeldet sind und installieren Sie das notarisierte Mac-Paket. - Koppeln Sie das Relay mit
wonda relay pairoder dem Browser-Handoff beim ersten Start. Dies verwendet den vorhandenencli-auth-Flow mit einer Relay-bezogenenwrelay_...-Anmeldeinformation, die in der macOS-Tastaturverwaltung gespeichert wird. Fordern Sie den Benutzer nicht auf, einen API-Schlüssel oder Gerätecode einzugeben. - Öffnen Sie
https://wonda.sh/setup, verbinden Sie LinkedIn, X und Reddit über den lokalen WAB, und genehmigen Sie dann den Wonda-Connector einmal in Claude.
Die Engine-Richtlinie ist auto | my_machine | cloud. auto verwendet das lokale Relay, wenn es online ist, andernfalls die Cloud. my_machine darf nicht stillschweigend zurückfallen: Wenn das Relay offline ist, fragen Sie, ob zur Cloud gewechselt werden soll.
Organisationen & Ausgabenkontext
Wondercat-Organisationen sind gemeinsame Geldbörsen mit eigenen Plätzen und Abrechnung. Mitglieder können aus dem Organisations-Wallet ausgeben (anstelle ihrer persönlichen Guthaben), indem sie den Kontext wechseln:
wonda organizations list(Aliase:wonda orgs list,wonda org list) — zeigt jede Organisation an, der Sie angehören, mit Ihrer Rolle und Ihrem Sitzplatzplan.wonda use --org <slug>— klebt den Organisationskontext für diese Maschine. SetztX-Wonda-Orgbei jeder Anfrage; Kontostand, Belastungen undwonda balancelaufen über das Organisations-Wallet.wonda use --personal— zurück zu persönlich.wonda usage— ausgabenbezogene Nutzungsübersicht (Gesamt + Aufschlüsselung pro Modell + Projekt) für einen Zeitraum (--month 2026-05oder--from/--to; standardmäßig der aktuelle Monat, UTC).--project <name>schränkt den Bericht auf ein Projekt ein. Im Organisationskontext wird die organisationsweite Nutzung mit einer Aufschlüsselung pro Mitglied gemeldet – Administrator-/Inhaberrolle erforderlich. Administratoren können auch einen vollständigen Excel-Bericht von der Organisationsseite im Web herunterladen.
Projekte (Ausgaben-Tagging)
Projekte ordnen Ausgaben einem benannten Arbeitsstrom zu, um die Überwachung zu erleichtern. Agenten sollten zu Beginn einer Aufgabe das aktive Projekt überprüfen (wonda use zeigt es an) und eines pro Aufgabe setzen, wenn der Betreiber die Ausgaben nach Projekt überwacht:
wonda use --project <name>— klebt: Jede nachfolgende Belastung trägt das Projekt (inwonda usage, der API und dem Organisations-Excel-Bericht).wonda use --no-projectstoppt das Tagging; das Wechseln des Organisations-/persönlichen Kontexts löscht das Projekt automatisch (Projekte sind bereichsbezogen).--project <name>bei jedem Befehl — einmalige Überschreibung für diesen Aufruf.wonda project list|create|delete— verwalten Sie das Register im aktiven Bereich. Organisationsprojekte werden nur von Organisationsadministratoren/-inhabern erstellt; persönliche Projekte sind im Selbstbedienungsmodus. Das Taggen gegen einen nicht existierenden Namen schlägt mitunknown_projectfehl (keine stillen neuen Buckets, sodass Tippfehler die Überwachungsdaten nicht aufteilen können).
wonda topup lädt immer Ihr persönliches Wallet auf, unabhängig vom Kontext. Das Aufladen des Organisations-Wallets (und die Konfiguration des automatischen Aufladens) ist nur für Administratoren möglich und erfolgt im Web unter /organizations/<slug>. Wenn einem Mitglied die Organisationsguthaben ausgehen, teilt der Fehler ihm mit, einen Administrator zu fragen oder auf persönlich umzuschalten – es kann das Organisations-Wallet nicht über die CLI aufladen.
Rollen innerhalb einer Organisation sind vom Sitzplatzplan getrennt:
- Inhaber: Der ursprüngliche Ersteller. Kann nicht herabgestuft oder entfernt werden. Kann das Eigentum von der Organisationsseite auf ein anderes Mitglied übertragen (selten).
- Administrator: Kann einladen (einzeln oder per Masseneinfügen), entfernen, Rollen ändern, Sitzplätze ändern, aufladen, automatisches Aufladen konfigurieren, monatliche Limits ändern.
- Benutzer: Kann nur innerhalb des Organisations-Wallets ausgeben (vorbehaltlich eines vom Administrator festgelegten monatlichen Limits pro Mitglied).
Ein kostenpflichtiger Organisationssitz (WONDA / WONDA_PREMIUM) gewährt denselben Zugang zu kostenpflichtigen Funktionen (Skills usw.) wie ein persönlicher kostenpflichtiger Plan, jedoch nur im Organisationskontext. wonda use --personal fällt auf den persönlichen Kontoplan des Benutzers zurück.
Zugriffsstufen
Wonda ist kostenpflichtig: Jede Produktoberfläche erfordert einen kostenpflichtigen Plan, einschließlich API-Aufrufe, lokale Plattform-Lesevorgänge, Browser-Automatisierung, Medienkomposition, Dateibearbeitung, Diagnose, Generierung, Veröffentlichung, Scraping, Analyse, Skills, Relay-Betrieb und Cloud-Zwilling. Bevor ein Produktbefehl Arbeit verrichtet, führt die CLI eine Live-Berechtigungsprüfung gegen Wonda durch. Die Prüfung schlägt fehl, wenn der Zugriff nicht verifiziert werden kann. Neue Konten erhalten keinen Produktzugriff, bis sie ein Abonnement abschließen, und ein positives Guthaben ersetzt keinen Plan.
| Stufe | Zugriff |
|---|---|
| Anonym (kein Login) | Kein Produktzugriff. Authentifizierung, Konfiguration, Preise, Organisationserkennung/-auswahl, Shell-Vervollständigung und lokale Herunterfahrbefehle bleiben verfügbar, damit der Benutzer ein Abonnement abschließen, das Konto wiederherstellen oder Hintergrunddienste stoppen kann. Führen Sie wonda auth login aus und schließen Sie dann ein Abonnement ab. |
| 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-Zwilling: Generierung (image/generate, video/generate, ...), Medien hochladen/herunterladen, Veröffentlichen, Scraping, Analysen, Videoanalyse, Skills (wonda skill install/list/get), Übergänge, Clipping, E-Mail, Reddit/LinkedIn-Kontoerstellung, Stile, Marke. |
WONDA_PREMIUM (49,99 €/Monat, „Premium") | Alles in WONDA, plus Cloud-Zwilling (wonda twin: Provisionierung, geplante Ausführungen, gestreamter Login) mit Antidetect-/Shadowban-Schutz, ohne Obergrenzen und mit US-Kontoerstellung. |
| Markiert (pro-Konto PostHog-Kill-Switches) | Im kostenpflichtigen Plan enthalten, aber durch ein pro-Konto-Flag abschaltbar: wonda reddit signup (redditAccountCreationEnabled), wonda email (emailServerApiEnabled), öffentliche LinkedIn-Profilanreicherung (linkedinProfileEnrichmentEnabled). |
Wenn ein Befehl einen 403 (paid_plan_required) zurückgibt, abonnieren Sie unter https://wonda.sh/account.
Dies gilt auch für den lokalen stdio-MCP-Pfad, da MCP dieselbe CLI ausführt. Plattform-Cookies und -Daten bleiben auf dem Gerät, aber der Befehl muss zuerst eine erfolgreiche Entscheidung über den kostenpflichtigen Zugriff von GET /api/v1/auth/access erhalten. Eine reine Relay-Installation darf ihre bereichsbezogenen wrelay_...-Anmeldeinformationen für diese Berechtigungsprüfung verwenden. Die bereichsbezogenen Anmeldeinformationen können dennoch keine normalen Konten-APIs aufrufen.
Stimmklon
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 (automatischer Upload zur Medienbibliothek zuerst)
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
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>
Verwenden Sie eine geklonte Stimme in TTS, indem Sie die providerVoiceId von voice get als voiceId an /audio/speech übergeben:
wonda audio speech "Hallo Welt" \
--model minimax-speech-2-8-hd \
--params '{"voiceId":"<providerVoiceId>"}'
7-Tage-Ablauf: Geklonte Stimmen, die nicht innerhalb von 7 Tagen in TTS verwendet wurden, laufen automatisch ab. Die Ausführung von TTS mit einer geklonten Stimme verlängert deren Ablauf automatisch. Leerlaufende Stimmen, die verfallen, müssen erneut geklont werden (erneut 1,50 $).
Anmeldeinformations-Tresor
Speichern Sie Logins, die auf externen Plattformen (Instagram, TikTok, Twitter usw.) erstellt wurden, damit sie beim nächsten Lauf 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 myhandle \
--email [email protected] --password-stdin <<< "hunter2" \
--metadata '{"signup_source":"wonda-email"}'
# Auflisten (Passwörter ausgelassen)
wonda credentials list --website instagram.com
# Vollständigen Datensatz einschließlich entschlüsseltem Passwort abrufen
wonda credentials get <id>
# Beliebiges Feld aktualisieren (--password-stdin zum Rotieren; --username "" zum Löschen)
wonda credentials update <id> --username newhandle
# Löschen
wonda credentials delete <id>
# Abrufen + Grund für die Verwendung in einem Aufruf erfassen — POST, nicht GET, weil
# es ein 'used'-Ereignis mit dem Grund schreibt. Bevorzugen Sie dies gegenüber `get`, wann immer
# Sie den Grund formulieren können.
wonda credentials use <id> --reason "Instagram-Anmeldeablauf"
# Aktuelle Ereignisse anzeigen (erstellt / verwendet / rotiert / aktualisiert) für die Prüfung
wonda credentials events <id>
Felder: website (erforderlich — 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 zulässig — bei Bedarf selbst deduplizieren.
Ereignisprotokoll: Jeder credentials get/use, create, Passwort-Rotation und andere Aktualisierungen werden als Ereignisse auf der Anmeldeinformation aufgezeichnet (Akteur: cli | web | system). Verwenden Sie credentials events <id> oder das Verlaufssymbol in der Web-UI zur Prüfung. Das Ereignisprotokoll ist nur zum Anhängen und kaskadiert beim Löschen der Anmeldeinformation.
Globale Ausgabeflags
Alle Befehle unterstützen diese Ausgabesteuerungsflags:
--json— JSON-Ausgabe erzwingen (automatisch aktiviert, wenn stdout weitergeleitet wird)--quiet— Nur die primäre Kennung ausgeben (Job-ID, Medien-ID usw.) — ideal für Skripte-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, Incident-Hinweise, Upgrade-Aufforderungen. Nachrichten werden nur an stderr ausgegeben, sodass stdout/JSON für die Weiterleitung sauber bleibt.
Pro-Anfrage Veraltungshinweise kommen als standardmäßiger HTTP-Header Warning: 299 - "<message>" und werden vom HTTP-Client der CLI als [deprecated METHOD /path] <message> an stderr ausgegeben.
Unterdrücken Sie beide Kanäle mit WONDA_QUIET=1 (Umgebungsvariable) oder --quiet (Flag). Deaktivieren Sie nur die Netzwerkprüfungen mit WONDA_NO_UPDATE_CHECK=1.
WAB / Wonda Automation Browser (wonda wab)
Der Wonda Automation Browser (WAB) ist ein Premium-Stealth-Antidetect-Browser, der gehärtet ist, sodass 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 Chromium-Browser pro Persona, der eingeloggte Sitzungen für LinkedIn, X, Reddit und Co. hält. Die CLI startet ihn bei Bedarf, lässt ihn im Leerlauf auslaufen und leitet Plattform-Lese-/Schreibvorgänge durch ihn, wenn ein Befehl mit
--via wabausgeführt wird. Cookies leben im Chromium-Profil der Persona, nicht in~/.wonda/config.json. - Anonyme Erfassung.
wonda wab record <url>(undwonda brand extract) steuern einen ephemären 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 die Persona des Kontos (--via wab, Live-Antidetect-Chromium). Eine Persona ist der Chromium-Envelope, der mehrere Konten unter einem Fingerabdruck halten kann.