A comprehensive parcel tracking integration that connects AI agents to the 17TRACK API for real-time shipment monitoring and local data persistence.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install track17
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 track17 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 track17?
The track17 skill enables AI agents within the Openclaw Skills ecosystem to interact directly with the 17TRACK Tracking API v2.2. It provides a standardized way to register, monitor, and manage international shipments while maintaining a local state using a SQLite database. This ensures that agents can quickly access parcel history, track status changes, and provide summaries without redundant API calls.
Designed for developers and power users, this skill bridges the gap between raw logistics data and actionable insights. By leveraging local storage in the workspace directory, it allows for seamless data management and even supports complex setups like webhook ingestion and signature verification for real-time delivery events.
track17 Use Cases
- Automating shipment status updates for e-commerce orders.
- Monitoring high-priority international deliveries for customs delays or delivery exceptions.
- Maintaining a centralized local database of all incoming and outgoing business logistics.
- Triggering specific AI agent workflows when a package reaches 'out for delivery' or 'delivered' status.
How track17 Works
- The skill initializes a local SQLite database within the packages directory to store tracking numbers and labels.
- Users add tracking numbers, which the skill registers with the 17TRACK remote API while optionally auto-detecting carriers.
- The sync command polls the API for updates, refreshing the local state with the latest transit milestones.
- Detailed status reports are generated from the local database, allowing the agent to analyze delivery progress.
- Optional webhook listeners can be configured to receive push notifications directly from 17TRACK for instant updates.
track17 Setup
To get started with this skill in your Openclaw Skills environment, ensure Python 3 is installed and set your API token:
export TRACK17_TOKEN='your_api_token_here'
# Initialize the local database
python3 scripts/track17.py init
# Add your first package
python3 scripts/track17.py add "TRACKING_NUMBER" --label "Package Description"
track17 Data Schema & Taxonomy
The skill organizes tracking information within the workspace using a structured file system and database:
| Component | Path | Description |
|---|---|---|
| SQLite DB | <workspace>/packages/track17/track17.sqlite3 |
Primary storage for package IDs, statuses, and timestamps. |
| Inbox | <workspace>/packages/track17/inbox/ |
Storage for raw webhook payloads before processing. |
| Metadata | SKILL.md |
Configuration for environment variables like TRACK17_TOKEN. |
track17 Advanced Features
- Local Webhook Server: Built-in support for receiving real-time push notifications from 17TRACK.
- Signature Verification: Secure webhook ingestion using
TRACK17_WEBHOOK_SECRETto validate incoming data. - Quota Management: Native command to monitor your 17TRACK API credit usage.
- Flexible Storage: Override default directories using
TRACK17_DATA_DIRfor custom homelab or cloud deployments. - Remote Deletion: Synchronize local removals with the 17TRACK cloud registry.
SKILL.md
Loading
Related Openclaw Skills
Todoist API Skill
A comprehensive CLI and automation toolkit for managing Todoist tasks, projects, and workflows via the Todoist API v1.
Reddit Readonly
A specialized tool for searching subreddits and extracting comment threads via public JSON endpoints without requiring authenticated API access.
Notion Management Skill
A JSON-first CLI skill for managing Notion pages, databases, and Markdown content with deterministic script execution.
iOS Simulator Automation
An advanced CLI wrapper that enables AI agents to programmatically control iOS simulators, manage app lifecycles, and perform accessibility-based UI navigation.
Weekly Planner
A developer-friendly, file-based weekly planning system using TOML to manage tasks, time blocks, and calendar syncs.
Wordly Wisdom
A calibrated decision-making engine for AI agents based on Charlie Munger's mental models and disciplined judgment techniques.
Featured*
