Cet article explique comment installer la compétence officielle Easyship dans OpenClaw afin que vous puissiez gérer les expéditions en utilisant un langage naturel, y compris obtenir des tarifs, créer des expéditions, acheter des étiquettes, planifier des enlèvements et suivre les livraisons.
Avant de commencer
Vous aurez besoin de :
- OpenClaw installé et en fonctionnement sur votre machine
- Accès à votre tableau de bord Easyship
- Un compte Easyship (l'accès API est disponible sur tous les plans sans coût supplémentaire)
Si vous n'avez pas encore installé OpenClaw, suivez le guide officiel d'installation d'OpenClaw avant de continuer.
Étape 1 : Obtenez votre jeton API Easyship
- Allez sur votre tableau de bord Easyship et cliquez sur Connecter
- Cliquez sur Nouvelle intégration
- Faites défiler jusqu'à Intégration API
- Sous Type d’intégration, sélectionnez Je développe une intégration personnalisée
- Nommez la clé Easyship MCP pour une référence facile
- Gardez la version par défaut 2024-09 et cliquez sur Connecter
- Sur la page suivante, cliquez sur Jeton d’accès et copiez-le en utilisant le bouton de copie
Portées requises : Votre jeton API doit inclure les portées suivantes. L'absence de certaines portées entraînera l'échec de certains outils tandis que d'autres continueront de fonctionner.
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:readVous pouvez vérifier et mettre à jour les portées à tout moment dans Tableau de bord → Connecter → API sans créer un nouveau jeton.
Étape 2 : Téléchargez et installez la compétence Easyship
- Rendez-vous sur la page officielle de la compétence Easyship sur ClawHub et téléchargez le dossier de la compétence
- Déplacez le dossier téléchargé dans votre répertoire des compétences OpenClaw :
bash
~/.openclaw/skills/
La structure de votre dossier doit ressembler à ceci :
~/.openclaw/skills/easyship-official/SKILL.mdNote : OpenClaw nécessite un fichier SKILL.md pour charger correctement une compétence. Assurez-vous que ce fichier existe dans le dossier avant de continuer.
Étape 3 : Téléchargez et installez la compétence Easyship
Installez la compétence en utilisant l'interface en ligne de commande OpenClaw, qui gère correctement le placement des fichiers :
bash
openclaw skills install @paulld/easyship-officialCela télécharge la compétence depuis la page officielle Easyship sur ClawHub et l’installe à :
~/.openclaw/skills/easyship-official/SKILL.mdNote : OpenClaw nécessite un fichier SKILL.md à ce chemin pour charger correctement la compétence. Si vous installez manuellement au lieu d'utiliser la CLI, téléchargez le dossier de la compétence depuis la page ClawHub et placez-le au même chemin.
Étape 4 : Connectez votre compte Easyship
Définissez votre jeton API Easyship en tant que variable d'environnement. Pour que cela persiste entre les sessions et les redémarrages, ajoutez-le à votre profil shell :
bash
# Pour bash
echo 'export EASYSHIP_API_ACCESS_TOKEN="VOTRE_JETON"' >> ~/.bashrc
source ~/.bashrc
# Pour zsh (par défaut sur macOS)
echo 'export EASYSHIP_API_ACCESS_TOKEN="VOTRE_JETON"' >> ~/.zshrc
source ~/.zshrcRemplacez VOTRE_JETON par le jeton API que vous avez copié à l'Étape 1.
Sécurité : Ne partagez jamais votre jeton API dans une fenêtre de chat ni ne le commettez dans un contrôle de version. Si vous l'exposez accidentellement, révoquez et changez immédiatement votre clé dans le tableau de bord Easyship sous Connecter → API.
Étape 5 : Connectez le serveur Easyship MCP
L'installation de la compétence apprend seulement à OpenClaw comment utiliser les outils Easyship — cela ne les connecte pas encore. Enregistrez séparément le serveur MCP pour que ces outils deviennent disponibles :
bash
openclaw mcp set easyship '{"url":"https://mcp.easyship.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${EASYSHIP_API_ACCESS_TOKEN}"}}'L'utilisation de ${EASYSHIP_API_ACCESS_TOKEN} au lieu de coller directement votre jeton permet de le garder hors de votre configuration OpenClaw enregistrée.
Étape 6 : Redémarrez OpenClaw
Appliquez vos modifications en redémarrant la passerelle OpenClaw :
bash
openclaw gateway restartÉtape 7 : Vérifiez la connexion
Commencez par confirmer que le serveur s’est bien enregistré :
bash
openclaw mcp doctor easyship --probePuis confirmez que tout fonctionne de bout en bout en demandant à OpenClaw :
Récupère mes 5 dernières expéditions Easyship dont l’étiquette n’est pas encore achetée
Vous devriez voir un tableau de vos 5 expéditions les plus récentes dans la liste « À expédier ». Si des résultats apparaissent, votre configuration est terminée.
Essayez-le
Une fois connecté, OpenClaw détecte automatiquement quand utiliser la compétence Easyship — décrivez simplement votre tâche en langage clair. Essayez une commande comme :
Je veux expédier un colis de New York, États-Unis, à Toronto, Canada. Origine : 350 5th Avenue, New York, US 10001. Destination : 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Colis : 1,98 lb, 6 × 4 × 2 cm. Article : documents commerciaux, quantité 1, code SH 4911.99, valeur déclarée 1,00 $ USD, catégorie documents, DDU. Montre-moi les options d’expédition les moins chères et les meilleures en valeur avec les délais de livraison et les noms des transporteurs.
Pour une liste complète des outils et flux de travail disponibles, consultez les docs développeur Easyship MCP.
Conseils pour de meilleurs résultats :
- Incluez les détails clés dans vos commandes (origine, destination, poids, dimensions)
- Soyez précis sur ce que vous voulez (par exemple « option la moins chère » ou « livraison la plus rapide »)
- Utilisez un langage naturel — pas besoin de commandes spécifiques
Actions disponibles
| Outil | Action | Description |
| validate_address | Validation d’adresse | Vérifiez si une adresse est livrable et obtenez des corrections suggérées |
| get_rates | Comparer les tarifs des transporteurs | Voir les options de coût d’expédition avant d’envoyer quoi que ce soit |
| create_shipment | Créer une expédition | Commencez une expédition en brouillon ou achetez une étiquette immédiatement |
| create_label | Acheter une étiquette | Achetez et générez une étiquette d’expédition pour un ID d’expédition existant |
| get_shipment | Détails d’expédition | Recherchez une expédition — statut, coûts et liens vers les documents |
| list_shipments | Rechercher des expéditions | Parcourez ou filtrez vos expéditions par pays, statut d’étiquette, etc. |
| update_shipment | Mettre à jour une expédition | Corriger les détails d’une expédition existante avant son envoi |
| cancel_shipment | Annuler une expédition | Annuler une expédition qui n’a pas encore été envoyée |
| delete_shipment | Supprimer un brouillon | Supprimer un brouillon d’expédition non envoyé |
| track_shipment | Statut de suivi | Voir le statut actuel, l’ETA et les événements récents de suivi |
| list_pickups | Lister les enlèvements | Voir les enlèvements programmés par date, transporteur ou statut |
| get_pickup | Détails d’enlèvement | Détails complets pour un enlèvement programmé |
| get_pickup_slots | Créneaux d’enlèvement disponibles | Voir les créneaux disponibles avant de réserver |
| create_pickup | Planifier un enlèvement | Réserver un transporteur pour collecter un ou plusieurs colis |
| cancel_pickup | Annuler un enlèvement | Annuler un enlèvement programmé |
| list_transactions | Registre des transactions | Revoir les charges et crédits sur votre compte Easyship |
| analytics_shipments | Tendance du volume d’expéditions | Expéditions créées dans le temps, avec volume quotidien |
| analytics_top_couriers | Mix des transporteurs par volume | Les transporteurs que vous utilisez le plus |
| analytics_top_destinations | Principales destinations | Où vous envoyez le plus de colis |
Dépannage
Rien ne se passe lorsque vous tapez une demande
- Assurez-vous qu’OpenClaw est en cours d’exécution
- Redémarrez OpenClaw
- Essayez une commande plus claire (par exemple « Obtenir les tarifs d’expédition vers le Canada »)
Erreurs d’API ou d’authentification
- Vérifiez que EASYSHIP_API_ACCESS_TOKEN est correctement défini dans votre shell
- Assurez-vous que votre compte Easyship est actif et que le jeton a toutes les portées requises
Certains outils fonctionnent mais d’autres échouent
- Une portée manquante entraînera l’échec de l’outil spécifique. Vérifiez que votre jeton possède toutes les portées listées à l’Étape 1.
Compétence non détectée
- Confirmez que le chemin du dossier est correct : ~/.openclaw/skills/easyship-official/
- Assurez-vous que SKILL.md existe dans le dossier
- Redémarrez OpenClaw
Le serveur MCP ne se connecte pas
- Exécutez openclaw mcp doctor easyship --probe pour confirmer que le serveur s’est bien enregistré
- Assurez-vous que EASYSHIP_API_ACCESS_TOKEN est défini avant d’exécuter la commande openclaw mcp set à l’Étape 5
- Redémarrez OpenClaw après avoir enregistré ou mis à jour le serveur MCP
FAQ
Puis-je utiliser un jeton API existant ou dois-je en créer un nouveau ?
Vous pouvez utiliser un jeton existant. Assurez-vous simplement qu’il possède toutes les portées requises listées à l’Étape 1.
Pourquoi mon jeton API ne fonctionne-t-il pas ?
Vérifiez les portées dans le tableau de bord Easyship sous Connecter → API. Activez toutes les portées listées à l’Étape 1 pour un accès complet.
Dois-je payer pour le jeton API ?
Non. Easyship fournit l’accès API sur tous les plans sans coût supplémentaire. Si vous dépassez les limites API incluses dans votre plan, des frais supplémentaires peuvent s’appliquer.