aftership

What This Skill Does

The AfterShip skill for OpenClaw integrates the powerful AfterShip tracking API directly into your AI agent workflow. This skill allows your agent to perform end-to-end shipment management, including courier detection, tracking creation, status updates, and notification management. By leveraging the AfterShip API, the agent can monitor packages across hundreds of global couriers without manual intervention. It provides a structured interface to list existing trackings, pull detailed tracking information, and re-trigger tracking for expired entries, ensuring that logistics information is always synchronized with your agent's task context.

Installation

To integrate this skill into your agent, use the OpenClaw command-line interface. First, ensure you have an active AfterShip API key. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/aiwithabidi/aftership

Once installed, you must configure the environment variable AFTERSHIP_API_KEY with your specific API credentials. This variable is strictly required for the Python script to authenticate requests against AfterShip servers. Verify installation by running a courier list command through the script to ensure connectivity.

Use Cases

This skill is ideal for businesses and power users managing logistics through automated agents. Primary use cases include: 1) E-commerce customer support, where an agent automatically retrieves shipment status for customer inquiries. 2) Operational dashboards, where an agent monitors critical shipments and alerts users if a delivery is delayed. 3) Automated notifications, where the agent adds tracking for new orders and sets up email or SMS alerts based on shipment milestones. 4) Courier identification, where a user provides only a tracking number and the agent determines the correct carrier automatically.

Example Prompts

1. "Check the status of my order with tracking number 1Z9999999999 and tell me the last checkpoint information."
2. "Add a new tracking for my package arriving via FedEx with tracking number 987654321 and send updates to [email protected]."
3. "List all current shipments that have been inactive for more than 48 hours and retrack them."

Tips & Limitations

To maximize performance, always provide the courier slug when creating trackings to increase accuracy, although the detect-courier command is available if the slug is unknown. Note that API rate limits apply based on your specific AfterShip subscription plan; ensure your agent's frequency of polling does not exceed these limits. Always validate that the provided phone numbers or emails are in the correct format before passing them to the create-tracking function to avoid API errors.