ENDE
Zur Startseite

WPAgently-Dokumentation

Erste Workflows sicher ausführen

Hier prüfst du mit einem kurzen Test, ob die Verbindung und das Erstellen von Entwürfen funktionieren. Die Befehle setzen eine eingerichtete Paid-CLI voraus. Mit Free verwendest du die Chat-Aufgaben aus dem Schnellstart.

Schritt 5: Smoke-Test (etwa 6 Minuten)

Dieser CLI-Smoke-Test gehört zu Paid. Mit Free führst du stattdessen die lesende Prüfung und den kleinen Testentwurf aus dem Schnellstart direkt in deinem Assistenten aus.

Jetzt prüfen wir einmal komplett, ob alles zusammenspielt. „Smoke-Test“ ist nur ein gängiger Begriff für einen schnellen Grundcheck.

Führe zuerst den Rundum-Check aus:

wp-agent doctor

Der Befehl erledigt in einem Durchlauf sieben Verbindungs- und Konfigurationsprüfungen. Er prüft Erreichbarkeit, Authentifizierung, Bot-Rolle, Lizenz, zentrale Companion-Steuerung, Kern-Abilities und MCP. Nur wenn alle sieben Checks OK melden, ist die Verbindung startklar. Schlägt eine Voraussetzung fehl, markiert wp-agent doctor abhängige Prüfungen als nicht ausgeführt. So kann eine nicht erreichbare Steuerung niemals als leere, aber angeblich vollständige Ability- oder MCP-Liste grün erscheinen.

Zusätzlich kannst du unter WPAgently > Agent verbinden eine externe Verbindungsdiagnose starten. WordPress ruft dabei ohne Zugangsdaten seine öffentliche REST-API, den MCP-Endpunkt und die OAuth-Metadaten über die normale Website-Adresse auf. Dadurch werden viele Sperren durch CDN, Firewall oder Security-Plugin sichtbar, die eine rein interne Prüfung nicht erkennt. Erkannte vorgeschaltete Dienste und bekannte aktive Security-Plugins erscheinen als Hinweise, nicht als pauschale Fehlerursache. Wenn eine bereits erfolgreich verwendete Verbindung später ihre Anmeldung verliert, zeigt WPAgently Administratoren außerdem eine Warnung mit direktem Link zu dieser Diagnose.

Für eine gezielte Einzelprüfung stehen zusätzlich wp-agent preflight (nur die Bot-Rolle) und wp-agent abilities (nur die Ability-Liste, jeweils markiert als readonly [R] = nur lesend oder schreibend [W]) zur Verfügung.

Zum Abschluss legst du einen ersten Test-Entwurf aus einer winzigen Textdatei an. Erzeuge sie zum Beispiel mit printf (ein Befehl, der schlicht Text in eine Datei schreibt):

printf '## Smoke-Test\n\nEin Absatz mit **Fett** und einer Liste:\n\n- eins\n- zwei\n' > test.md

Erzeuge daraus den Testartikel:

wp-agent article --markdown-file test.md --title "Smoke-Test" --slug smoke-test

Das Ergebnis muss Freiform: 0 melden. In der Render-Zeile steht zusätzlich Freiform=0. Das bedeutet, dass die Formatierung sauber in echte WordPress-Blöcke umgewandelt wurde und nichts in der alten, kaputten Editor-Ansicht gelandet ist. Der Beitrag bleibt automatisch ein Entwurf (Draft), du veröffentlichst also aus Versehen nichts.

Dieser Smoke-Test erzeugt bewusst nur einen kleinen Artikel. Für einen vollständigen Beitrag mit Bild kannst du später den mitgelieferten wp-article-Skill verwenden. Für SEO brauchst du Rank Math, Yoast, AIOSEO oder SEOPress. WPAgently prüft SEO-Angaben, speichert sie aber absichtlich nicht selbst. set-seo-meta stoppt vor jeder Änderung mit HTTP 409 und manual_only. Ändere SEO-Angaben deshalb im SEO-Plugin und lies das Ergebnis danach mit get-seo-meta erneut aus.

Geschafft ist der Schritt, wenn wp-agent doctor siebenmal OK meldet und der Testartikel mit Freiform: 0 beziehungsweise Freiform=0 als Entwurf in deinem WordPress landet. Ein --publish-Aufruf ändert den Status derzeit nicht automatisch, weil set-post-status mit manual_only abbricht. Veröffentlichung und weitere Statuswechsel erfolgen nach der Prüfung manuell in WordPress. Ab hier steht die Verbindung.

Diagnose

wp-agent doctor zeigt für jeden Check direkt einen verständlichen Hinweis. Falls ein Check fehlschlägt, löse zuerst genau diesen Hinweis. Diese Übersicht hilft dir beim Einordnen.

  1. Erreichbarkeit: Ist deine Website erreichbar? Prüfe zuerst die Permalinks. Auf einer neuen, noch nicht öffentlichen Website kannst du unter Einstellungen > Permalinks „Beitragsname“ wählen und speichern. Ist deine Website bereits öffentlich, ändere die Permalink-Struktur nicht ohne Weiterleitungsplan. Bitte dafür deine zuständige Person oder dein Hosting um Hilfe.
  2. Anmeldung: Kann sich der gespeicherte Zugang als dein Redakteur anmelden? Wurde der Zugang widerrufen, führst du wp-agent logout --site "$WP_AGENT_SITE" --force und danach wp-agent login --site "$WP_AGENT_SITE" aus.
  3. Bot-Rolle: Hat der Bot die Rolle Editor und nicht Administrator? Administrator-Rechte sind absichtlich ein harter Stopp.
  4. Lizenz: Ist deine Lizenz gültig?
  5. Steuerung: Ist WPAgently auf dieser Website korrekt aktiviert?
  6. Abilities: Sind alle laut Kontrollzentrum aktivierten Abilities angemeldet? Fehlen welche, prüfe im WPAgently-Kontrollzentrum das Funktionsprofil und den Companion-Schalter.
  7. Verbindung: Sind die Werkzeuge deines Assistenten erreichbar? Wenn dieser Check trotz aktivem Plugin fehlschlägt, starte unter WPAgently > Agent verbinden die externe Verbindungsdiagnose und prüfe die angezeigten Hinweise zu Firewall, CDN oder Sicherheits-Plugins.

Für eine einzelne Prüfung gibt es wp-agent preflight für die Bot-Rolle und wp-agent abilities für die Werkzeugliste. wp-agent login verbindet die CLI. wp-agent init erstellt Verbindungsdateien oder registriert Claude Code beziehungsweise Codex mit --scope user --i-approve. Der Befehl ersetzt weder die Anmeldung noch die Verbindungsprüfung mit doctor.

Die Gesamtarchitektur der installierbaren Bausteine beschreibt die Architektur-Dokumentation.