Package Tracker for Openclaw

A unified package tracking layer that enables AI agents to query worldwide express logistics via a single API interface.

openlang-cn
v1.0.1
Mar 12, 2026
0
998
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install package-track

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install package-track 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?

Package Tracker is a high-performance utility designed for the Openclaw Skills ecosystem, providing a standardized bridge between AI agents and global logistics providers. It simplifies the complexity of interacting with multiple courier APIs by offering a unified request structure and response format, making it an essential tool for developers building e-commerce assistants or shipping management bots.

By leveraging this skill, developers can seamlessly integrate real-time tracking capabilities without writing custom logic for every shipping carrier. While it begins with robust support for Kdniao (快递鸟), the architecture is intentionally extensible, allowing for the addition of any global shipping provider to maintain a consistent tracking experience within Openclaw Skills.

Package Tracker Use Cases

  • Real-time parcel tracking using tracking numbers and shipper codes.
  • Automating logistics notifications for e-commerce platforms.
  • Integrating express query functionality directly into AI-driven coding environments.
  • Handling specialized courier requirements, such as SF Express phone digit verification.

How Package Tracker Works

  1. The AI agent receives a request to track a package and identifies the appropriate Openclaw Skills command.
  2. The system checks the local package_tracker.json configuration for valid API credentials.
  3. The skill formats a request to the provider (e.g., Kdniao) using the required MD5 and Base64 signing protocols.
  4. Logistics data is retrieved from the provider's endpoint and normalized into a clean JSON response.
  5. The tracking details are returned to the user or integrated into the application workflow.

Package Tracker Setup

To get started with Package Tracker in your Openclaw Skills environment, follow these steps:

  1. Locate the skill directory and prepare your configuration:
cp package_tracker.json.example package_tracker.json
  1. Edit package_tracker.json to include your ebusiness_id and api_key for your chosen provider.
  2. Verify the installation by running a manual query via the CLI:
python -m package_tracker track ZTO 638650888018

Package Tracker Data Schema & Taxonomy

The skill manages configuration and API communication through a structured schema to ensure compatibility across Openclaw Skills integrations:

File / Field Description
package_tracker.json Stores provider-specific API keys and default settings.
ShipperCode The standardized code for the courier (e.g., ZTO, SF, DHL).
LogisticCode The unique tracking number for the parcel.
CustomerName Optional/Required field for specific couriers (e.g., last 4 digits of phone).
registry.py Centralized registry for managing multiple provider modules.

Package Tracker Advanced Features

  • Multi-provider support through a modular registry system for easy expansion.
  • Secure credential management using JSON-based configuration files to keep API keys out of the source code.
  • Seamless Python API integration for programmatic use within complex AI agent workflows.
  • Support for specialized request types including real-time instant queries and signed URL-encoded payloads.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*