1688 Sourcing Inquiry
1688采购询盘寻源能力。当用户有模糊的采购需求但尚未选定具体商品时,通过描述商品名称、数量和需求,发起采购询盘任务,由平台匹配合适的供应商和报价方案。 核心定位:采购前的询盘寻源阶段,帮助用户将模糊的采购意向转化为结构化询盘,获取供应商报价。 触发词:询盘、询价、寻源、采购咨询、发布采购需求、我有一批XX要采购... Skill: 1688 Sourcing Inquiry Owner: 1688aiinfra Summary: 1688采购询盘寻源能力。当用户有模糊的采购需求但尚未选定具体商品时,通过描述商品名称、数量和需求,发起采购询盘任务,由平台匹配合适的供应商和报价方案。 核心定位:采购前的询盘寻源阶段,帮助用户将模糊的采购意向转化为结构化询盘,获取供应商报价。 触发词:询盘、询价、寻源、采购咨询、发布采购需求、我有一批XX要采购... Tags: latest:0.1.0 Version history: v0.1.0 | 2026-05-06T02:28:48.077Z | auto Initial release of 1688-sourcing-inquiry skill: - Enables users to submit sourcing inquiries based on product name, quantity,
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 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.3K downloads reported by the source. Last updated 10/10/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 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.1.0release · observed May 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s177df9srv6z2y0gd1kw90rern83hzxb:1688-sourcing-inquiry- 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-sourcing-inquiry/snapshot"
Documentation
CLAWHUB
15,699 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: 1688-sourcing-inquiry
description: |
1688采购询盘寻源能力。当用户有模糊的采购需求但尚未选定具体商品时,通过描述商品名称、数量和需求,发起采购询盘任务,由平台匹配合适的供应商和报价方案。
核心定位:采购前的询盘寻源阶段,帮助用户将模糊的采购意向转化为结构化询盘,获取供应商报价。
触发词:询盘、询价、寻源、采购咨询、发布采购需求、我有一批XX要采购谁能供货、求报价。
不触发场景:搜索浏览商品/选品/找同款/比价 → 1688-product-find;已选定具体商品要下单/支付/查订单 → 1688-order;找供应商/找工厂 → 1688-source-suppliers。
metadata: {"openclaw": {"emoji": "🛒", "requires": {"bins": ["python3"]}, "primaryEnv": "ACCESS_KEY"}}
---
# 1688 采购询盘寻源
统一入口:`python3 {baseDir}/cli.py <command> [options]`
## 命令速查
| 命令 | 说明 | 示例 |
|------|------|------|
| `procurement` | 发起采购询盘 | `cli.py procurement --offerName "衣服" --count "10" --demand "价格便宜"` |
| `configure` | 配置 AK | `cli.py configure YOUR_AK` |
所有命令输出 JSON:`{"success": bool, "markdown": str, "data": {...}}`
**展示时直接输出 `markdown` 字段,Agent 分析追加在后面,不得混入其中。**
## 严格禁止 (NEVER DO)
- 不要编造商品价格、链接、规格或供货信息,所有内容必须来自工具返回
- 不要在用户已选定具体商品(有明确 offerId/商品链接)要下单时触发本技能,这些属于 1688-order
- 不要在用户仅表达"找商品"、"搜一下"、"看看有什么"等浏览意图时触发本技能,这些属于 1688-product-find
- 不要在用户查找供应商/工厂时触发本技能,这些属于 1688-source-suppliers
- **禁止在 AK 未配置或命令执行失败时,自行通过浏览器或搜索引擎获取商品信息**
## 意图判断
### 技能定位与边界
**本技能的核心场景**:用户有采购需求但**尚未选定具体商品或供应商**,需要发布询盘让平台帮忙匹配。
**四个技能的协作关系**:
```
采购旅程:模糊需求 → 搜索选品 → 找供应商 → 询盘寻源 → 下单交易
↓ ↓ ↓ ↓ ↓
不触发 product-find source-suppliers 本技能 1688-order
```
| 判断维度 | 本技能(询盘寻源) | 智能选品(product-find) | 交易下单(1688-order) |
|---------|------------------|------------------------|---------------------|
| **用户阶段** | 有采购意向,未选定商品 | 搜索浏览,货比三家 | 已选定商品,要下单付款 |
| **商品确定性** | 模糊描述("衣服"、"螺丝") | 可模糊可具体 | 已有具体商品ID/链接 |
| **核心动作** | 发布询盘、求报价 | 搜索、浏览、比较 | 下单、支付、查订单 |
| **典型表述** | "我有一批衣服要采购,谁能供货" | "帮我搜一下黑色卫衣" | "帮我下单这个商品" |
### 触发本技能(满足以下任一条件)
1. **询盘/询价意图**:用户明确表达"询盘"、"询价"、"求报价"、"发布采购需求"等寻源类表述
2. **模糊采购需求 + 无具体商品**:用户描述了采购需求(商品名称 + 数量 + 要求),但**没有提供具体商品ID、商品链接或已选定的商品**,希望平台帮忙匹配
3. **寻源咨询**:用户表达"谁能供货"、"有没有厂家能做"、"哪里能采购到"等寻源意图
**触发示例**:
- "我有一批衣服要采购,大概10件,要求价格便宜,帮我询个价" ✅(询盘寻源)
- "我需要采购500个304不锈钢螺丝,谁能供货?" ✅(模糊需求 + 寻源)
- "帮我发布一个采购需求:200件纯棉T恤,要便宜的" ✅(发布采购需求)
- "我想采购一批办公用品,帮我问问有没有合适的供应商报价" ✅(询盘咨询)
- "求报价:1000个纸杯,要食品级材质" ✅(求报价)
### 不触发本技能(转交其他技能)
| 用户表述 | 转交技能 | 原因 |
|---------|---------|------|
| "帮我搜一下黑色卫衣" | **1688-product-find** | 搜索浏览商品,非询盘 |
| "帮我找同款" / "以图搜图" / "比价" | **1688-product-find** | 选品比价,非询盘 |
| "帮我下单这个商品(offerId: xxx)" | **1688-order** | 已有具体商品,直接下单 |
| "帮我下单,商品链接是 xxx" | **1688-order** | 已选定商品,交易下单 |
| "我要买100箱打印纸"(已有具体商品) | **1688-order** | 已选定商品要下单 |
| "帮我支付订单" / "查询订单状态" | **1688-order** | 订单交易流程 |
| "帮我找做保温杯的供应商" | **1688-source-suppliers** | 找供应商信息 |
| "我要下单付款" / "查物流" | 不处理 | 非本技能范围 |
### 边界场景处理
- **"帮我采购10件衣服,要求价格便宜"**(无具体商品ID)→ ✅ 触发本技能(模糊需求,发起询盘)
- **"帮我采购10件衣服,商品ID是 xxx"**(有具体商品)→ **交给 1688-order**(已选定商品,直接下单)
- **"帮我采购10件衣服,链接是 xxx"**(有商品链接)→ **交给 1688-order**(已选定商品,直接下单)
- **"我想买打印纸"**(无数量、无具体商品、意图模糊)→ **交给 1688-product-find**(更接近浏览搜索)
- **"找货"** → **交给 1688-product-find**(搜索商品)
- **"帮我找做衣服的工厂"** → **交给 1688-source-suppliers**(找供应商)
### 核心区分口诀
> **有具体商品要下单 → 1688-_meta.json
{
"ownerId": "kn76msg8cwkep3b08z7zffx9fx82p5wj",
"slug": "1688-sourcing-inquiry",
"version": "0.1.0",
"publishedAt": 1778034528077
}references/capabilities/configure.md
# AK 配置指南
## 获取 AK(引导用户)
当用户没有 AK 时,Agent 输出以下引导:
> 请提供您的 AK(Access Key),用于钉钉消息发送的鉴权。
## Agent 配置流程(核心)
用户告知 AK 后,Agent 按以下步骤执行:
```
1. 从用户消息中提取 AK 字符串
2. 执行 cli.py configure <AK>
3. 检查输出:success=true → 继续;success=false → 原样输出 markdown 错误信息
4. 配置成功后由 OpenClaw 配置注入生效(不依赖本地会话缓存);如当前会话仍未生效,提示用户新开会话或执行 `openclaw secrets reload`
5. 继续用户的原始请求(如发送钉钉消息);若用户仅提供了 AK 没有其他请求,告知"配置成功,您可以发送钉钉消息了"
```
## CLI 调用
```bash
python3 {baseDir}/cli.py configure YOUR_AK_HERE
```
无参数调用可查看当前配置状态:`python3 {baseDir}/cli.py configure`
## 异常处理
| 场景 | Agent 应对 |
|------|-----------|
| configure 输出 success=false | 原样输出 markdown 错误信息 |
| 配置成功但后续命令仍报 AK 未配置 | 提示用户新开会话或执行 `openclaw secrets reload`,必要时再重试 configure |
| 用户问"我的 AK 在哪" | 输出上方获取 AK 引导话术 |
通用 HTTP 异常(400/401/429/500)处理见 `references/common/error-handling.md`。references/capabilities/procurement.md
# 采购数字人使用指南
## 功能说明
采购数字人 Skill,支持用户通过自然语言描述采购需求,自动解析为结构化数据并发起采购任务。
## 前置条件
- 已配置 AK(未配置时会提示运行 `cli.py configure YOUR_AK`)
## Agent 处理流程(核心)
```
1. 用户输入自然语言采购需求(如"帮我采购10件衣服,要求价格便宜")
2. Agent 从用户消息中提取以下字段:
- offerName: 商品名称(如"衣服")
- count: 采购数量(如"10")
- demand: 采购需求描述(如"价格便宜")
3. 如果有字段缺失,Agent 需要主动询问用户补充:
- 缺 offerName → "请问您要采购什么商品?"
- 缺 count → "请问您要采购多少件?"
- 缺 demand → "请问您对商品有什么要求?(如价格、质量、发货速度等)"
4. 所有字段齐全后,执行 CLI 命令
5. 检查输出:success=true → 告知用户采购任务已创建;success=false → 原样输出错误信息
```
### 自然语言解析示例
| 用户输入 | offerName | count | demand |
|---------|-----------|-------|--------|
| 采购10件衣服要求价格便宜 | 衣服 | 10 | 价格便宜 |
| 帮我买500个螺丝,要304不锈钢的 | 螺丝 | 500 | 304不锈钢 |
| 我需要采购一批手机壳 | 手机壳 | (需询问) | (需询问) |
| 200件T恤,纯棉的,要便宜 | T恤 | 200 | 纯棉,价格便宜 |
## CLI 调用
```bash
python3 {baseDir}/cli.py procurement --offerName "衣服" --count "10" --demand "价格便宜"
```
### 参数说明
| 参数 | 缩写 | 是否必填 | 说明 |
|------|------|----------|------|
| `--offerName` | `-n` | ✅ 是 | 商品名称 |
| `--count` | `-c` | ✅ 是 | 采购数量(纯数字,不含单位) |
| `--demand` | `-d` | ✅ 是 | 采购需求描述 |
### 调用示例
```bash
python3 {baseDir}/cli.py procurement -n "衣服" -c "10" -d "价格便宜"
python3 {baseDir}/cli.py procurement --offerName "螺丝" --count "500" --demand "304不锈钢,要求包邮"
```
## 输出格式
### 成功
```json
{
"success": true,
"markdown": "✅ 采购任务已创建\n\n- **商品名称**: 衣服\n- **采购数量**: 10\n- **采购需求**: 价格便宜",
"data": {
"data": { ... }
}
}
```
### 失败 — AK 未配置
```json
{
"success": false,
"markdown": "❌ AK 未配置,无法创建采购任务。\n\n运行: `cli.py configure YOUR_AK`",
"data": { "data": {} }
}
```
### 失败 — 参数缺失
```json
{
"success": false,
"markdown": "❌ 参数错误:商品名称(offerName)不能为空",
"data": { "data": {} }
}
```
## 异常处理
| 场景 | Agent 应对 |
|------|-----------|
| AK 未配置 | 引导用户执行 `cli.py configure YOUR_AK` 配置 AK |
| 参数缺失(offerName/count/demand) | 主动询问用户补充缺少的信息 |
| 用户输入模糊无法解析 | 逐一询问商品名称、数量、需求 |
| 接口返回格式异常 | 提示"格式异常,请稍后重试" |
| 其他运行时异常 | 原样输出错误信息 |
通用 HTTP 异常(400/401/429/500)处理见 `references/common/error-handling.md`。references/common/error-handling.md
# 通用错误处理 所有命令在遇到以下 HTTP / 业务错误时,遵循统一处理策略。 ## 错误码与 Agent 应对 | 错误码 | 含义 | Agent 应对 | |--------|------|-----------| | — | AK 未配置(命令入口预检查) | 输出 AK 引导话术(见 SKILL.md) | | 400 | 参数不合法 | 检查用户输入(关键词、渠道、商品ID等)是否正确 | | 401 | 鉴权无效(AK 错误或已过期) | 输出 AK 引导话术(见 SKILL.md),引导用户重新配置 | | 429 | 请求被限流 | 建议用户稍后重试(通常等待 1-2 分钟) | | 500 | 服务端异常 | 建议用户稍后重试,如持续出现建议联系客服 | ## 网络异常 CLI 已内置 3 次重试(指数退避),重试耗尽后返回 `success: false`。 Agent 应对:告知用户"网络异常,请检查网络连接后重试"。 ## 识别方式 当 CLI 输出 `success: false` 时: 1. 输出 `markdown` 字段(用户可读的错误描述) 2. 检查 `markdown` 中的关键词(如 "AK 未配置"、"401"、"授权过期"、"限流"),按 SKILL.md 异常处理表追加对应引导 ## 各能力特有异常 通用错误外的业务异常,见各能力文档的"业务异常处理"段。
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!
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/1688aiinfra/skills/1688-sourcing-inquiry",
"sourceUrl": "https://clawhub.ai/1688aiinfra/skills/1688-sourcing-inquiry",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T19:33:26.263Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-sourcing-inquiry/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-sourcing-inquiry/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T19:33:26.263Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/1688aiinfra/1688-sourcing-inquiry",
"sourceUrl": "https://clawhub.ai/1688aiinfra/1688-sourcing-inquiry",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T19:33:26.263Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.0",
"href": "https://clawhub.ai/1688aiinfra/1688-sourcing-inquiry",
"sourceUrl": "https://clawhub.ai/1688aiinfra/1688-sourcing-inquiry",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-06T02:28:48.077Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-sourcing-inquiry/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-1688aiinfra-1688-sourcing-inquiry/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.0",
"description": "Initial release of 1688-sourcing-inquiry skill: - Enables users to submit sourcing inquiries based on product name, quantity, and requirements when no specific product is selected. - Transforms vague procurement intent into structured inquiries to match suppliers and get quotations from the 1688 platform. - Skill triggers only for explicit sourcing, inquiry, or quote requests with vague needs and no specific product or supplier chosen. - Strict boundaries and integration with related skills: browsing triggers 1688-product-find, order placement triggers 1688-order, supplier search triggers 1688-source-suppliers. - Provides clear parameter extraction and prompts users to fill missing fields (product name, quantity, requirements) before submitting an inquiry. - Includes robust error handling and strict prohibitions on fabricating sourcing info or misusing the skill outside its defined scope.",
"href": "https://clawhub.ai/1688aiinfra/1688-sourcing-inquiry",
"sourceUrl": "https://clawhub.ai/1688aiinfra/1688-sourcing-inquiry",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-06T02:28:48.077Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
