A powerful logistics tracking skill that automatically identifies and tracks packages from major courier services using the Kuaidi100 API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install express-tracking
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 express-tracking 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 Express Tracking Skill?
This skill enables AI agents to provide real-time logistics updates for over a dozen major courier services, including SF Express, JD Logistics, and EMS. By integrating with the Kuaidi100 API, it offers a streamlined way for Openclaw Skills users to monitor package movement without leaving their terminal or agent interface.
The skill handles the complexities of courier identification and data formatting, delivering a clean, chronological timeline of shipping events. It is designed to be highly reliable, supporting various shipping codes and providing detailed status updates from pickup to final delivery.
Express Tracking Skill Use Cases
- Checking the delivery status of an e-commerce order using just the tracking number.
- Automating logistics monitoring for business shipments to ensure timely arrivals.
- Retrieving detailed transit history for packages across multiple carriers like ZTO, YTO, or Yunda.
- Accessing SF Express tracking which requires specific sender/receiver phone verification.
How Express Tracking Skill Works
- The AI agent receives a user query regarding a package or logistics status.
- The agent prompts the user for the tracking number if it was not provided in the initial query.
- The system automatically identifies the courier company based on the tracking number prefix or allows for manual specification.
- A request is sent to the Kuaidi100 API using the configured key and customer ID.
- The skill processes the raw API response and generates a formatted, human-readable logistics timeline for the user.
Express Tracking Skill Setup
First, ensure you have python3 installed on your system. You will need to obtain an API key from Kuaidi100 and configure your credentials in the config.json file:
{
"key": "YOUR_API_KEY",
"customer": "YOUR_CUSTOMER_ID",
"default_phone": "Last 4 digits for SF"
}
To run a basic tracking query, use the following command:
python3 scripts/track.py <tracking_number>
Express Tracking Skill Data Schema & Taxonomy
The skill utilizes a config.json file for API authentication and produces formatted logs. Below is the metadata taxonomy used:
| Attribute | Description |
|---|---|
| key | Your unique Kuaidi100 API Key |
| customer | Your Kuaidi100 Customer ID |
| default_phone | The last four digits of the phone number (required for SF Express) |
| tracking_number | The unique parcel identifier provided by the courier |
| courier_code | The internal shorthand for the logistics provider (e.g., 'shunfeng', 'jd') |
Express Tracking Skill Advanced Features
- Automatic courier recognition based on tracking number patterns to reduce manual input.
- Support for SF Express four-digit phone number verification for secure tracking.
- Formatted timeline output that presents logistics data in a clear, easy-to-read list.
- Multi-agent compatibility within the Openclaw Skills ecosystem for automated status reporting.
- Daily quota management to optimize usage of free-tier API limits (100 queries/day).
SKILL.md
Loading
Related Openclaw Skills
Skill Auditor
A comprehensive security auditing tool designed to scan, score, and validate the safety of Openclaw Skills before and after installation.
Webhook Router for OpenClaw
A versatile webhook receiver and routing engine that connects external services to your agent via secure HTTPS endpoints.
Qdrant Advanced Vector Operations
A high-performance toolkit for managing Qdrant vector databases, enabling semantic search and intelligent document ingestion.
n8n Workflow Templates
A collection of production-ready n8n workflow templates and deployment scripts designed for AI agent automation and system monitoring.
PhysicClaw-VEA
A sophisticated 3D visualization framework that creates a reactive digital entity with custom shaders and emotional state tracking.
Antfarm Workflows
A robust multi-agent orchestration framework for executing complex software development pipelines autonomously within OpenClaw.