Wenn etwas gestoppt wird, ist das meistens Absicht. WPAgently hält einen Entwurf lieber an, als eine unklare Änderung unbemerkt auf deiner Website zu speichern.
Diese Seite hilft dir, die Meldung in einen nächsten Schritt zu übersetzen. Du musst nicht alles lesen. Suche das Symptom, das du siehst.
Nutzt du Paid mit der CLI und funktioniert die Verbindung nicht, startest du mit diesem Befehl:
wp-agent doctordoctor prüft die Website, deine Anmeldung, den Redakteur, die Lizenz und die verfügbaren Werkzeuge. Mit Free überspringst du diesen Befehl. Wiederhole stattdessen die Leseaufgabe aus dem Schnellstart. Wenn die externe Verbindung trotzdem nicht klappt, öffnest du WPAgently > Agent verbinden und startest dort die externe Diagnose.
Die fünf stillen Fehler
Das sind die häufigsten Fälle, die WPAgently sichtbar macht, bevor aus einem Entwurf ein Problem wird.
1. Der Beitrag ist unformatiert
Das siehst du
Der Beitrag besteht im Editor aus einem großen Classic-Block oder die Antwort meldet freeform_count größer als 0.
Was das bedeutet
WordPress konnte den Inhalt nicht als einzelne Blöcke verstehen. Ein Block ist zum Beispiel eine Überschrift, ein Absatz oder ein Bild. Der Classic-Block ist die alte Fallback-Ansicht. Sie ist für neue WPAgently-Inhalte nicht der richtige Zustand.
Das tust du
Bitte den Assistenten, den neuen Artikel über wp-agent/create-post-from-markdown oder die Landingpage über wp-agent/upsert-pattern anzulegen. Rohes HTML oder selbst geschriebener Gutenberg-Block-Code gehört nicht in diesen Ablauf.
Vereinfache bei Bedarf verschachtelte Listen oder ungewöhnliche Tabellen und starte den Entwurf erneut. Veröffentliche den Beitrag erst, wenn freeform_count wieder 0 ist.
2. Die SEO-Änderung wird gestoppt
Das siehst du
set-seo-meta meldet HTTP 409 und manual_only. Titel, Beschreibung oder Fokus-Keyword bleiben unverändert.
Was das bedeutet
SEO-Angaben werden nicht als normaler Text gespeichert. Rank Math, Yoast, AIOSEO und SEOPress verwenden dafür eigene Bereiche. WPAgently kann eine Änderung dort derzeit nicht für alle unterstützten Plugins sicher genug schreiben.
Das tust du
Ändere den SEO-Titel, die Beschreibung oder das Fokus-Keyword direkt im SEO-Plugin in WordPress. Lass den Assistenten danach mit wp-agent/get-seo-meta noch einmal nachsehen, ob die Werte gespeichert sind.
Wiederhole set-seo-meta nicht in der Hoffnung, dass die Änderung beim zweiten Versuch doch geschrieben wird. manual_only bedeutet hier bewusst, dass WordPress nichts geändert hat.
3. Neue Inhalte sind nicht sofort sichtbar
Das siehst du
Ein neuer Beitrag hat eine alte Vorschau, die Sitemap scheint nicht aktuell oder ein neuer Link funktioniert noch nicht.
Was das bedeutet
Ein Cache ist ein Zwischenspeicher. Eine Sitemap ist die Liste deiner Seiten für Suchmaschinen. WordPress erledigt manche Nacharbeiten normalerweise erst beim Speichern im Editor.
Das tust du
Bei wp-agent article und wp-agent landing läuft diese Nacharbeit am Ende mit. Wenn du einzelne Werkzeuge direkt verwendest, bitte den Assistenten, nach einer Änderung wp-agent/refresh-hooks aufzurufen.
Wenn du ein Caching-Plugin oder ein CDN verwendest, leerst du anschließend auch dort den Cache. Prüfe die Seite danach in einem privaten Browserfenster.
4. Ein Bild wird abgelehnt oder fehlt
Das siehst du
Der Bild-Upload stoppt, das Beitragsbild fehlt oder der Alt-Text wurde nicht gesetzt.
Was das bedeutet
Alt-Text ist die kurze Bildbeschreibung für Screenreader und Suchmaschinen. WPAgently verlangt ihn, damit Bilder nicht ohne Beschreibung veröffentlicht werden.
Manche Bild-Links werden aus Sicherheitsgründen blockiert. Das betrifft lokale Adressen wie localhost, private Netzwerke oder Weiterleitungen dorthin. Der Schutz verhindert, dass ein Bild-Link heimlich geschützte Bereiche deines Hostings abruft.
Das tust du
Verwende eine öffentlich erreichbare https-Bildadresse oder eine lokale Bilddatei. Gib immer eine konkrete Bildbeschreibung mit, zum Beispiel „Person bearbeitet einen WordPress-Entwurf am Laptop“.
Hat eine Bildadresse keine erkennbare Endung, etwa .jpg, .png oder .webp, kann WordPress den Dateityp manchmal nicht bestimmen. Nimm dann eine direkte Bildadresse mit Dateiendung oder lade die Datei lokal herunter.
Wenn ein Direkt-Upload nach dem Speichern nicht verifiziert werden kann, bleibt der angelegte Anhang erhalten. Die Antwort enthält HTTP 409, wpagent_direct_upload_recovery_required, recovery_required=true und die attachment_id zur manuellen Kontrolle. Prüfe den Anhang in WordPress und wiederhole den Upload nicht blind.
5. Ein Artikel würde doppelt entstehen
Das siehst du
Der Ablauf stoppt, weil zu einem Slug bereits ein Beitrag gefunden wurde.
Was das bedeutet
Der Slug ist der letzte Teil der Webadresse, etwa mein-neuer-artikel. In den CLI-Pipelines muss ein expliziter Slug bereits der gespeicherten WordPress-Form entsprechen: Kleinbuchstaben, Ziffern, Unterstriche oder kleingeschriebene Prozent-Oktette, mit einzelnen Bindestrichen als Trenner und höchstens 200 Zeichen. Die CLI verwirft außerdem 59 Prozent-kodierte Sequenzen, die WordPress Core beim Speichern normalisiert, darunter kodierte Leerzeichen und Interpunktion. Stabil gespeicherte Prozent-kodierte UTF-8-Sequenzen wie %e4%bd%a0%e5%a5%bd und wiederholte Unterstriche bleiben zulässig. Bei direkten Ability-Aufrufen normalisiert WordPress den Slug mit sanitize_title(). Du kannst ihn auch weglassen und WordPress aus dem Titel erzeugen lassen. Der Slug sorgt dafür, dass derselbe Auftrag nicht versehentlich zwei gleiche Artikel erstellt.
Mehrere exakte Treffer sind mehrdeutig und führen vor jeder Mutation zum Abbruch. WPAgently wählt nie einfach den ersten Treffer aus.
Das tust du
Prüfe im WordPress-Backend, welcher Beitrag der richtige ist. Gib einem neuen Testartikel einen neuen Slug. Einen bestehenden Beitrag aktualisierst du derzeit bewusst manuell im WordPress-Editor.
Besondere Fälle
Ein bestehender Beitrag wurde nicht sichtbar geändert
Viele Seiten werden mit einem Page Builder wie Elementor, Bricks, Breakdance, Oxygen oder WPBakery gebaut. Solche Builder speichern Inhalte teilweise außerhalb des normalen WordPress-Textfelds.
Bitte den Assistenten zuerst, den Builder zu erkennen. Für Elementor gibt es begrenzte eigene Werkzeuge. Bei Bricks, Breakdance, Oxygen und WPBakery stoppt WPAgently Schreibzugriffe bewusst, wenn die sichtbare Ausgabe nicht sicher geprüft werden kann.
Global Styles ist noch nicht initialisiert
Das siehst du
wp-agent/get-global-styles, wp-agent/list-global-style-variations, wp-agent/get-global-style-variation, ein Spectra-One-Export oder ein portabler Preflight mit einer Global-Styles-Zuordnung create_only meldet HTTP 409 mit wpagent_gs_no_post.
Was das bedeutet
Für das aktive Theme gibt es noch keinen gespeicherten User-Global-Styles-Datensatz. Diese Lese-, Export- und Vorprüfpfade bleiben wirklich lesend. Sie legen keinen WordPress-Datensatz an. Ohne Datensatz kann auch kein state_hash für einen sicheren Write geliefert werden.
Das tust du
Öffne im WordPress-Editor die Global Styles und speichere einmal. Starte danach wp-agent/get-global-styles erneut. Verwende den neuen state_hash als expected_hash für wp-agent/set-global-styles oder wp-agent/apply-global-style-variation. Beim portablen Spectra-One-Preflight wählst du danach die gewünschte Zuordnung erneut und führst den Preflight noch einmal aus.
Formulare, Shop oder eigene Felder
Formulare, WooCommerce-Produkte und ACF-Felder haben zusätzliche Regeln. ACF ist ein Plugin für eigene Zusatzfelder. Der normale Redakteur erhält für besonders sensible Bereiche, etwa Formulareinsendungen oder Bestelldaten, nicht automatisch Zugriff.
Das ist Absicht. Gib nur die einzelne Rechte-Gruppe frei, die du wirklich brauchst. Bei Bestellungen, Zahlungsdaten oder Formularantworten arbeitest du besser direkt im jeweiligen WordPress-Plugin.
Der Assistent sieht keine Werkzeuge
Prüfe zuerst, ob der Companion aktiv ist und ob du im WPAgently-Kontrollzentrum das richtige Profil gewählt hast. Öffne dann WPAgently > Agent verbinden, wähle deinen Assistenten aus und folge noch einmal genau dessen Anleitung. Mit der Paid-CLI prüfst du zusätzlich wp-agent doctor.
Zeigt dein Assistent trotzdem keine wp-agent--Werkzeuge an, starte ihn neu. Hat WordPress für deinen Assistenten eine Verbindungsdatei angeboten, importiere genau diese Datei erneut. Sie enthält ein eigenes Application Password. Behandle sie wie ein Passwort und teile sie nicht. Bei einer Browser-Freigabe wiederholst du stattdessen nur die angezeigten Schritte.
Was du bei einer Support-Anfrage bereithältst
Schick keine Zugangsdaten, Lizenzschlüssel oder vollständigen Datenbank-Export. Hilfreich sind stattdessen:
- der genaue Wortlaut der Fehlermeldung
- dein WordPress- und PHP-Stand
- der Name des verwendeten Assistenten
- die Aufgabe, die du ausführen wolltest
- ein Screenshot der betroffenen WordPress-Seite
Damit lässt sich die Ursache meist finden, ohne dass du vertrauliche Daten weitergeben musst.