Questo articolo spiega come installare la Easyship Official Skill in OpenClaw per gestire le spedizioni usando il linguaggio naturale, inclusi il calcolo delle tariffe, la creazione delle spedizioni, l'acquisto delle etichette, la programmazione dei ritiri e il tracciamento delle consegne.
Prima di iniziare
Avrai bisogno di:
- OpenClaw installato e in esecuzione sul tuo computer
- Accesso al tuo Easyship Dashboard
- Un account Easyship (l'accesso API è disponibile su tutti i piani senza costi aggiuntivi)
Se non hai ancora installato OpenClaw, segui la guida ufficiale di configurazione di OpenClaw prima di continuare.
Passo 1: Ottieni il tuo token API Easyship
- Vai al tuo Easyship Dashboard e clicca su Connect
- Clicca su New Integration
- Scorri verso il basso fino a API Integration
- Sotto Integration Type, seleziona I am developing a custom integration
- Dai al key il nome Easyship MCP per un facile riferimento
- Mantieni la versione predefinita 2024-09 e clicca su Connect
- Nella pagina successiva, clicca su Access Token e copialo usando il pulsante copia
Scope richiesti: Il tuo token API deve includere i seguenti scope. La mancanza di alcuni scope farà fallire alcuni strumenti mentre altri continueranno a funzionare.
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:readPuoi controllare e aggiornare gli scope in qualsiasi momento in Dashboard → Connect → API senza creare un nuovo token.
Passo 2: Scarica e installa la Easyship Skill
- Vai alla pagina ufficiale della Easyship Skill su ClawHub e scarica la cartella della skill
- Sposta la cartella scaricata nella directory delle skill di OpenClaw:
bash
~/.openclaw/skills/
La struttura della tua cartella dovrebbe apparire così:
~/.openclaw/skills/easyship-official/SKILL.mdNota: OpenClaw richiede un file SKILL.md per caricare correttamente una skill. Assicurati che questo file esista all'interno della cartella prima di procedere.
Passo 3: Scarica e installa la Easyship Skill
Installa la skill usando la CLI di OpenClaw, che gestisce il posizionamento corretto dei file:
bash
openclaw skills install @paulld/easyship-officialQuesto scarica la skill dalla pagina ufficiale Easyship su ClawHub e la installa in:
~/.openclaw/skills/easyship-official/SKILL.mdNota: OpenClaw richiede un file SKILL.md in quel percorso per caricare correttamente la skill. Se installi manualmente invece di usare la CLI, scarica la cartella della skill dalla pagina ClawHub e posizionala nello stesso percorso.
Passo 4: Collega il tuo account Easyship
Imposta il tuo token API Easyship come variabile d'ambiente. Per far sì che persista tra le sessioni e i riavvii, aggiungilo al profilo della tua shell:
bash
# Per bash
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.bashrc
source ~/.bashrc
# Per zsh (default macOS)
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
source ~/.zshrcSostituisci YOUR_TOKEN con il token API copiato nel Passo 1.
Sicurezza: Non condividere mai il tuo token API in una finestra di chat o nei sistemi di controllo versione. Se lo esponi accidentalmente, revoca e ruota immediatamente la chiave nel Easyship Dashboard sotto Connect → API.
Passo 5: Collega il server Easyship MCP
L'installazione della skill insegna solo a OpenClaw come usare gli strumenti Easyship — non li collega ancora. Registra separatamente il server MCP affinché quegli strumenti diventino disponibili:
bash
openclaw mcp set easyship '{"url":"https://mcp.easyship.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${EASYSHIP_API_ACCESS_TOKEN}"}}'Usare ${EASYSHIP_API_ACCESS_TOKEN} invece di incollare direttamente il token mantiene il token fuori dalla configurazione salvata di OpenClaw.
Passo 6: Riavvia OpenClaw
Applica le modifiche riavviando il gateway OpenClaw:
bash
openclaw gateway restartPasso 7: Verifica la connessione
Prima, conferma che il server sia stato registrato correttamente:
bash
openclaw mcp doctor easyship --probeQuindi conferma che tutto funzioni end-to-end chiedendo a OpenClaw:
Recupera le mie ultime 5 spedizioni Easyship per cui l'etichetta non è ancora stata acquistata
Dovresti vedere una tabella con le tue ultime 5 spedizioni dalla lista "To Ship". Se appaiono risultati, la configurazione è completa.
Provalo
Una volta connesso, OpenClaw rileva automaticamente quando usare la skill Easyship — basta descrivere il tuo compito in linguaggio naturale. Prova un prompt come:
Voglio spedire un pacco da New York, USA a Toronto, Canada. Origine: 350 5th Avenue, New York, US 10001. Destinazione: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Pacco: 1,98 lb, 6 × 4 × 2 cm. Oggetto: Documenti aziendali, quantità 1, codice HS 4911.99, valore dichiarato $1,00 USD, categoria documenti, DDU. Mostrami le opzioni di spedizione più economiche e con il miglior rapporto qualità-prezzo con tempi di consegna e nomi dei corrieri.
Per un elenco completo degli strumenti e dei flussi di lavoro disponibili, consulta le Easyship MCP Developer Docs.
Consigli per i migliori risultati:
- Includi dettagli chiave nei tuoi prompt (origine, destinazione, peso, dimensioni)
- Sii specifico su ciò che vuoi (es. "opzione più economica" o "consegna più veloce")
- Usa il linguaggio naturale — non servono comandi
Azioni disponibili
| Strumento | Azione | Descrizione |
| validate_address | Validazione indirizzo | Controlla se un indirizzo è consegnabile e ottieni correzioni suggerite |
| get_rates | Confronta tariffe corrieri | Vedi le opzioni di costo di spedizione prima di inviare qualsiasi cosa |
| create_shipment | Crea spedizione | Avvia una spedizione come bozza o acquista subito un'etichetta |
| create_label | Acquista un'etichetta | Acquista e genera un'etichetta di spedizione per un ID spedizione esistente |
| get_shipment | Dettagli spedizione | Consulta una spedizione — stato, costi e link ai documenti |
| list_shipments | Ricerca spedizioni | Esplora o filtra le tue spedizioni per paese, stato etichetta, ecc. |
| update_shipment | Aggiorna una spedizione | Correggi dettagli su una spedizione esistente prima della spedizione |
| cancel_shipment | Annulla una spedizione | Annulla una spedizione che non è ancora partita |
| delete_shipment | Elimina una bozza | Rimuovi una bozza di spedizione non ancora inviata |
| track_shipment | Stato tracciamento | Vedi lo stato attuale, ETA e eventi recenti di tracciamento |
| list_pickups | Elenca ritiri | Vedi i ritiri programmati per data, corriere o stato |
| get_pickup | Dettaglio ritiro | Dettagli completi per un ritiro programmato |
| get_pickup_slots | Fasce orarie disponibili per il ritiro | Vedi le finestre di ritiro disponibili prima di prenotare |
| create_pickup | Programma un ritiro | Prenota un corriere per ritirare uno o più pacchi |
| cancel_pickup | Annulla un ritiro | Annulla un ritiro programmato |
| list_transactions | Registro transazioni | Rivedi addebiti e accrediti sul tuo account Easyship |
| analytics_shipments | Tendenza volume spedizioni | Spedizioni create nel tempo, con volume giornaliero |
| analytics_top_couriers | Mix corrieri per volume | Quali corrieri usi di più |
| analytics_top_destinations | Destinazioni principali | Dove invii la maggior parte dei pacchi |
Risoluzione problemi
Non succede nulla quando digiti una richiesta
- Assicurati che OpenClaw sia in esecuzione
- Riavvia OpenClaw
- Prova un prompt più chiaro (es. "Ottieni tariffe di spedizione per il Canada")
Errori API o di autenticazione
- Controlla che EASYSHIP_API_ACCESS_TOKEN sia impostato correttamente nella tua shell
- Assicurati che il tuo account Easyship sia attivo e che il token abbia tutti gli scope richiesti
Alcuni strumenti funzionano ma altri falliscono
- La mancanza di uno scope farà fallire lo strumento specifico. Ricontrolla che il tuo token abbia tutti gli scope elencati nel Passo 1.
Skill non rilevata
- Conferma che il percorso della cartella sia corretto: ~/.openclaw/skills/easyship-official/
- Assicurati che SKILL.md esista all'interno della cartella
- Riavvia OpenClaw
Il server MCP non si connette
- Esegui openclaw mcp doctor easyship --probe per confermare che il server sia stato registrato correttamente
- Assicurati che EASYSHIP_API_ACCESS_TOKEN sia impostato prima di eseguire il comando openclaw mcp set nel Passo 5
- Riavvia OpenClaw dopo aver registrato o aggiornato il server MCP
Domande frequenti
Posso usare un token API esistente o devo crearne uno nuovo?
Puoi usare un token esistente. Assicurati solo che abbia tutti gli scope richiesti elencati nel Passo 1.
Perché il mio token API non funziona?
Controlla gli scope nel Easyship Dashboard sotto Connect → API. Abilita tutti gli scope elencati nel Passo 1 per avere accesso completo.
Devo pagare per il token API?
No. Easyship fornisce l'accesso API su tutti i piani senza costi aggiuntivi. Se superi i limiti API inclusi nel tuo piano, potrebbero essere applicate tariffe extra.