← 返回 Skills 市场
180
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install cainiao
功能描述
Use Cainiao Network (菜鸟物流) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation. Use when th...
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install cainiao - 安装完成后，直接呼叫该 Skill 的名称或使用
/cainiao触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
No user-facing changes detected in this version.
v1.0.1
English-first documentation update
元数据
常见问题
Cainiao 是什么？
Use Cainiao Network (菜鸟物流) for shipment tracking, shipping guidance, service-type comparison, outlet lookup, and delivery-time or fee estimation. Use when th... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 180 次。
如何安装 Cainiao？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install cainiao」即可一键安装，无需额外配置。
Cainiao 是免费的吗？
是的，Cainiao 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Cainiao 支持哪些平台？
Cainiao 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Cainiao？
由 haidong（@harrylabsj）开发并维护，当前版本 v1.0.0。
推荐 Skills