✓ Verified 💻 Development ✓ Enhanced Data

Package Tracker

Track packages and shipments via the 17track API.

Rating
4 (18 reviews)
Downloads
2,194 downloads
Version
1.0.0

Overview

Track packages and shipments via the 17track API.

Complete Documentation

View Source →

Package Tracker

Track packages via the 17track universal API. Supports FedEx, UPS, DHL, CTT, China Post, Royal Mail, USPS, and 2000+ other carriers with automatic carrier detection.

Setup

Run once from the skill directory:

bash
cd /root/.openclaw/workspace/skills/package-tracker
bash scripts/setup.sh

Then edit scripts/.env to add your API key:

text
SEVENTEEN_TRACK_API_KEY=your_key_here

Get a free key at https://admin.17track.net (100 registrations/month, unlimited status checks).

Usage

All commands run from the skill directory. Activate the venv first:

bash
cd /root/.openclaw/workspace/skills/package-tracker
source scripts/venv/bin/activate

Add a Package

bash
python scripts/cli.py add "TRACKING_NUMBER" -d "Description of contents"
  • Carrier is auto-detected from the tracking number format
  • Override with -c "FedEx" if needed
  • Uses 1 registration from monthly quota (100/month free)
  • Returns a tracking URL for the detected carrier

Check for Updates

bash
python scripts/cli.py check
  • Queries 17track for all active packages
  • Prints status changes and new tracking events
  • Outputs notifications to stdout for OpenClaw to relay via native messaging
  • gettrackinfo calls are free and unlimited

List Packages

bash
python scripts/cli.py list          # Active only
python scripts/cli.py list --all    # Include delivered/inactive

Package Details

bash
python scripts/cli.py details "TRACKING_NUMBER"

Shows full tracking history with all events, locations, and timestamps.

Remove a Package

bash
python scripts/cli.py remove "TRACKING_NUMBER"

Deactivates tracking (does not delete history).

Check API Quota

bash
python scripts/cli.py quota

Shows registrations used this month vs. the 100/month free limit.

Cron Integration

Set up periodic checks with cron or OpenClaw heartbeats.

Using cron (every 3 hours)

bash
# Add to crontab:
0 */3 * * * cd /root/.openclaw/workspace/skills/package-tracker && scripts/venv/bin/python scripts/check_updates.py --quiet

Using OpenClaw heartbeat

In your heartbeat logic, include:

bash
cd /root/.openclaw/workspace/skills/package-tracker
source scripts/venv/bin/activate
python scripts/check_updates.py

The check_updates.py script:

  • Checks all active packages for updates
  • Prints notifications to stdout for OpenClaw to relay
  • Exits 0 on success, 1 on error
  • Use --quiet to suppress output when there are no updates

Notifications

When updates are detected, the tracker outputs formatted notifications to stdout. OpenClaw reads this output and relays it via its native message tool — which works on Telegram, Signal, Discord, WhatsApp, or whatever channel the user has configured.

Tracking URLs

Every package gets a carrier-specific tracking URL:

CarrierURL Pattern
FedExfedex.com/fedextrack/?trknbr={tn}
UPSups.com/track?tracknum={tn}
DHLdhl.com/en/express/tracking.html?AWB={tn}
CTTctt.pt/.../objectSearch.jspx?objects={tn}
USPStools.usps.com/go/TrackConfirmAction?tLabels={tn}
Fallbackt.17track.net/en#nums={tn}
The get_tracking_url(tracking_number, carrier) function in tracker.py generates these.

Status Codes

StatusEmojiMeaning
pending⏳Just added, not yet checked
Not Found❓17track has no data yet
In Transit🚚Package is moving
Pick Up📬Ready for pickup
Delivered✅Delivered (auto-deactivated)
Undelivered⚠️Delivery attempt failed
Expired⌛Tracking data expired
Alert🚨Exception or issue
Delivered packages are automatically deactivated.

Data Storage

  • Database: scripts/data/tracker.db (SQLite)
  • Tables: packages, tracking_events, api_usage
  • All data is local. Nothing is sent externally except 17track API calls.

Environment Variables

VariableRequiredDescription
SEVENTEEN_TRACK_API_KEYYes17track API key from admin.17track.net

Troubleshooting

  • "API key not set" — Edit scripts/.env and add your 17track key
  • "Monthly limit reached" — Free tier is 100 registrations/month. Wait or upgrade.
  • No carrier detected — Pass -c "CarrierName" when adding, or let 17track auto-detect (carrier code 0)

References

  • references/carriers.md — Full list of supported carriers with patterns and URLs
  • references/17track-api.md — API endpoint reference, status codes, rate limits

Installation

Terminal bash 

openclaw install package-tracker
Copied!

💻Code Examples

SEVENTEEN_TRACK_API_KEY=your_key_here

seventeentrackapikeyyourkeyhere.txt
Get a free key at https://admin.17track.net (100 registrations/month, unlimited status checks).

## Usage

All commands run from the skill directory. Activate the venv first:

python scripts/cli.py add "TRACKING_NUMBER" -d "Description of contents"

python-scriptsclipy-add-trackingnumber--d-description-of-contents.txt
- Carrier is auto-detected from the tracking number format
- Override with `-c "FedEx"` if needed
- Uses 1 registration from monthly quota (100/month free)
- Returns a tracking URL for the detected carrier

### Check for Updates

python scripts/cli.py check

python-scriptsclipy-check.txt
- Queries 17track for all active packages
- Prints status changes and new tracking events
- Outputs notifications to stdout for OpenClaw to relay via native messaging
- gettrackinfo calls are free and unlimited

### List Packages

python scripts/cli.py details "TRACKING_NUMBER"

python-scriptsclipy-details-trackingnumber.txt
Shows full tracking history with all events, locations, and timestamps.

### Remove a Package

python scripts/cli.py remove "TRACKING_NUMBER"

python-scriptsclipy-remove-trackingnumber.txt
Deactivates tracking (does not delete history).

### Check API Quota

python scripts/cli.py quota

python-scriptsclipy-quota.txt
Shows registrations used this month vs. the 100/month free limit.

## Cron Integration

Set up periodic checks with cron or OpenClaw heartbeats.

### Using cron (every 3 hours)

0 */3 * * * cd /root/.openclaw/workspace/skills/package-tracker && scripts/venv/bin/python scripts/check_updates.py --quiet

0-3----cd-rootopenclawworkspaceskillspackage-tracker--scriptsvenvbinpython-scriptscheckupdatespy---quiet.txt
### Using OpenClaw heartbeat

In your heartbeat logic, include:
example.sh
cd /root/.openclaw/workspace/skills/package-tracker
source scripts/venv/bin/activate
python scripts/check_updates.py

Tags

#coding_agents-and-ides #api

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author joaoleitegmr
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install package-tracker

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0