Cainiao

v1.0.0

Use Cainiao Network (菜鸟物流) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation. Use when th...

0· 175·0 current·1 all-time
byhaidong@harrylabsj

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for harrylabsj/cainiao.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Cainiao" (harrylabsj/cainiao) from ClawHub.
Skill page: https://clawhub.ai/harrylabsj/cainiao
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install cainiao

ClawHub CLI

Package manager switcher

npx clawhub@latest install cainiao
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
The skill announces shipment tracking, estimates, outlet lookup and local persistence. The included cainiao.py implements tracking-query (mocked), time/price estimates, history, subscriptions and address storage which match the described purpose. No unrelated credentials, services, or system resources are requested.
Instruction Scope
SKILL.md explicitly documents the workflows and the local persistence paths the runtime will use. The runtime code only reads/writes files under ~/.openclaw/data/cainiao, uses a local SQLite DB and the SecureStorage helper; it does not read unrelated system files or environment variables.
Install Mechanism
There is no formal install spec, but requirements.txt lists typical Python packages (aiohttp, cryptography, pillow, etc.). Installing the skill will likely require pip-installing those dependencies; this is expected for networking, encryption and image generation but the lack of an explicit install section means the environment must provide/allow pip installs.
Credentials
The skill requests no environment variables or external credentials. The SecureStorage component stores an on-disk Fernet key under the skill's secure directory — this is proportional to its stated need to persist encrypted local data.
Persistence & Privilege
The skill persists data under ~/.openclaw/data/cainiao (SQLite DB, encrypted files, and a .key file with mode 600). This is expected for history/subscription features and the SKILL.md documents privacy operations (privacy info/clear/export). While file permissions are restrictive, storing the symmetric key on disk means encrypted data is recoverable by anyone with the same user account access.
Assessment
This skill appears to implement what it claims: shipment lookups, estimates, and local history. Things to consider before installing: 1) Local persistence: it will create ~/.openclaw/data/cainiao and store a SQLite DB plus encrypted files and a local Fernet key (~/.openclaw/data/cainiao/secure/.key). The key is created with 0600 permissions, but if an attacker gains access to your user account they can decrypt stored data. 2) Dependencies: requirements.txt includes cryptography and other libraries that must be installed (pip). Ensure you install in a virtualenv or otherwise trust those packages. 3) Network behavior: current code uses mocked tracking responses and creates an aiohttp session but contains no hard-coded external endpoints; still be cautious about future changes that may contact external APIs. 4) Privacy controls: the skill provides privacy commands (privacy info/clear/export) — use them to inspect and remove persisted data. 5) If you need real-time official Cainiao tracking, verify whether the skill integrates with the official Cainiao API (this implementation does not). If any of these points are unacceptable, review or run the code in an isolated environment before granting it normal usage.

Like a lobster shell, security has layers — review code before you run it.

latestvk97efgd664net93a7cwccwpvbs83myhs
175downloads
0stars
2versions
Updated 1mo ago
v1.0.0
MIT-0

Cainiao Network (菜鸟物流)

Overview

Use this skill to help users with common Cainiao tasks such as tracking shipments, understanding service levels, estimating timing or fees, and preparing to send a parcel.

Local Persistence

When the local CLI/runtime code is used, this skill may create and persist local data under:

  • ~/.openclaw/data/cainiao/cainiao.db
    • stores query history
    • stores shipment-subscription records
    • may store saved address records if those commands are implemented/used
  • ~/.openclaw/data/cainiao/secure/
    • stores encrypted local files used by the privacy/storage helper
  • ~/.openclaw/data/cainiao/secure/.key
    • stores a local encryption key file with mode 600
  • ~/.openclaw/data/cainiao/privacy_export.json
    • may be created when the user runs privacy export

Only use persistence when it is necessary for the user's requested workflow. If the user asks about privacy, disclose these paths clearly.

Privacy Controls

The local CLI supports privacy operations:

  • privacy info — show local storage paths and stored-file info
  • privacy clear — clear local SQLite history/subscription data and encrypted local files
  • privacy export — export local storage metadata to privacy_export.json

Workflow

  1. Determine the user's goal:
    • track an existing shipment
    • estimate fee or delivery time
    • compare service types
    • find a nearby outlet or pickup point (Cainiao Station)
    • prepare shipment details
    • review or clear local history/subscriptions/privacy data
  2. Ask for only the missing essentials, such as tracking number, route, package size, or urgency.
  3. Give the most practical answer first.
  4. If exact fee or timing cannot be confirmed, provide a cautious estimate and state assumptions.
  5. If the task uses local runtime features that persist data, mention that local history/subscription/privacy files may be created under ~/.openclaw/data/cainiao/.
  6. Do not claim to complete real shipping actions unless live tools are available and confirmed.

Comments

Loading comments...