/install yufluentcn-chat-assist
跨境客服回复助手
为 Amazon / Shopify / TikTok Shop 买家站内信/客服消息生成 可直接粘贴发送的回复正文。ClawHub / OpenClaw 云端模式 — Harness chat_reply + messaging-guard 在 Yufluent 服务端执行;本机只需 TOKENAPI_KEY(tk-*)与 requests。
本技能 不连接卖家后台、不自动发送消息、不查询真实物流 API;order_context 由你提供摘要,模型不会虚构已核实的状态。
OpenClaw 与 Yufluent(必读)
OpenClaw 对话与技能调用共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw 。
| 层 | 走哪里 | 干什么 |
|---|---|---|
| OpenClaw 对话 | Yufluent /v1/chat/completions(同一 tk-*) |
收集买家原文与订单上下文、调 run.py、人工微调后发送 |
| 客服正式输出 | POST /v1/skills/chat-assist/run(同一 tk-*) |
Harness + 平台规则 → 回复正文 |
Agent 硬性规则:
- 禁止用对话模型自行撰写完整客服回复(尤其是含退款/赔偿承诺的句子)。
- 必须通过
python scripts/run.py ...(或POST /v1/skills/chat-assist/run)获取输出。 - 对话模型仅用于:确认平台与语言、收集
message/order_context、提醒卖家审核、建议转人工场景。 - 只需
TOKENAPI_KEY,不要要求用户另配厂商 LLM Key。
Instructions(Agent 工作流)
- 确认平台:
amazon|shopify|tiktok(决定模板与 messaging 规则)。 - 确认回复语言
--lang:默认与买家消息一致;卖家指定时用zh|en|es|de|fr|ja。 - 收集输入:
message(必填):买家原文,原样粘贴,不要改写成第三人称。order_context(强烈建议):订单号、物流单号、当前状态摘要、卖家授权政策(如「可补发」)。product(可选):SKU/品名,便于对齐 Listing。
- 调用(必须 — 云端):
python scripts/run.py \ --message "Where is my package? Order #123-4567890" \ --platform amazon \ --lang en \ --product "Wireless Earbuds Pro" \ --order-context "Shipped 2026-05-20, tracking 1Z999, in transit US" - 交付:将 stdout 回复正文交给卖家;提醒删除不实承诺、按平台按钮发送。
- 计费:402 余额不足;401 密钥无效。
买家消息输入格式
| 字段 | CLI / API | 说明 |
|---|---|---|
| 买家消息 | --message / message |
必填;支持多行;保留买家原语言 |
| 订单/物流 | --order-context / order_context |
建议格式见下表 |
| 产品 | --product / product |
关联 ASIN/SKU 或商品名 |
| 平台 | --platform |
amazon | shopify | tiktok,默认 amazon |
| 语言 | --lang |
输出语言;未指定时 Harness 结合买家消息与 locale |
order_context 推荐写法(一行或短段落)
Order #123-4567890 | Shipped 2026-05-20 | Tracking 1Z999AA10123456784 | In transit to US
| 片段 | 示例 |
|---|---|
| 订单号 | Order #123-4567890 |
| 物流状态 | Delivered / In transit / Delayed — carrier investigation |
| 卖家授权 | Seller authorized: replacement once / No refund without return |
未提供时 Harness 填「(买家未提供订单号)」—— 回复会以「为您核实」为主,避免编造物流细节。
常见场景(Agent 推断平台与语气)
| 场景 | 回复策略要点 |
|---|---|
| 物流查询 | 共情 + 说明已记录单号 + 引导查 tracking / 承诺跟进时效(不承诺具体送达日) |
| 未收到/丢件 | 请照片/地址确认 + 转核实 + 按授权提及补发/退款流程 |
| 质量/损坏 | 致歉 + 要订单号与照片 + 不预判责任 |
| 退款/退货 | 引用平台 RMA 步骤;无授权时 不承诺金额 |
| 售前咨询 | 规格/库存中性说明 + 链到 Listing(Amazon 避免站外营销外链) |
| 差评/威胁 | 保持专业;不要求改评;引导站内解决 |
输出说明
- 纯文本回复正文(非 JSON):无标题、无「以下是回复」类前缀。
- 长度通常 2–5 句(由
messaging-guard约束)。 - 须 人工审核 后再在 Seller Central / Shopify Inbox / TikTok 商家后台发送。
平台差异(简要)
| 平台 | 注意 |
|---|---|
| Amazon | Buyer-Seller Messaging;避免站外联系与营销外链 |
| Shopify | 可提及店铺政策,勿编造条款原文 |
| TikTok Shop | 注意 SLA 表述,避免绝对送达日期 |
与其他技能联动
| 需求 | 技能 |
|---|---|
| 批量评论洞察后再回信 | yufluentcn-review-intel → 本技能 |
| 改 Listing 减少售前咨询 | yufluentcn-ecommerce-listing |
| 关键词/描述与买家问法对齐 | yufluentcn-seo-pro |
| 独立站运营话术策略 | yufluentcn-shopify-operator |
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
TOKENAPI_KEY |
是 | tk-* |
TOKENAPI_BASE_URL |
否 | 默认 http://localhost:8080/v1 |
触发词
- "回复这条买家消息"
- "客服怎么回" / "写个英文回复"
- "订单到哪了" / "refund request"
- "包裹破损怎么回"
- "TikTok 买家催发货"
Examples
Amazon — 物流(英文)
python scripts/run.py \
--message "Where is my order? It's been 10 days." \
--platform amazon \
--lang en \
--order-context "Order #111-2223333, shipped May 18, tracking in transit" \
--product "USB-C Hub 7-in-1"
Shopify — 退款咨询(中文)
python scripts/run.py \
--message "想退货,不喜欢颜色" \
--platform shopify \
--lang zh \
--order-context "Order #1042, delivered May 20, 30-day return policy applies" \
--product "北欧实木餐椅"
TikTok — 售前(英文)
python scripts/run.py \
--message "Does this fit iPhone 15?" \
--platform tiktok \
--lang en \
--product "MagSafe Phone Case"
合规声明
- 回复须符合各平台 Buyer-Seller Messaging 与当地消费者法规。
- 不得索要站外联系方式、引导删改差评、未经授权承诺退款/赔偿。
- 卖家对发送内容负最终责任;本技能输出仅为草稿。
Harness 合规护栏:harness/scenes/chat_reply/policies/messaging-guard.md
版本记录
| 版本 | 日期 | 变更 |
|---|---|---|
| v0.3.0 | 2026-05-28 | 按 ad-optimize 结构扩展:工作流、输入格式、场景表、示例与合规 |
| v0.2.0 | — | Harness chat_reply 三平台模板 |
| v0.1.0 | — | 初始云端薄客户端 |
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install yufluentcn-chat-assist - 安装完成后,直接呼叫该 Skill 的名称或使用
/yufluentcn-chat-assist触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Yufluentcn Chat Assist 是什么?
跨境电商买家消息智能回复助手,支持Amazon、Shopify、TikTok,生成符合买家站内信规范的客服回复草稿。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 34 次。
如何安装 Yufluentcn Chat Assist?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install yufluentcn-chat-assist」即可一键安装,无需额外配置。
Yufluentcn Chat Assist 是免费的吗?
是的,Yufluentcn Chat Assist 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Yufluentcn Chat Assist 支持哪些平台?
Yufluentcn Chat Assist 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Yufluentcn Chat Assist?
由 metahuan(@metahuan)开发并维护,当前版本 v1.0.0。