1688 技能使用教程

3ChatClaw技能中心
1

1688 技能使用教程

一、技能简介

1688 技能是1688官方提供的一组面向 1688 商家、采购方和分销用户的业务助手，覆盖找货源、找供应商、采购询盘、分销铺货、营销报名、财税测算、线下交易和新手引导等常见场景。用户只需要根据自己的业务问题选择对应技能，或直接描述需求，3ChatClaw 会调用对应能力，并返回结果。

当前包含 8 个官方技能：

技能名称 适合解决的问题
1688-shopkeeper 搜商品、选品、查绑定店铺、铺货到下游平台
1688找供应商 查供应商、找工厂、查询产业带信息
1688采购询盘寻源 发布采购询盘，让平台匹配供应商和报价方案
1688分销 分销选品铺货、订单管理、店铺绑定、分销知识查询
1688分销新手引导助手 分销新手开店、绑店、选品、铺货、售后等操作引导
1688营销推广 招商活动查询、商品建议价查询、活动报名、商机推荐
1688-AI财税 商品含税定价、四税联算、整体税负测算
88生意通-1688线下交易工具 88 生意通采购单创建、签署、查询、确认收货、退款

二、前置条件

使用 1688 官方技能前，请提前准备以下信息：

  1. 1688 AK
    1688 官方技能统一使用 ALI_1688_AK 环境变量进行身份认证。配置一次后，8 个官方技能都可以读取该环境变量。

如何获取 1688 AK

  1. 打开 https://clawhub.1688.com/。
  2. 登录 1688 账号。
  3. 点击页面右上角的钥匙图标。
    image
    image1280×736 124 KB
  4. 复制页面中显示的 AK。
    image
    image1280×427 69.7 KB

    请注意：不要把 AK 直接发送到聊天窗口，也不要写入文档、代码、日志或截图中。

三、配置环境变量

获取 AK 后，需要将 AK 配置到 3ChatClaw 的环境变量中。

本套 1688 官方技能所需环境变量

key value
ALI_1688_AK 从 1688 官方页面复制的 AK

只需要配置这一个环境变量。配置完成后，1688-shopkeeper、1688找供应商、1688采购询盘寻源、1688分销、1688分销新手引导助手、1688营销推广、1688-AI财税、88生意通-1688线下交易工具 都会使用它。

如何在 3ChatClaw 中配置环境变量

  1. 点击左侧栏的 环境变量。
  2. 点击 添加变量。
  3. 在左侧 key 中填写：ALI_1688_AK。
  4. 在右侧 value 中填写刚刚从 1688 官方页面复制的 AK。
  5. 点击右上角 保存。
  6. 保存后，重新执行刚才的 1688 技能请求。

四、技能安装

用户可以在技能市场中下载并安装 1688 官方技能。

  1. 点击左侧边栏中的 技能市场，进入技能市场页面。
  2. 搜索或浏览 1688 官方技能。
  3. 找到需要使用的技能，例如 1688 分销、1688 采购询盘寻源 或 财税税负测算。
  4. 点击技能卡片。
  5. 点击 一键安装，即可完成安装。
  6. 安装完成后，点击左侧边栏中的 已安装技能，即可查看已安装的技能。

建议将 8 个 1688 官方技能都安装好。这样用户后续只需要描述业务需求，3ChatClaw 就能更自然地在对应技能之间切换。

五、如何选择要使用的技能

如果不确定应该使用哪个技能，可以先看下面这张场景表。

用户想做什么 推荐技能 示例说法
在 1688 搜商品、找货、选品 1688-shopkeeper “帮我在 1688 找适合抖音卖的保温杯”
查某类供应商或工厂 1688找供应商 “帮我找义乌小商品供应商”
还没选定商品，想发布采购需求 1688采购询盘寻源 “我想采购 500 个帆布袋，帮我发询盘找报价”
做一件代发、铺货、查分销订单 1688分销 “帮我找几款适合拼多多铺货的收纳盒”
新手不知道怎么开始分销 1688分销新手引导助手 “我想做一件代发，第一步怎么做？”
查招商活动、报名活动、看商机 1688营销推广 “帮我看看最近有什么活动可以报名”
算含税价格、增值税、利润税负 1688-AI财税 “进价 60，想赚 20，含税售价怎么定？”
处理 88 生意通采购单 88生意通-1688线下交易工具 “帮我查一下采购单状态”

六、启动技能

1688 官方技能支持两种常见启动方式：

  • 通过对话发送 Prompt 启动；
  • 通过 任务 功能启动。

注意：启动技能前，建议先完成 ALI_1688_AK 环境变量配置。若未配置，技能会提示用户先获取 AK 并配置环境变量。

通过对话启动技能

1. 获取启动 Prompt

  1. 点击左侧栏的 技能市场。
  2. 找到需要使用的 1688 官方技能并点击。
  3. 在弹出的技能卡片中复制 Prompt。

用户也可根据自己真实需求编写Prompt

示例：

使用 1688-source-suppliers 这个技能，查询 1688 供应商、工厂和产业带信息。
帮我找义乌做发饰的供应商。

使用 1688-finance-tax 这个技能，进行 1688 商品含税定价、四税联算和整体税负测算。
我是小规模纳税人，进货成本 60 元，希望利润 20 元，帮我算含税售价。

使用 1688-marketing 这个技能，查询 1688 招商活动、商品建议价、提交活动报名和查看商机推荐。
帮我看看最近有什么适合家居百货的招商活动。
#### 2. 启动技能
  1. 将刚刚复制的 Prompt 粘贴到对话框中。
  2. 在 Prompt 后面补充自己的业务需求。
  3. 点击发送。
  4. 等待 3ChatClaw 返回结果。

通过任务启动技能

如果希望把某个 1688 官方技能固定成一个任务入口，可以通过 任务 功能创建任务。

操作步骤

  1. 点击左侧边栏中的 任务，进入任务中心。
  2. 点击 创建任务。
  3. 选择需要使用的 1688 官方技能。
  4. 填写任务名称，例如“1688 分销选品任务”或“1688 财税测算任务”。
  5. 按任务页面提示填写或确认信息。
  6. 点击 创建任务。
  7. 任务创建完成后，可在任务中心查看该任务。
  8. 点击 立即运行，即可执行任务。
  9. 任务执行过程会以右上角弹窗或聊天结果的形式展示。
  10. 如需查看执行结果，可点击左侧栏的 聊天 查看。

大多数 1688 官方技能更适合按需查询、按需执行，例如查供应商、查活动、发询盘、算税负。对于这类技能，直接在聊天中发起请求通常更方便。

九、常见问题

1. 为什么提示 AK 未配置？

说明 3ChatClaw 当前没有读取到 ALI_1688_AK 环境变量。

请按以下步骤处理：

  1. 打开 https://clawhub.1688.com/。
  2. 登录 1688 账号。
  3. 点击右上角钥匙图标复制 AK。
  4. 回到 3ChatClaw 左侧栏，点击 环境变量。
  5. 添加或更新 ALI_1688_AK。
  6. 保存后重新执行刚才的请求。

2. 为什么配置 AK 后仍然失败？

可能有以下原因：

  • 环境变量没有点击保存；
  • key 写错了，必须是 ALI_1688_AK；
  • AK 复制不完整；
  • 当前 1688 账号没有对应业务权限；
  • 技能调用的业务接口暂时不可用；
  • 需要重新打开任务或重新发送请求，让新环境变量生效。

3. 查询结果和 1688 页面不一致怎么办？

请以 1688 官方页面展示为准。技能返回结果依赖接口数据，可能受到账号权限、接口刷新、商品状态、活动状态等因素影响。