An automated cross-border e-commerce utility designed to map, process, and list 1688 products as Amazon drafts in Dianxiaobao.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install 1688-distribution-amazon
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install 1688-distribution-amazon using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is 1688 to Amazon E-Commerce Distribution Assistant?
The 1688 to Amazon Distribution tool is a sophisticated automation skill designed to bridge the gap between Chinese wholesale sourcing on 1688 and global distribution on Amazon. Operating as part of the official Openclaw Skills ecosystem, this script enables merchants to fetch raw product data directly from 1688, map categories automatically to Amazon's platform schema, apply advanced image processing (white-background conversion, resizing, and English translation), and compile the structured payload.
Rather than executing risky live publishes, the skill securely saves the generated listings as Amazon-ready drafts in Dianxiaobao (DXB). This allows operators to review, fine-tune, and safely publish inventory at scale from their Dianxiaobao dashboard. By automating the tedious pipeline of product extraction, image editing, and schema matching, this tool empowers e-commerce operators to expand their product portfolios efficiently.
1688 to Amazon E-Commerce Distribution Assistant Use Cases
Below are the primary scenarios where you should deploy this automation skill:
- Sourcing Chinese wholesale products from 1688 to list on Amazon US (Marketplace: ATVPDKIKX0DER) or other marketplaces.
- Bulk mapping 1688 supplier categories directly to complex Amazon product category schemas without manual lookup.
- Performing automated image preparation for Amazon, including generating white backgrounds, cropping to e-commerce standards, and translating Chinese infographic text to English.
- Preparing product draft payloads for Dianxiaobao to allow centralized review before going live.
- Running automated e-commerce distribution agents using reliable Openclaw Skills that handle errors gracefully step-by-step.
How 1688 to Amazon E-Commerce Distribution Assistant Works
The automated pipeline executes the following sequenced steps to safely convert 1688 product data into Amazon draft listings:
- Environment Verification: Executes
check_env.pyto ensure crucial variables (DXB_USER_ID,ALPHASHOP_ACCESS_KEY, etc.) are configured. - Store Query & Selection: Pulls the authorized Dianxiaobao Amazon store list and lets the user confirm the target store name.
- Session Initialization: Creates a secure, isolated session folder with masked internal credentials to store pipeline intermediate files.
- 1688 Offer Retrieval: Queries raw supplier details and structures them into a standard
query_offer.jsonschema. - Category Mapping: Translates 1688 category taxonomies into matching Amazon categories and product types.
- E-Commerce Image Pipeline: Automatically converts raw supplier images into e-commerce-compliant formats (white backgrounds, 4:3 aspect ratios, and English translations).
- Schema & CPV Processing: Resolves required Amazon metadata schema requirements and performs complex CPV attribute mapping.
- Payload Assembly: Builds the complete Amazon-compliant JSON product model and injects default stock or custom inventory settings.
- Dianxiaobao Draft Export: Delivers the compiled payload to Dianxiaobao using the
releaseProductToOutAPI (settingrelease-typetolocalSave), generating a unique local tracking ID (localId).
1688 to Amazon E-Commerce Distribution Assistant Setup
1. Environment Variables Configuration
Configure the following essential credentials in your shell or local .env file prior to execution. Do not expose these raw secrets in chat interfaces.
DXB_USER_ID: Your unique Dianxiaobao user ID used for store mapping.ALPHASHOP_ACCESS_KEY: Alphashop gateway access key used for 1688 data mapping APIs.ALPHASHOP_SECRET_KEY: Alphashop gateway secret key for secure JWT authorization.ALI_1688_AK: Gateway API key dedicated to advanced image pipelines (translation, white background).
2. Execution
Ensure you are using the designated python runner interface to coordinate the execution. Running Openclaw Skills commands must adhere to the integrated Python runtime directory wrapper:
# Verify your environment variables
bash scripts/run_python.sh scripts/check_env.py
# Recommended: Single-Command Automation
bash scripts/run_python.sh scripts/run_local_save.py <offerId> --store-name "<storeName>" --marketplace-id ATVPDKIKX0DER
To specify custom inventory quantities, append the --inventory-quantity flag:
bash scripts/run_python.sh scripts/run_local_save.py <offerId> --store-name "<storeName>" --marketplace-id ATVPDKIKX0DER --inventory-quantity 15
1688 to Amazon E-Commerce Distribution Assistant Data Schema & Taxonomy
The automation processes files and maintains pipeline state locally inside an isolated session directory (<session_dir>). Below is a taxonomy of files generated during execution:
| File Path | Description |
|---|---|
query_offer.json |
Captured raw product metadata retrieved from the 1688 marketplace API. |
map_category.json |
Resolved taxonomic mapping schema correlating 1688 source categories to Amazon's platform classifications. |
image_processing.json |
Tracks image processing statuses, including white-background edits, cropped coordinates, and translation flags. |
map_amazon_attrs.json |
Evaluated Amazon category schema outlining conditional mandatory fields. |
map_pv_attrs.json |
Cross-referenced CPV attributes mapped specifically for the target Amazon marketplace. |
build_product.json |
Final assembled Amazon payload optimized for Dianxiaobao's import architecture. |
release_product.json |
Official response structure from the Dianxiaobao draft export, containing the localId validation. |
1688 to Amazon E-Commerce Distribution Assistant Advanced Features
- One-Click Automated Entrypoint: Employs
run_local_save.pyto seamlessly orchestrate step-by-step pipeline execution from environment validation down to draft export. - Dynamic Image Pipelines: Conditionally applies post-processing pipelines such as translation to English, 4:3 e-commerce aspect ratio cropping, and background removal based on target Amazon
productTypeattributes. - Rigid Failure Handling: Enforces explicit step boundaries where any API anomalies immediately halt execution, preventing corrupt schema payload saves.
- Token Security Masking: Securely processes credentials internally. The script replaces sensitive internal reference keys with a safe representation (
<DXB_ENCRYPTED_CODE>) across conversational outputs and log interfaces. - Direct Publish Fallback Protection: Intercepts requests for live publishing and safely routes them to local draft creation (
localSave), providing users with a verified Dianxiaobao redirection URL to execute risk-managed manual rollouts.
SKILL.md
Loading
Related Openclaw Skills
Worldwide Research Synthesizer
A powerful academic literature synthesizer that aggregates, analyzes, and translates worldwide scholarly publications into PRISMA-compliant reviews.
Cross-Border Business Navigator
A comprehensive global business intelligence skill designed to guide international market entry, cross-border operations, and regulatory compliance across more than 190 countries.
Global Legal Compass
A comprehensive multi-jurisdiction legal intelligence agent covering 9 major jurisdictions and 10 domains with direct database integration.
1688 Distribution Shop Bind Newton
An AI-guided workflow skill for the Newton Electron client designed to seamlessly authorize and bind 1688 distribution buyer shops.
Understanding Women's Words Skill
A respectful relationship communication helper that interprets emotional subtext and drafts constructive, non-defensive replies.
Daily News Aggregator and Verification Skill
An automated daily news aggregator that leverages Openclaw Skills to collect, cross-verify, and report global events across eight domains.
Featured*
