ENDE
Zur Startseite

WPAgently-Dokumentation

CLI und Referenz für den Alltag

Die CLI ist das Programm für Befehle im Terminal und gehört zu Paid. Für deinen ersten Entwurf brauchst du sie nicht. Hier findest du Installation, Anmeldung und Prüfungen für wiederholbare Abläufe.

Schritt 3: CLI installieren (etwa 2 Minuten)

Dieser und die beiden folgenden CLI-Schritte gehören zu Paid. Mit Free verwendest du stattdessen den Weg aus der Verbindungsanleitung. Die erste sichere Aufgabe steht im Schnellstart.

Jetzt kommt das kleine WPAgently-Programm auf deinen eigenen Rechner. Es heißt CLI (Command-Line-Tool), also ein Programm, das du nicht anklickst, sondern durch Tippen eines Befehls im Terminal startest. Diese CLI ist die Fernbedienung, mit der du gleich alles einrichtest und prüfst.

Die wp-agent-CLI kommt als Node-Paket im gelieferten Archiv wp-agent-<version>.tgz (<version> steht für die Versionsnummer, die im Dateinamen deines Downloads steht). Installiere sie global direkt aus diesem Archiv:

npm install -g wp-agent-<version>.tgz

Prüfe danach die Installation:

wp-agent --help

Die Ausgabe muss die verfügbaren Befehle auflisten, unter anderem login, logout, preflight, abilities, doctor, article und landing. Wenn du diese Liste siehst, ist die CLI installiert.

Wenn du Windows nutzt, brauchst du für die normale Verbindung keine lokale WordPress-Umgebung. Die folgenden Einstellungen sind nur für einen lokalen Backup- oder Wiederherstellungslauf nötig, wenn WP-CLI oder PHP nicht gefunden werden. Überspringe diesen Block, wenn du nicht genau diesen Fall hast:

$env:WP_AGENT_WP_CLI_BIN = "C:\Pfad\zu\wp.bat"
$env:WP_AGENT_PHP_BIN = "C:\Pfad\zu\php.exe"

WP_AGENT_WP_CLI_BIN darf auch auf wp.exe oder wp-cli.phar zeigen. Diese Einstellungen betreffen nur lokale Backups und Wiederherstellungen mit WP_AGENT_WP_PATH. Für die normale Verbindung brauchst du kein lokales WP-CLI.

Der Schritt ist geschafft, wenn wp-agent --help die Befehlsliste statt einer Fehlermeldung wie „command not found“ zeigt.

Schritt 4: CLI per Browser verbinden (etwa 3 Minuten)

Dieser Browser-OAuth-Weg mit der WPAgently-CLI gehört zu Paid. Installiere zuerst die CLI wie in der CLI-Anleitung beschrieben. Mit Free verwendest du den Weg aus der Verbindungsanleitung.

Speichere zuerst nur die Basisadresse deiner Website in der Shell. Die Adresse enthält weder /wp-json noch einen abschließenden Slash:

export WP_AGENT_SITE="https://deine-domain.tld"

Starte danach die Anmeldung:

wp-agent login --site "$WP_AGENT_SITE"

Die CLI öffnet den Browser und wartet auf deine Freigabe. Melde dich dort in WordPress an, wähle den Redakteur aus der Verbindungsanleitung und bestätige den Zugriff. Danach kann die CLI die Verbindung auf deinem Rechner erneuern. Dein normales WordPress-Passwort und das Passwort des Redakteurs werden dafür nicht an die CLI übergeben oder dort gespeichert.

Falls sich kein Browser öffnet, zeigt wp-agent login --site "$WP_AGENT_SITE" --no-open eine Adresse, die du selbst im Browser öffnest. Mit wp-agent logout --site "$WP_AGENT_SITE" trennst du die Verbindung später wieder. --force verwendest du nur, wenn deine Website dauerhaft nicht erreichbar ist. Es entfernt dann nur den lokalen Eintrag.

Ein Application Password bleibt der technische Ausweichweg. Verwende ihn nur, wenn Browser-OAuth nicht möglich ist, und gib Zugangsdaten nie in einem gemeinsamen Terminal oder einer geteilten Datei ein. wp-agent init brauchst du für diese normale CLI-Anmeldung nicht. Für den anderen Weg reicht die Verbindungsdatei aus der Verbindungsanleitung.

Der Schritt ist geschafft, wenn wp-agent login die erfolgreiche Verbindung meldet. Ab dann erneuert die CLI ablaufende Tokens automatisch.

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.