Dit artikel legt uit hoe je de Easyship Official Skill in OpenClaw installeert, zodat je zendingen kunt beheren met natuurlijke taal, waaronder het verkrijgen van tarieven, het aanmaken van zendingen, het kopen van labels, het plannen van ophaalafspraken en het volgen van leveringen.
Voordat je begint
Je hebt nodig:
- OpenClaw geïnstalleerd en draaiend op je computer
- Toegang tot je Easyship Dashboard
- Een Easyship-account (API-toegang is beschikbaar op alle abonnementen zonder extra kosten)
Als je OpenClaw nog niet hebt geïnstalleerd, volg dan de officiële OpenClaw installatiewijzer voordat je verdergaat.
Stap 1: Verkrijg je Easyship API-token
- Ga naar je Easyship Dashboard en klik op Connect
- Klik op New Integration
- Scroll naar beneden naar API Integration
- Selecteer onder Integration Type de optie I am developing a custom integration
- Noem de sleutel Easyship MCP voor gemakkelijke herkenning
- Laat de standaardversie 2024-09 staan en klik op Connect
- Klik op de volgende pagina op Access Token en kopieer deze met de kopieerknop
Vereiste scopes: Je API-token moet de volgende scopes bevatten. Ontbrekende scopes zorgen ervoor dat sommige tools niet werken terwijl andere wel blijven functioneren.
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:readJe kunt de scopes op elk moment controleren en bijwerken via Dashboard → Connect → API zonder een nieuw token aan te maken.
Stap 2: Download en installeer de Easyship Skill
- Ga naar de Easyship Official skillpagina op ClawHub en download de skillmap
- Verplaats de gedownloade map naar je OpenClaw skills-map:
bash
~/.openclaw/skills/
Je mappenstructuur moet er als volgt uitzien:
~/.openclaw/skills/easyship-official/SKILL.mdOpmerking: OpenClaw vereist een SKILL.md-bestand om een skill correct te laden. Zorg dat dit bestand in de map aanwezig is voordat je verdergaat.
Stap 3: Download en installeer de Easyship Skill
Installeer de skill met behulp van de OpenClaw CLI, die de bestanden op de juiste plaats zet:
bash
openclaw skills install @paulld/easyship-officialDit downloadt de skill van de Easyship Official skillpagina op ClawHub en installeert deze op:
~/.openclaw/skills/easyship-official/SKILL.mdOpmerking: OpenClaw vereist een SKILL.md-bestand op dat pad om de skill correct te laden. Als je handmatig installeert in plaats van de CLI te gebruiken, download dan de skillmap van de ClawHub-pagina en plaats deze op hetzelfde pad.
Stap 4: Verbind je Easyship-account
Stel je Easyship API-token in als een omgevingsvariabele. Om dit persistent te maken over sessies en herstarts, voeg je het toe aan je shell-profiel:
bash
# Voor bash
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.bashrc
source ~/.bashrc
# Voor zsh (standaard op macOS)
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
source ~/.zshrcVervang YOUR_TOKEN door het API-token dat je in Stap 1 hebt gekopieerd.
Beveiliging: Deel je API-token nooit in een chatvenster en commit het niet in versiebeheer. Als je het per ongeluk openbaar maakt, herroep en vervang je sleutel dan onmiddellijk in het Easyship Dashboard onder Connect → API.
Stap 5: Verbind de Easyship MCP-server
Het installeren van de skill leert OpenClaw alleen hoe Easyship's tools te gebruiken — het verbindt er nog niet mee. Registreer de MCP-server apart zodat die tools beschikbaar worden:
bash
openclaw mcp set easyship '{"url":"https://mcp.easyship.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${EASYSHIP_API_ACCESS_TOKEN}"}}'Door ${EASYSHIP_API_ACCESS_TOKEN} te gebruiken in plaats van je token direct te plakken, blijft deze buiten je opgeslagen OpenClaw-configuratie.
Stap 6: Herstart OpenClaw
Pas je wijzigingen toe door de OpenClaw gateway te herstarten:
bash
openclaw gateway restartStap 7: Controleer de verbinding
Bevestig eerst dat de server correct geregistreerd is:
bash
openclaw mcp doctor easyship --probeBevestig daarna dat alles end-to-end werkt door OpenClaw te vragen:
Haal mijn laatste 5 Easyship-zendingen op waarbij het label nog niet is gekocht
Je zou een tabel moeten zien met je meest recente 5 zendingen uit de lijst "To Ship". Als er resultaten verschijnen, is je setup voltooid.
Probeer het uit
Eenmaal verbonden detecteert OpenClaw automatisch wanneer de Easyship skill gebruikt moet worden — beschrijf je taak gewoon in gewone taal. Probeer een prompt zoals:
Ik wil een pakket versturen van New York, VS naar Toronto, Canada. Oorsprong: 350 5th Avenue, New York, US 10001. Bestemming: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Pakket: 1,98 lb, 6 × 4 × 2 cm. Artikel: Zakelijke documenten, aantal 1, HS Code 4911.99, aangegeven waarde $1,00 USD, categorie documenten, DDU. Laat me de goedkoopste en beste verzendopties zien met levertijden en koeriersnamen.
Voor een volledige lijst van beschikbare tools en workflows, zie de Easyship MCP Developer Docs.
Tips voor de beste resultaten:
- Voeg belangrijke details toe in je prompts (oorsprong, bestemming, gewicht, afmetingen)
- Wees specifiek over wat je wilt (bijv. "goedkoopste optie" of "snelste levering")
- Gebruik natuurlijke taal — geen commando's nodig
Beschikbare acties
| Tool | Actie | Beschrijving |
| validate_address | Adresvalidatie | Controleer of een adres bezorgbaar is en krijg voorgestelde correcties |
| get_rates | Vergelijk koeriersprijzen | Bekijk verzendkostenopties voordat je iets verstuurt |
| create_shipment | Maak een zending aan | Start een zending als concept of koop direct een label |
| create_label | Koop een label | Koop en genereer een verzendlabel voor een bestaand zending-ID |
| get_shipment | Zendingsdetails | Zoek één zending op — status, kosten en documentlinks |
| list_shipments | Zoek zendingen | Blader of filter je zendingen op land, labelstatus, enz. |
| update_shipment | Werk een zending bij | Pas details aan van een bestaande zending voordat deze wordt verzonden |
| cancel_shipment | Annuleer een zending | Annuleer een zending die nog niet is verzonden |
| delete_shipment | Verwijder een concept | Verwijder een niet-verzonden conceptzending |
| track_shipment | Volgstatus | Bekijk huidige status, geschatte aankomsttijd en recente trackinggebeurtenissen |
| list_pickups | Lijst ophaalafspraken | Bekijk geplande ophaalafspraken per datum, koerier of status |
| get_pickup | Ophaalafspraakdetails | Volledige details van één geplande ophaalafspraak |
| get_pickup_slots | Beschikbare ophaalvensters | Bekijk beschikbare koeriersophaalvensters voordat je boekt |
| create_pickup | Plan een ophaalafspraak | Boek een koerier om één of meer pakketten op te halen |
| cancel_pickup | Annuleer een ophaalafspraak | Annuleer een geplande ophaalafspraak |
| list_transactions | Transactieregister | Bekijk kosten en tegoeden op je Easyship-account |
| analytics_shipments | Trend van zendingvolume | Zendingen gemaakt over tijd, met dagelijks volume |
| analytics_top_couriers | Koeriersmix per volume | Welke vervoerders je het meest gebruikt |
| analytics_top_destinations | Topbestemmingen | Waar je de meeste pakketten naartoe stuurt |
Probleemoplossing
Er gebeurt niets als je een verzoek typt
- Zorg dat OpenClaw draait
- Herstart OpenClaw
- Probeer een duidelijkere prompt (bijv. "Haal verzendtarieven op naar Canada")
API- of authenticatiefouten
- Controleer of EASYSHIP_API_ACCESS_TOKEN correct is ingesteld in je shell
- Zorg dat je Easyship-account actief is en dat het token alle vereiste scopes heeft
Sommige tools werken, maar andere niet
- Een ontbrekende scope zorgt ervoor dat de specifieke tool faalt. Controleer nogmaals of je token alle in Stap 1 genoemde scopes bevat.
Skill wordt niet gedetecteerd
- Bevestig dat het mappad correct is: ~/.openclaw/skills/easyship-official/
- Zorg dat SKILL.md in de map aanwezig is
- Herstart OpenClaw
MCP-server maakt geen verbinding
- Voer openclaw mcp doctor easyship --probe uit om te bevestigen dat de server correct geregistreerd is
- Zorg dat EASYSHIP_API_ACCESS_TOKEN is ingesteld voordat je het openclaw mcp set commando uitvoert in Stap 5
- Herstart OpenClaw na het registreren of bijwerken van de MCP-server
Veelgestelde vragen
Kan ik een bestaand API-token gebruiken, of heb ik een nieuw token nodig?
Je kunt een bestaand token gebruiken. Zorg er alleen voor dat het alle vereiste scopes bevat die in Stap 1 zijn vermeld.
Waarom werkt mijn API-token niet?
Controleer de scopes in het Easyship Dashboard onder Connect → API. Schakel alle in Stap 1 genoemde scopes in voor volledige toegang.
Moet ik betalen voor het API-token?
Nee. Easyship biedt API-toegang op alle abonnementen zonder extra kosten. Als je de inbegrepen API-limieten van je abonnement overschrijdt, kunnen er extra kosten in rekening worden gebracht.