What makes 1688 Distribution notable?

1.1K downloads. Trust evidence available

How should 1688 Distribution be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

1688 Distribution

1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Skill: 1688 Distribution Owner: 1688aiinfra Summary: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。 Tags: latest:0.1.0 Version history: v0.1.0 | 2026-05-06T02:41:54.490Z | auto Initial release of the 1688-distribution skill — unified entry for all 1688 distribution business workflows. - Provides a single command-line interface for product selection/

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 0.1.0release · observed May 6, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s177df9srv6z2y0gd1kw90rern83hzxb:1688-distribution

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-distribution/snapshot"

Documentation

CLAWHUB

37,979 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: 1688-distribution
description: 1688 分销唯一主入口。选品铺货、订单管理、知识库查询、店铺绑定，涵盖分销全链路。当用户提到铺货、选品、分销、上架、查订单、催发、旺旺、发货流程、绑店时触发。不要在用户仅询问非1688业务（如闲聊、天气、翻译等无关话题）时触发。
metadata: {"openclaw": {"emoji": "🚀", "version": "1.0.0", "requires": {"bins": ["python3"]}}}
---

# 1688 分销

统一入口：`python3 scripts/cli.py <command> [options]`

所有命令输出 JSON：`{"success": bool, "markdown": str, "data": {...}}`

**展示时直接输出 `markdown` 字段内容，禁止在后面追加任何"后续建议""操作指引""后续操作"等自创内容（无论是否含链接）。**

## ⚠️ 核心限制

**失败时直接告知用户，不编造！**

```
❌ 禁止：编造商品数据、伪造链接、臆测店铺信息、用搜索引擎补充数据、改写CLI返回结果...
✅ 仅允许：原样输出CLI工具返回的markdown，禁止擅自增加额外内容；失败时告知用户原因
```

**严格禁止（NEVER DO）：**

1. 🚫 禁止编造数据/链接 — 所有数据必须来自接口返回，不得自行构造 URL
2. 🚫 禁止未经确认执行铺货 — 铺货不可逆，必须用户明确确认商品和目标店铺
3. 🚫 禁止品牌未授权商品铺货 — `isBrandOffer=true` 且 `isBrandAuth=false` 绝对不能铺货
4. 🚫 禁止擅自添加筛选条件 / 改写用户原话 / 猜测渠道和店铺
5. 🚫 禁止向用户展示授权链接 — 浏览器授权流程中不得将 URL 展示给用户
6. 🚫 禁止使用搜索引擎、访问外部网站获取业务数据
7. 🚫 禁止失败后自行重试、补充、编造 — 直接告知用户失败原因，等待指示
8. 🚫 **禁止在任何操作完成后追加"后续建议""后续操作""操作指引"等内容** — 无论是否含链接，一律不加
9. 🚫 **禁止在未阅读 reference.md 前执行任何业务命令** — 必须**先 read_file 加载对应 reference.md → 再执行命令**。命令的动作名、参数名、参数格式必须从 reference.md 中获取，不得凭记忆或猜测拼凑

---

## AK 授权处理

AK（Access Key）用于身份认证，存储在 `{workspace}/.1688-AK/.ak_store.json`。

**授权检查**：任何业务操作前执行 `python3 scripts/capabilities/configure/cmd.py --status`，已授权则直接执行，同一会话内无需重复检查。

**未授权时自动处理（静默执行，不询问用户）：**

```
1. 执行：python3 scripts/capabilities/configure/cmd.py --get-ak
2. 命令输出 JSON（含 action: "browser_use" 和 url）
3. 必须使用 browser_use 工具打开该 url（不是展示给用户）
4. 执行 --status 确认 AK 已配置
5. 继续执行原查询
```

**禁止**：将授权链接展示给用户 / 让用户手动打开 / 向用户提及 AK、授权等细节。

**手动配置 AK**（浏览器获取失败时的兜底）：
1. 用户前往 https://clawhub.1688.com/ 登录后右上角点击🔑复制 AK
2. 执行：`python3 scripts/capabilities/configure/cmd.py <AK值>`
3. `--status` 确认

**重置 AK**：`python3 scripts/capabilities/configure/cmd.py --reset <新AK值>`，或 `--clear` 后重新授权。

---

## 意图判断

| 用户意图 | 路由到 | 触发关键词 |
|---------|--------|------------|
| 选品 + 铺货 | [选品铺货助手](#选品铺货助手) | 选品、找商品、推荐、铺货、上架、分销 |
| 订单管理 | [订单助手](#订单助手) | 查订单、退款、风险订单、催发、催揽、旺旺 |
| 知识查询 | [知识库助手](#知识库助手) | 怎么操作、教程、流程、指南、发货流程 |
| 查店铺 | [店铺查询](#店铺查询) | 查店铺、绑店、授权 |
| 重置 AK | [AK 授权处理](#ak-授权处理) | 重新设置 AK、重置 AK、更新 AK |

> 判断不清时优先询问用户意图，不要猜测。与1688分销无关的话题不触发本技能。

---

## ❗ 执行前置（最高优先级）

> ⛔ **铁律：先读文档 → 再执行命令。read_file 加载对应 reference.md 之前，禁止执行该场景的任何 CLI 命令。**

| 业务场景 | 执行前必须阅读的参考文档 |
|---------|---------------------|
| 选品（关键词/图搜） | `scripts/biz/product_search_helper/reference.md` |
| 分销参谋（商品详情） | `scripts/biz/offer_info/reference.md` |
| 铺货执行 | `scripts/biz/distribute_helper/reference.md` |
| 店铺查询 | `scripts/biz/shop_info/reference.md` |
| 订单管理 | `scripts/biz/order_helper/reference.md` |
| 知识库查询 | `scripts/biz/knowledge_helper/reference.md` |

同一会话内后续重复调用可复用已加载知识，无需重复阅读。

---

## 选品铺货助手

流程：**检查AK → 选品 → 决策分析 → 确认店铺 → 铺货 → 结果反馈 → 后续触发**

> 每步执行前须确保已阅读对应 reference.md（见[执行前置](#-执行前置最高优先级)）。

### 第一步：选品（用户已有商品 ID 时跳过）

根据用户输入自动选择模式：
- **文字描述** → 关键词选品（`distribution_select_offer`）
- **图片链接/文件** → 图搜选品（`same_img_offer_search`）

**选品数量策略** — 超量请求再精选，防止接口去重/过滤导致不足：

| 用户要求 N | 实际请求 page_size | 说明 |
|-------

README.md

免责声明：
1、您理解并同意，技能运行结果和输出内容可能因适用的AI agent、大模型不同而产生差异或幻觉，请您对重要的信息进行甄别核实。
2、您应妥善保管您的Access Key（AK），这是您运行1688技能的身份凭证，请勿提供给第三人，避免身份凭证泄露造成损失。
3、您下载安装1688技能运行时应始终保持其完整性，不得擅自篡改技能的代码、相关文件或其他内容，否则1688不对技能运行结果和输出内容承担任何法律责任。
4、受限于当前技术发展，我们无法保证技能所有运行结果、输出内容的准确性、真实性、时效性，请您谨慎核实技能运行结果和输出内容，除法律规定由我们承担赔偿责任的场景外，我们不承担其他赔偿责任。

_meta.json

{
  "ownerId": "kn76msg8cwkep3b08z7zffx9fx82p5wj",
  "slug": "1688-distribution",
  "version": "0.1.0",
  "publishedAt": 1778035314490
}

scripts/biz/distribute_helper/reference.md

# 铺货执行参考文档

将 1688 商品铺货到用户的下游店铺（抖音、拼多多、淘宝等）。

---

## 一、CLI 调用

```bash
python3 scripts/cli.py distribute_helper execute \
  --app_key="{appKey}" \
  --shop_code="{shopCode}" \
  --channel="douyin" \
  --offer_ids="983715805496,983715805497" \
  --shop_name="大小姐精品铺子" \
  --tool_name="逸淘分销铺货"
```

### 接口工具名

`distribute_offer`

### 参数说明

| 参数 | 必填 | 说明 |
|------|------|------|
| `app_key` | 是 | 三方服务商唯一标识，从 shop_info 查询结果的 `toolList[].appKey` 获取 |
| `shop_code` | 是 | 目标店铺编码，从 shop_info 查询结果的 `shopList[].shopCode` 获取 |
| `channel` | 是 | 渠道标识（如 `douyin`、`pinduoduo`、`taobao`），从 shop_info 查询结果获取 |
| `offer_ids` | 是 | 商品 ID，多个用英文逗号分隔，如 `"983715805496,983715805497"` |
| `shop_name` | 否 | 店铺名称（用于展示），从 shop_info 查询结果的 `shopList[].shopName` 获取 |
| `tool_name` | 否 | 铺货工具名称（用于展示），从 shop_info 查询结果的 `toolList[].appName` 获取 |

> 接口实际传参：`outShopListStr` 为 `[{"code":"{shopCode}","channel":"{channel}"}]` 的 JSON 序列化字符串，CLI 内部自动拼装。

### 返回结构

```json
{
  "success": true,
  "data": {
    "errorCode": "200",
    "failCount": 0,
    "successCount": 1,
    "allCount": 1,
    "appKey": "{appKey}",
    "brandInvalidOfferIds": [],
    "successOfferIds": ["983715805496"],
    "failOfferIds": []
  }
}
```

---

## 二、结果反馈

根据返回的 `errorCode` 字段给出对应提示：

| errorCode | 含义 | 向用户展示的提示 |
|-----------|------|----------------|
| `200` / `0` | 全部成功 | ✅ 铺货完成！成功 {successCount} 件，共 {allCount} 件 |
| `210` | 部分成功 | ⚠️ 铺货部分成功。成功 {successCount} 件，失败 {failCount} 件，共 {allCount} 件 |
| `511` | 店铺授权失效 | ❌ 铺货失败：下游店铺授权信息已失效，请重新授权后再试 |
| `512` | 未完成铺货设置 | ❌ 铺货失败：您未完成铺货设置，请先完成设置后再铺货 |
| 其他 | 三方工具服务错误 | ❌ 铺货失败：三方工具服务请求错误，请稍后重试或联系技术支持 |

### 反馈模板

铺货命令返回的 JSON 中 `markdown` 字段已是完整的用户回复。**直接将 `markdown` 原样转发给用户，不得修改或追加任何内容。**

`markdown` 输出示例：
```
✅ 铺货完成！成功 1 件，共 1 件
店铺：大小姐精品铺子 | 铺货工具：逸淘分销铺货
- 成功商品 ID：700407352258

---

> ℹ️ 铺货结果到此结束。如有未铺货商品，请询问用户是否继续。
```

Agent 收到后只做两件事：
1. 原样转发 `markdown` 给用户
2. 如有未铺货商品，询问用户是否继续

**不得追加任何链接或额外文字，禁止增加‘后续操作建议’**。

> `errorCode` 为 `200`、`0` 或 `210` 时视为整体成功（`success: true`），其他均为失败。

---

## 三、注意事项

- 铺货前必须先通过 shop_info 确认目标店铺，获取 `appKey`、`shopCode`、`channel`
- 品牌商品（`brandInvalidOfferIds` 非空）铺货会失败，且有侵权风险。铺货前必须检查品牌授权状态（在选品决策分析阶段已检查），未授权商品引导用户申请授权：`https://air.1688.com/app/channel-fe/distribution-work/brand.html#/auth_apply?offerId={offerId}`
- 单次铺货支持多个商品 ID，用逗号分隔
- **不得编造链接**：铺货结果反馈中只展示接口实际返回的数据，不得自行构造任何 URL（如"查看铺货进度"、"采购设置"、"自动售后"等链接均为虚构，会导致 404）

scripts/biz/knowledge_helper/reference.md

# 知识库助手参考文档

查询 1688 分销知识库，获取发货流程、铺货操作、订单管理等分销相关文档。支持按渠道（21 个）和工具（24 个）筛选。

**完整流程：解析意图 → 确认渠道/工具 → 检索知识库 → 判断召回 → 总结输出**

---

## 一、CLI 调用

```bash
# 默认查询（不限渠道和工具）
python3 scripts/cli.py knowledge_helper query --query="铺货流程"

# 指定渠道和工具
python3 scripts/cli.py knowledge_helper query --query="发货" --channel="抖音" --business="自动分销"

# 列出所有支持的渠道
python3 scripts/cli.py knowledge_helper channels

# 列出所有支持的工具
python3 scripts/cli.py knowledge_helper businesses
```

### 接口工具名

`distribution_knowledge_tool`

### 请求参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `query` | string | 是 | 用户查询问题，**原封不动传递用户原话，严禁修改** |
| `channel` | string | 否 | 渠道中文名（如 "抖音"），未指定时传 `"default"` |
| `business` | string | 否 | 工具中文名（如 "逸淘分销铺货"），未指定时传 `"default"` |

### 返回结构

`data` 为精排后的文档数组（最多 20 条），每条包含：

| 字段 | 说明 |
|------|------|
| `score` | 相关度分数（0-1，越高越相关） |
| `chunking_val` | 文档正文内容 |
| `source_url` | 原始文档链接 |

```json
{
  "success": true,
  "data": {
    "data": [
      {
        "score": 0.99,
        "chunking_val": "工具名称：逸淘分销铺货;内容：...",
        "source_url": "https://peixun.1688.com/article/xxx"
      }
    ]
  }
}
```

---

## 二、query 原则（必须严格遵守）

- **不要去掉任何词语**
- **不要改写、精简或翻译用户问题**
- 原封不动地将用户原话作为 query 参数传递
- **唯一例外**：召回结果与用户问题完全无关时，才允许对 query 做极小调整（仅补充 1-2 个关键词），重试仅允许 1 次

---

## 三、渠道与工具确认（强制询问）

**如果用户没有明确说明渠道和工具，必须先询问用户，不能跳过！**

- 用户明确提到了渠道和工具 → 直接使用中文名称传参
- 用户未明确渠道或工具（即使只缺一个） → **必须停下来追问**，使用以下话术：

```
为了给您提供更精准的知识，请告诉我您想查询的渠道和工具：

📱 **渠道**（您的店铺所在平台）：
淘宝、天猫、抖音、拼多多、快手、小红书、京东、微信小店、有赞、微店、淘特、快团团、微信小商店、支付宝、苏宁、闲鱼、饿了么、美团、度小店、微盟、微购相册
或选择"不限"使用通用知识库

🔧 **工具**（您使用的分销工具）：
逸淘分销铺货、自动分销、代发助手王、店长铺货、妙手分销、速当家分销、智淘分销、甩手易分销、无忧分销王、晓风分销、大泽云铺货、顶卖分销、铺货代发、1688官方铺货、普云铺货、麦爆了分销、马上分销、掌中宝分销、智汇分销、微购相册、抖掌柜分销、旺分销铺货、小天分销、火牛分销王
或选择"不限"使用通用知识库

请直接回复渠道和工具名称，例如："淘宝 + 逸淘分销铺货"
```

**然后停止，等待用户回复，不要继续执行任何操作！**

用户回复"不限"或"默认"时，对应参数传 `"default"`。

---

## 四、召回结果判断

拿到 `data` 数组后，在总结之前先做相关性判断：

**直接进入总结（满足任一条件）：**
- 最高 `score` ≥ 0.3
- `chunking_val` 内容与用户问题有明显关联（哪怕 score 较低）
- 有任意文档内容提到了用户问题中的核心关键词

**允许调整 query 重试 1 次（需同时满足）：**
- 所有文档的 `score` 都低于 0.15
- 且 `chunking_val` 内容与用户问题完全无关

**重试规则：**
- 仅允许重试 **1 次**，不得多次重试
- query 调整方式：仅提取用户问题中最核心的 1-2 个关键词，不得大幅改写
- 重试后无论结果如何，直接进入总结

---

## 五、结果展示格式

基于检索到的文档，按以下格式输出：

### 查询总结（详细版）

```
## 查询总结

根据知识库，关于「[用户问题]」的完整操作指南如下：

### 操作步骤

**第 1 步：[步骤名称]**
[详细说明这一步要做什么，在哪里操作]
[如果文档中有图片，必须展示：![操作示意图](图片URL)]

**第 2 步：[步骤名称]**
[详细说明]
[相关图片]

...

### 注意事项
- [从文档中提取的重要提示]
- [常见问题或特殊情况说明]
```

### 详细参考

列出相关度较高的文档（score > 0.3），每篇包含：
- 关键内容（不要过度精简，保留操作细节）
- 文档中的所有图片（使用 markdown 图片语法展示）
- 来源链接（`source_url`）
- 相关度评分（`score`）

### 总结要求

1. **精准解决问题**：直接回答用户的问题，不能泛泛而谈
2. **保留图片信息**：文档中的图片链接必须完整保留，使用 `![图片说明](图片URL)` 格式展示
3. **步骤详细列举**：操作步骤逐步编号，每步清晰说明
4. **内容不能过于简短**：至少包含完整的操作流程，不能省略关键细节

---

## 六、渠道与工具列表

### 21 个渠道

淘宝、天猫、抖音、拼多多、快团团、小红书、快手、微信小店、京东、有赞、微店、淘特、微信小商店、支付宝、苏宁、闲鱼、饿了么、美团、度小店、微盟、微购相册

### 24 个工具

逸淘分销铺货、自动分销、代发助手王、店长铺货、妙手分销、速当家分销、智淘分销、甩手易分销、无忧分销王、晓风分销、大泽云铺货、顶卖分销、铺货代发、1688官方铺货、普云铺货、麦爆了分销、马上分销、掌中宝分销、智汇分销、微购相册、抖掌柜分销、旺分销铺货、小天分销、火牛分销王

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.