← Back to Skills Marketplace
harrylabsj

Logistics

by haidong · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
359
Downloads
0
Stars
4
Active Installs
3
Versions
Install in OpenClaw
/install logistics
Description
Query and explain parcel logistics across courier providers, including tracking, courier identification, multi-package lookup, status interpretation, and del...
README (SKILL.md)

Logistics

Overview

Use this skill to help the user track parcels, identify couriers, interpret logistics statuses, and understand what a shipment update usually means. It serves as a unified entry point for multi-courier logistics queries, including major Chinese courier networks such as SF Express (顺丰), JD Logistics (京东快递), ZTO (中通), Cainiao (菜鸟), J&T Express (极兔), and others.

Workflow

  1. Identify whether the user has:
    • one tracking number
    • multiple tracking numbers
    • an unknown courier
    • a status they want explained
  2. If the courier is unknown, infer cautiously from the number pattern or context.
  3. Return the latest useful tracking interpretation first.
  4. If a package appears delayed, explain likely reasons and a reasonable next action.
  5. Keep summaries concise when handling multiple shipments.
Usage Guidance
What to consider before installing: - The skill will create a SQLite DB (~/.openclaw/data/logistics/logistics.db) and an encrypted storage area (~/.openclaw/data/logistics/secure) and will write a key file (.key) with 0600 perms. Expect persistent local data and encrypted blobs. If you don't want local persistence, don't install. - There is no install script; requirements.txt contains heavy native deps (cryptography, opencv, pyzbar). Make sure you trust the author and are prepared to install these packages (they may require system libraries). The absence of an explicit install step is an operational risk. - The secure storage code is intended to protect data but uses an odd key-derivation approach (PBKDF2 with random inputs) that looks buggy and may break or not yield a proper Fernet key. This appears to be sloppy/incorrect engineering rather than malicious, but it reduces confidence in the encryption correctness. - The current query() implementation returns simulated data and does not call external APIs, but the client contains an API_BASE and imports aiohttp — the code could be extended to make network calls (e.g., to kuaidi100) in future versions. If you need networked tracking, ask the author how API keys are handled and whether any outbound endpoints are contacted. - If you plan to install, review the code (especially secure storage and any networking) yourself or ask the author to explain: (1) why the KDF is used that way, (2) whether any external endpoints are contacted and how API keys are stored/used, and (3) provide an explicit install mechanism or containerized packaging to avoid surprise native installs. - If you are uncomfortable with local file writes or installing native libs, avoid installing this skill or run it in a restricted environment (container or VM).
Capability Analysis
Type: OpenClaw Skill Name: logistics Version: 1.0.2 The logistics skill is a well-structured tool designed to track parcel delivery statuses across various Chinese couriers. It features a local SQLite database for history tracking and a custom 'security.py' module that uses Fernet encryption to protect stored data. While the 'requirements.txt' file includes several unused dependencies related to image processing (e.g., opencv-python, pyzbar), the core logic in 'logistics.py' is functional, uses parameterized SQL queries to prevent injection, and restricts file operations to its own data directory. No evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description (multi-courier parcel tracking) aligns with the code: carrier detection, queries (currently simulated), batch handling, history and subscription features. Persisting history/subscriptions locally and supporting QR/barcode libs (requirements) is plausible for this purpose, though the README does not explicitly mention local DB or secure storage.
Instruction Scope
SKILL.md describes only tracking and interpretation. The packaged code, however, creates a SQLite DB under ~/.openclaw/data/logistics, manages subscriptions, and uses an encrypted secure storage area under ~/.openclaw/data/<app>/secure. The instructions do not call out these file writes or persistence, so users should be aware the skill will store local data.
Install Mechanism
No install spec is provided even though requirements.txt lists many non-trivial native/third-party packages (cryptography, opencv, pyzbar, etc.). That mismatch is problematic: installation may fail or require compiling native deps and the skill may attempt imports that won't work without explicit install steps. The lack of an install mechanism plus heavy deps increases friction and risk.
Credentials
The skill requests no environment variables or external credentials (SKILL metadata shows none). It does write files into the user's home (SQLite DB and encrypted files) and creates a key file at ~/.openclaw/.../.key with 0600 perms. Local storage is proportional to history/subscription features, but the secure key-generation logic is unusual (see below) and merits review.
Persistence & Privilege
always is false; the skill does not ask for platform-wide privileges and confines files to a self-named ~/.openclaw directory. It will persist history, subscriptions, and an encryption key locally which is normal for a local helper, but users should accept that local data will be created and retained unless removed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install logistics
  3. After installation, invoke the skill by name or use /logistics
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
English main doc for multi-courier logistics tracking
v1.0.1
English-first documentation update
v1.0.0
- Initial release of the logistics skill. - Enables parcel tracking, courier identification, and multi-package lookup across providers. - Explains shipment progress updates and status meanings. - Offers guidance for delayed packages, including likely reasons and suggested next steps. - Supports concise summaries for multiple shipments and helps interpret courier-specific details.
Metadata
Slug logistics
Version 1.0.2
License MIT-0
All-time Installs 5
Active Installs 4
Total Versions 3
Frequently Asked Questions

What is Logistics?

Query and explain parcel logistics across courier providers, including tracking, courier identification, multi-package lookup, status interpretation, and del... It is an AI Agent Skill for Claude Code / OpenClaw, with 359 downloads so far.

How do I install Logistics?

Run "/install logistics" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Logistics free?

Yes, Logistics is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Logistics support?

Logistics is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Logistics?

It is built and maintained by haidong (@harrylabsj); the current version is v1.0.2.

💬 Comments