← Back to Skills Marketplace
180
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install cainiao
Description
Use Cainiao Network (菜鸟物流) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation. Use when th...
README (SKILL.md)
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
- stores a local encryption key file with mode
~/.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 infoprivacy clear— clear local SQLite history/subscription data and encrypted local filesprivacy export— export local storage metadata toprivacy_export.json
Workflow
- 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
- Ask for only the missing essentials, such as tracking number, route, package size, or urgency.
- Give the most practical answer first.
- If exact fee or timing cannot be confirmed, provide a cautious estimate and state assumptions.
- If the task uses local runtime features that persist data, mention that local history/subscription/privacy files may be created under
~/.openclaw/data/cainiao/. - Do not claim to complete real shipping actions unless live tools are available and confirmed.
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: cainiao
Version: 1.0.0
The 'cainiao' skill is a logistics tracking utility that manages shipment history and subscriptions locally. It implements a robust local storage system using SQLite and an encrypted file helper (security.py) using the Fernet symmetric encryption. The skill includes explicit privacy management commands (info, clear, export) and follows the stated purpose of tracking shipments without any signs of data exfiltration, unauthorized execution, or malicious prompt injection.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cainiao - After installation, invoke the skill by name or use
/cainiao - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
No user-facing changes detected in this version.
v1.0.1
English-first documentation update
Metadata
Frequently Asked Questions
What is Cainiao?
Use Cainiao Network (菜鸟物流) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation. Use when th... It is an AI Agent Skill for Claude Code / OpenClaw, with 180 downloads so far.
How do I install Cainiao?
Run "/install cainiao" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Cainiao free?
Yes, Cainiao is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Cainiao support?
Cainiao is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Cainiao?
It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.
More Skills