Dieser Artikel erklärt, wie man die Easyship Official Skill in OpenClaw installiert, damit Sie Sendungen mit natürlicher Sprache verwalten können, einschließlich Tarifen abrufen, Sendungen erstellen, Labels kaufen, Abholungen planen und Lieferungen verfolgen.
Bevor Sie beginnen
Sie benötigen:
- OpenClaw installiert und auf Ihrem Gerät ausgeführt
- Zugang zu Ihrem Easyship Dashboard
- Ein Easyship-Konto (API-Zugang ist in allen Tarifen ohne zusätzliche Kosten verfügbar)
Wenn Sie OpenClaw noch nicht installiert haben, folgen Sie bitte dem offiziellen OpenClaw Einrichtungsleitfaden, bevor Sie fortfahren.
Schritt 1: Holen Sie sich Ihren Easyship API-Token
- Gehen Sie zu Ihrem Easyship Dashboard und klicken Sie auf Connect
- Klicken Sie auf Neue Integration
- Scrollen Sie nach unten zu API-Integration
- Wählen Sie unter Integrationsart die Option Ich entwickle eine benutzerdefinierte Integration
- Benennen Sie den Schlüssel Easyship MCP zur einfachen Referenz
- Belassen Sie die Standardversion 2024-09 und klicken Sie auf Connect
- Klicken Sie auf der nächsten Seite auf Access Token und kopieren Sie ihn mit der Kopier-Schaltfläche
Erforderliche Berechtigungen (Scopes): Ihr API-Token muss die folgenden Berechtigungen enthalten. Fehlende Berechtigungen führen dazu, dass einige Werkzeuge nicht funktionieren, während andere weiterhin arbeiten.
public.shipment:read public.shipment:write
public.label:write public.pickup:read
public.pickup:write public.address_validation:write
public.address_validation_domestic:write
public.shipment_document:read public.transaction_record:read
public.analytics:read public.rate:read
public.track:readSie können die Berechtigungen jederzeit unter Dashboard → Connect → API prüfen und aktualisieren, ohne einen neuen Token erstellen zu müssen.
Schritt 2: Laden Sie die Easyship Skill herunter und installieren Sie sie
- Gehen Sie zur Easyship Official Skill-Seite auf ClawHub und laden Sie den Skill-Ordner herunter
- Verschieben Sie den heruntergeladenen Ordner in Ihr OpenClaw Skills-Verzeichnis:
bash
~/.openclaw/skills/
Ihre Ordnerstruktur sollte wie folgt aussehen:
~/.openclaw/skills/easyship-official/SKILL.mdHinweis: OpenClaw benötigt eine SKILL.md-Datei, um einen Skill korrekt zu laden. Stellen Sie sicher, dass diese Datei im Ordner vorhanden ist, bevor Sie fortfahren.
Schritt 3: Installieren Sie die Easyship Skill
Installieren Sie den Skill mit der OpenClaw CLI, die die Dateien korrekt platziert:
bash
openclaw skills install @paulld/easyship-officialDies lädt den Skill von der Easyship Official Skill-Seite auf ClawHub herunter und installiert ihn unter:
~/.openclaw/skills/easyship-official/SKILL.mdHinweis: OpenClaw benötigt eine SKILL.md-Datei an diesem Pfad, um den Skill korrekt zu laden. Wenn Sie manuell statt mit der CLI installieren, laden Sie den Skill-Ordner von der ClawHub-Seite herunter und legen Sie ihn am gleichen Pfad ab.
Schritt 4: Verbinden Sie Ihr Easyship-Konto
Setzen Sie Ihren Easyship API-Token als Umgebungsvariable. Um diese über Sitzungen und Neustarts hinweg zu speichern, fügen Sie sie Ihrem Shell-Profil hinzu:
bash
# Für bash
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.bashrc
source ~/.bashrc
# Für zsh (macOS Standard)
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
source ~/.zshrcErsetzen Sie YOUR_TOKEN durch den API-Token, den Sie in Schritt 1 kopiert haben.
Sicherheit: Teilen Sie Ihren API-Token niemals in einem Chatfenster oder committen Sie ihn nicht in ein Versionskontrollsystem. Wenn Sie ihn versehentlich preisgeben, widerrufen und tauschen Sie Ihren Schlüssel sofort im Easyship Dashboard unter Connect → API aus.
Schritt 5: Verbinden Sie den Easyship MCP-Server
Die Installation des Skills zeigt OpenClaw nur, wie Easyships Werkzeuge verwendet werden — eine Verbindung wird noch nicht hergestellt. Registrieren Sie den MCP-Server separat, damit diese Werkzeuge verfügbar werden:
bash
openclaw mcp set easyship '{"url":"https://mcp.easyship.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${EASYSHIP_API_ACCESS_TOKEN}"}}'Die Verwendung von ${EASYSHIP_API_ACCESS_TOKEN} anstelle des direkten Einfügens Ihres Tokens hält diesen aus Ihrer gespeicherten OpenClaw-Konfiguration heraus.
Schritt 6: Starten Sie OpenClaw neu
Wenden Sie Ihre Änderungen an, indem Sie das OpenClaw-Gateway neu starten:
bash
openclaw gateway restartSchritt 7: Überprüfen Sie die Verbindung
Bestätigen Sie zuerst, dass der Server korrekt registriert wurde:
bash
openclaw mcp doctor easyship --probeBestätigen Sie anschließend, dass alles von Anfang bis Ende funktioniert, indem Sie OpenClaw auffordern:
Hole meine letzten 5 Easyship-Sendungen, bei denen das Label noch nicht gekauft wurde
Sie sollten eine Tabelle Ihrer letzten 5 Sendungen aus der Liste "To Ship" sehen. Wenn Ergebnisse erscheinen, ist Ihre Einrichtung abgeschlossen.
Probieren Sie es aus
Nach der Verbindung erkennt OpenClaw automatisch, wann die Easyship Skill verwendet werden soll – beschreiben Sie Ihre Aufgabe einfach in normaler Sprache. Versuchen Sie eine Eingabe wie:
Ich möchte ein Paket von New York, USA nach Toronto, Kanada versenden. Absender: 350 5th Avenue, New York, US 10001. Empfänger: 220 Yonge Street, Toronto, ON, Kanada M5B 2H1. Paket: 1,98 lb, 6 × 4 × 2 cm. Artikel: Geschäftsdokumente, Menge 1, HS-Code 4911.99, deklarierter Wert 1,00 USD, Kategorie Dokumente, DDU. Zeige mir die günstigsten und besten Versandoptionen mit Lieferzeiten und Kuriernamen.
Für eine vollständige Liste der verfügbaren Werkzeuge und Workflows siehe die Easyship MCP Entwickler-Dokumentation.
Tipps für beste Ergebnisse:
- Fügen Sie wichtige Details in Ihre Eingaben ein (Absender, Empfänger, Gewicht, Maße)
- Seien Sie spezifisch, was Sie möchten (z. B. „günstigste Option“ oder „schnellste Lieferung“)
- Verwenden Sie natürliche Sprache – keine Befehle nötig
Verfügbare Aktionen
| Werkzeug | Aktion | Beschreibung |
| validate_address | Adressvalidierung | Prüfen, ob eine Adresse zustellbar ist, und Korrekturvorschläge erhalten |
| get_rates | Kurierpreise vergleichen | Versandkostenoptionen sehen, bevor Sie etwas versenden |
| create_shipment | Sendung erstellen | Sendung als Entwurf starten oder sofort ein Label kaufen |
| create_label | Label kaufen | Ein Versandlabel für eine bestehende Sendungs-ID kaufen und erzeugen |
| get_shipment | Sendungsdetails | Eine Sendung abfragen – Status, Kosten und Dokumentenlinks |
| list_shipments | Sendungen durchsuchen | Ihre Sendungen nach Land, Labelstatus usw. durchsuchen oder filtern |
| update_shipment | Sendung aktualisieren | Details einer bestehenden Sendung vor dem Versand korrigieren |
| cancel_shipment | Sendung stornieren | Eine Sendung stornieren, die noch nicht versandt wurde |
| delete_shipment | Entwurf löschen | Einen unversandten Entwurf entfernen |
| track_shipment | Sendungsverfolgung | Aktuellen Status, voraussichtliche Ankunftszeit und letzte Tracking-Ereignisse sehen |
| list_pickups | Abholungen auflisten | Geplante Abholungen nach Datum, Kurier oder Status anzeigen |
| get_pickup | Abholdetails | Vollständige Details zu einer geplanten Abholung |
| get_pickup_slots | Verfügbare Abholfenster | Verfügbare Kurier-Abholfenster vor der Buchung sehen |
| create_pickup | Abholung planen | Einen Kurier buchen, der ein oder mehrere Pakete abholt |
| cancel_pickup | Abholung stornieren | Eine geplante Abholung stornieren |
| list_transactions | Transaktionsübersicht | Gebühren und Gutschriften auf Ihrem Easyship-Konto prüfen |
| analytics_shipments | Sendungsvolumen-Trend | Sendungen über die Zeit mit täglichem Volumen |
| analytics_top_couriers | Kurier-Mix nach Volumen | Welche Anbieter Sie am meisten nutzen |
| analytics_top_destinations | Top-Ziele | Wohin Sie die meisten Pakete senden |
Fehlerbehebung
Es passiert nichts, wenn Sie eine Anfrage eingeben
- Stellen Sie sicher, dass OpenClaw läuft
- Starten Sie OpenClaw neu
- Versuchen Sie eine klarere Eingabe (z. B. „Versandkosten nach Kanada abrufen“)
API- oder Authentifizierungsfehler
- Prüfen Sie, ob EASYSHIP_API_ACCESS_TOKEN korrekt in Ihrer Shell gesetzt ist
- Stellen Sie sicher, dass Ihr Easyship-Konto aktiv ist und der Token alle erforderlichen Berechtigungen hat
Einige Werkzeuge funktionieren, andere nicht
- Eine fehlende Berechtigung führt dazu, dass das jeweilige Werkzeug nicht funktioniert. Überprüfen Sie, ob Ihr Token alle in Schritt 1 aufgelisteten Berechtigungen enthält.
Skill wird nicht erkannt
- Bestätigen Sie, dass der Ordnerpfad korrekt ist: ~/.openclaw/skills/easyship-official/
- Stellen Sie sicher, dass die SKILL.md im Ordner vorhanden ist
- Starten Sie OpenClaw neu
MCP-Server verbindet sich nicht
- Führen Sie openclaw mcp doctor easyship --probe aus, um zu bestätigen, dass der Server korrekt registriert wurde
- Stellen Sie sicher, dass EASYSHIP_API_ACCESS_TOKEN gesetzt ist, bevor Sie den Befehl openclaw mcp set in Schritt 5 ausführen
- Starten Sie OpenClaw nach der Registrierung oder Aktualisierung des MCP-Servers neu
FAQs
Kann ich einen bestehenden API-Token verwenden oder benötige ich einen neuen?
Sie können einen bestehenden Token verwenden. Stellen Sie nur sicher, dass er alle in Schritt 1 aufgelisteten Berechtigungen enthält.
Warum funktioniert mein API-Token nicht?
Überprüfen Sie die Berechtigungen im Easyship Dashboard unter Connect → API. Aktivieren Sie alle in Schritt 1 aufgelisteten Berechtigungen für vollen Zugriff.
Muss ich für den API-Token bezahlen?
Nein. Easyship stellt den API-Zugang in allen Tarifen ohne zusätzliche Kosten zur Verfügung. Wenn Sie die im Tarif enthaltenen API-Limits überschreiten, können Übergebühren anfallen.