A universal shipment tracking skill that enables AI agents to monitor deliveries and provide real-time status notifications for over 2,000 carriers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install package-tracker
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install package-tracker using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Package Tracker?
The Package Tracker is a sophisticated utility built for Openclaw Skills that leverages the 17track universal API to provide comprehensive shipment monitoring. It allows developers and users to track packages from global carriers like FedEx, UPS, DHL, and USPS through a unified interface. By integrating this skill, AI agents can perform carrier detection, retrieve detailed transit history, and manage multiple tracking numbers simultaneously.
This tool is designed to bridge the gap between logistics data and user communication. It automatically organizes shipment data into a local database and provides clear, actionable updates. Whether used as a standalone CLI tool or integrated into a larger automated system, this skill ensures that delivery information is always accessible and up-to-date within the Openclaw Skills ecosystem.
Package Tracker Use Cases
- Tracking multiple e-commerce orders from different international carriers in a single dashboard.
- Automating delivery notifications for business logistics using Openclaw Skills.
- Monitoring high-value shipments that require frequent status checks and location updates.
- Consolidating shipping alerts from various messaging platforms like Telegram or Discord into one automated agent workflow.
How Package Tracker Works
- The user adds a tracking number via the CLI or AI agent interface, which triggers a registration request to the 17track API.
- The skill identifies the shipping carrier automatically based on the tracking number pattern.
- A local SQLite database record is created to store package metadata and the initial status.
- Scheduled tasks (cron or heartbeats) trigger periodic status checks that utilize the API's free unlimited tracking info endpoint.
- Upon detecting a status change (e.g., In Transit to Delivered), the skill generates a formatted notification.
- The notification is pushed to the user through the active communication channel configured in Openclaw Skills.
Package Tracker Setup
To get started, navigate to the skill directory and execute the setup script:
cd /root/.openclaw/workspace/skills/package-tracker
bash scripts/setup.sh
After installation, you must provide your 17track API key. Edit the scripts/.env file and add your credentials:
SEVENTEEN_TRACK_API_KEY=your_key_here
Keys can be obtained for free from the 17track admin portal, which provides 100 new registrations per month and unlimited status updates.
Package Tracker Data Schema & Taxonomy
The skill manages information locally in a SQLite database to ensure data privacy and fast access. The schema is organized as follows:
| Table | Purpose |
|---|---|
packages |
Contains tracking numbers, carrier information, descriptions, and the current delivery state. |
tracking_events |
Stores the full chronological history of events, including timestamps and geographic locations. |
api_usage |
Monitors the number of API registrations used to stay within free tier limits. |
Package Tracker Advanced Features
- Universal carrier support with automatic detection for 2000+ providers worldwide.
- Integration with Openclaw Skills native messaging to relay updates to Telegram, Signal, or WhatsApp.
- Silent background monitoring mode for use with system-level cron jobs.
- Smart deactivation logic that stops polling for packages once they reach the Delivered status.
- Carrier-specific URL generation for direct access to official tracking pages.
SKILL.md
Loading
Related Openclaw Skills
Coding as Dressing
A specialized AI agent skill that translates complex programming logic into intuitive daily clothing and outfit metaphors for easier understanding.
Release Tracker
An automated monitoring tool that tracks GitHub releases and delivers prioritized changelog summaries to your preferred communication channels.
Smart Memory Query
A proactive memory retrieval skill that optimizes search queries to ensure AI agents maintain project continuity and context.
TOS Vectors Skill
A high-performance vector database skill for managing embeddings, similarity searches, and retrieval-augmented generation.
DeFi Yield Scout
An automated DeFi intelligence tool for scanning, comparing, and analyzing USDC yield farming opportunities on Base and Arbitrum.
n0ir DeFi Yield Scout
An AI-powered scouting tool for identifying and comparing the highest-yielding USDC pools across Base and Arbitrum.
Featured*
