This article explains how to install the Easyship Official Skill in OpenClaw so you can manage shipments using natural language, including getting rates, creating shipments, buying labels, scheduling pickups, and tracking deliveries.
Before You Begin
You'll need:
- OpenClaw installed and running on your machine
- Access to your Easyship Dashboard
- An Easyship account (API access is available on all plans at no extra cost)
If you haven't installed OpenClaw yet, follow the official OpenClaw setup guide before continuing.
Step 1: Get Your Easyship API Token
- Go to your Easyship Dashboard and click Connect
- Click New Integration
- Scroll down to API Integration
- Under Integration Type, select I am developing a custom integration
- Name the key Easyship MCP for easy reference
- Keep the default version 2024-09 and click Connect
- On the next page, click Access Token and copy it using the copy button
Required scopes: Your API token must include the following scopes. Missing scopes will cause some tools to fail while others continue to work.
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:readYou can check and update scopes at any time in Dashboard → Connect → API without creating a new token.
Step 2: Download and Install the Easyship Skill
- Go to the Easyship Official skill page on ClawHub and download the skill folder
- Move the downloaded folder into your OpenClaw skills directory:
bash
~/.openclaw/skills/
Your folder structure should look like this:
~/.openclaw/skills/easyship-official/SKILL.mdNote: OpenClaw requires a SKILL.md file to load a skill correctly. Make sure this file exists inside the folder before continuing.
Step 3: Connect Your Easyship Account
Set your Easyship API token as an environment variable. To make this persist across sessions and restarts, add it to your shell profile:
bash
# For bash
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.bashrc
source ~/.bashrc
# For zsh (macOS default)
echo 'export EASYSHIP_API_ACCESS_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
source ~/.zshrcReplace YOUR_TOKEN with the API token you copied in Step 1.
Security: Never share your API token in a chat window or commit it to version control. If you accidentally expose it, revoke and rotate your key immediately in the Easyship Dashboard under Connect → API.
Step 4: Restart OpenClaw
Apply your changes by restarting the OpenClaw gateway:
bash
openclaw gateway restartStep 5: Verify the Connection
Confirm everything is working by prompting OpenClaw:
Fetch my last 5 Easyship shipments where label is not yet purchased
You should see a table of your most recent 5 shipments from the "To Ship" list. If results appear, your setup is complete.
Try It Out
Once connected, OpenClaw automatically detects when to use the Easyship skill — just describe your task in plain language. Try a prompt like:
I want to ship a parcel from New York, USA to Toronto, Canada. Origin: 350 5th Avenue, New York, US 10001. Destination: 220 Yonge Street, Toronto, ON, Canada M5B 2H1. Parcel: 1.98 lb, 6 × 4 × 2 cm. Item: Business documents, quantity 1, HS Code 4911.99, declared value $1.00 USD, category documents, DDU. Show me the cheapest and best value shipping options with delivery times and courier names.
For a full list of available tools and workflows, see the Easyship MCP Developer Docs.
Tips for best results:
- Include key details in your prompts (origin, destination, weight, dimensions)
- Be specific about what you want (e.g. "cheapest option" or "fastest delivery")
- Use natural language — no commands needed
Available Actions
| Tool | Action | Description |
| validate_address | Address validation | Check if an address is deliverable and get suggested corrections |
| get_rates | Compare courier rates | See shipping cost options before you send anything |
| create_shipment | Create shipment | Start a shipment as a draft or buy a label immediately |
| create_label | Buy a label | Buy and generate a shipping label for an existing shipment ID |
| get_shipment | Shipment details | Look up one shipment — status, costs, and document links |
| list_shipments | Search shipments | Browse or filter your shipments by country, label status, etc. |
| update_shipment | Update a shipment | Fix details on an existing shipment before it ships |
| cancel_shipment | Cancel a shipment | Cancel a shipment that hasn't moved yet |
| delete_shipment | Delete a draft | Remove an unshipped draft shipment |
| track_shipment | Tracking status | See current status, ETA, and recent tracking events |
| list_pickups | List pickups | See scheduled pickups by date, courier, or status |
| get_pickup | Pickup detail | Full details for one scheduled pickup |
| get_pickup_slots | Available pickup windows | See available courier pickup windows before booking |
| create_pickup | Schedule a pickup | Book a courier to collect one or more packages |
| cancel_pickup | Cancel a pickup | Cancel a scheduled pickup |
| list_transactions | Transaction ledger | Review charges and credits on your Easyship account |
| analytics_shipments | Shipment volume trend | Shipments created over time, with daily volume |
| analytics_top_couriers | Courier mix by volume | Which carriers you use most |
| analytics_top_destinations | Top destinations | Where you send the most packages |
Troubleshooting
Nothing happens when you type a request
- Make sure OpenClaw is running
- Restart OpenClaw
- Try a clearer prompt (e.g. "Get shipping rates to Canada")
API or authentication errors
- Check that EASYSHIP_API_ACCESS_TOKEN is set correctly in your shell
- Make sure your Easyship account is active and the token has all required scopes
Some tools work but others fail
- A missing scope will cause its specific tool to fail. Double-check that your token has all the scopes listed in Step 1.
Skill not detected
- Confirm the folder path is correct: ~/.openclaw/skills/easyship-official/
- Ensure SKILL.md exists inside the folder
- Restart OpenClaw
FAQs
Can I use an existing API token, or do I need a new one?
You can use an existing token. Just make sure it has all the required scopes listed in Step 1.
Why is my API token not working?
Check the scopes in the Easyship Dashboard under Connect → API. Enable all the scopes listed in Step 1 for full access.
Do I need to pay for the API token?
No. Easyship provides API access across all plans at no extra cost. If you exceed the included API limits for your plan, overage fees may apply. See [pricing plans and included limits].