openclaw-skill-customs

What This Skill Does

The customs-declaration skill acts as a highly specialized AI-driven assistant for international trade documentation. It automates the complex, error-prone manual process of customs filing by intelligently identifying document types—such as invoices, packing lists, and bills of lading—and extracting structured data for customs submission. The skill handles the entire lifecycle of a document, from initial file upload and intelligent segmentation to status polling and final generation of customs-compliant Excel reports. It functions as a state-managed workflow agent, ensuring that every submission follows rigorous business logic, including mandatory user confirmation steps before final data processing.

Installation

To enable this skill, first ensure your system has the necessary environment variables configured. You can perform this via the OpenClaw platform UI under the skill settings by adding LEAP_API_KEY. Alternatively, use the command line: export LEAP_API_KEY="your_api_key_here". Once configured, verify your setup by running python scripts/check_config.py. To install the skill package, execute the following command in your terminal: clawhub install openclaw/skills/skills/axlemax/openclaw-skill-customs.

Use Cases

This tool is designed for customs brokers, import/export managers, and logistics coordinators. It excels in scenarios where high volumes of trade documents need to be processed quickly and accurately. Use it to eliminate manual data entry, reduce the risk of HS code classification errors, and maintain a verifiable digital audit trail of your customs declarations. It is particularly effective for businesses that frequently handle multiple documents per shipment.

Example Prompts

1. "I have three documents—an invoice, a packing list, and a bill of lading—that I need to process for my upcoming customs filing. Please help me extract the data."
2. "Can you check the current status of my customs declaration task and let me know if it's ready for final download?"
3. "I've uploaded my shipping documents, please categorize them and extract the HS codes and item values for me to review."

Tips & Limitations

To ensure success, always follow the 'Three Iron Rules': never skip the asynchronous polling phase while tasks are in progress, wait for user validation after classification before proceeding to final submission, and ensure all required files for a specific shipment are uploaded as a batch. Keep in mind that accuracy is dependent on the clarity of your source documents. Poorly scanned or blurry documents may result in lower classification confidence. Always review the extracted segments in the console output before providing your 'OK' for the final submission to the customs system.