Xianyu Openclaw

python scripts/browser_login.py

1. 拉取未读会话

python scripts/pull_inbox.py --limit 5

返回按 last_message_at 倒序的会话列表。取第一条获得 session_id，进入步骤 2。

2. 获取会话上下文

python scripts/get_conversation.py --session-id <session_id> --limit 20

返回 messages 数组和 item_context（商品信息），用于判断买家意图。

3. 风险评估

python scripts/evaluate_risk.py --session-id <session_id>

• 返回 need_human: true → 跳到步骤 7（升级人工）
• 返回 need_human: false → 根据买家意图进入步骤 4 / 5 / 6

4. 售前咨询 → 搜索 FAQ 并回复

python scripts/search_faq.py --session-id <session_id> --query "<买家问题关键词>" --limit 3
python scripts/send_message.py --session-id <session_id> --message "<FAQ答案>"

5. 已付款 → 查询订单并发货

python scripts/find_order.py --session-id <session_id>
python scripts/deliver_order.py --order-id <order_id>
python scripts/send_message.py --session-id <session_id> --message "<发货结果消息>"

发货幂等：相同 order_id 多次调用只发一次，返回首次 payload（idempotent: true）。

6. 补发（链接失效 / 兑换码无效）

python scripts/resend_delivery.py --order-id <order_id> --reason link_expired
python scripts/send_message.py --session-id <session_id> --message "<新链接或兑换码>"

--reason 可选值：link_expired | code_invalid | manual_request

7. 升级人工工单

python scripts/escalate_ticket.py \
  --session-id <session_id> \
  --reason refund_request \
  --summary "<问题摘要>" \
  [--order-id <order_id>]

--reason 可选值：refund_request | platform_intervention | complaint | other

完整决策流程

pull_inbox → get_conversation → evaluate_risk
  ├─ low risk + 售前咨询  → search_faq → send_message
  ├─ low risk + 已付款    → find_order → deliver_order → send_message
  ├─ low risk + 补发请求  → resend_delivery → send_message
  └─ high risk            → escalate_ticket

Script 速查表

Example Commands

# ① 重置数据
python scripts/reset_data.py

# ② 拉取会话
python scripts/pull_inbox.py --limit 2

# ③ 模拟买家发消息后再查看会话
python scripts/simulate_message.py --session-id s_001 --message "链接失效了"
python scripts/get_conversation.py --session-id s_001

# ④ 风险评估 → 发货
python scripts/evaluate_risk.py --session-id s_001
python scripts/find_order.py --session-id s_001
python scripts/deliver_order.py --order-id o_001
python scripts/send_message.py --session-id s_001 --message "已为你发货，请查收。"

补发

node scripts/run-action.js xianyu-resend-delivery orderId=ord_1001 reason=link_expired

升级人工

node scripts/run-action.js xianyu-escalate-ticket sessionId=s_001 reason=refund_request summary=买家投诉退款

真实模式登录（非 mock）

node scripts/browser-login.js

## Output Format

所有 action 返回统一 JSON：

```jsonc
{
  "success": true,          // boolean - 是否成功
  "message": "拉取未读会话成功",  // string  - 人类可读描述
  "data": { ... }           // object  - 业务数据，失败时为 null
}

各 action 的 data 结构

xianyu-pull-inbox

[
  {
    "session_id": "s_001",
    "buyer_id": "buyer_001",
    "buyer_name": "小王",
    "item_id": "item_2001",
    "unread_count": 2,
    "last_message_at": "2025-01-15T10:30:00Z"
  }
]

xianyu-get-conversation

{
  "session_id": "s_001",
  "messages": [
    { "role": "buyer",  "content": "PS 安装包还能下不？" },
    { "role": "seller", "content": "您好，链接稳定可下载。" }
  ],
  "item_context": { "item_id": "item_2001", "title": "PS2025 完整版 Win" }
}

xianyu-send-message

{ "success": true, "mode": "mock" }

xianyu-find-order

[
  {
    "order_id": "ord_1001",
    "sku": "PS2025-WIN",
    "payment_status": "paid",
    "delivery_status": "pending",
    "amount": 29.9
  }
]

xianyu-deliver-order

{
  "order_id": "ord_1001",
  "delivery_status": "success",
  "message_to_buyer": "感谢购买！下载链接: https://... 有效期72小时",
  "payload": {
    "type": "text",
    "messageToBuyer": "...",
    "link": "https://..."
  }
}

xianyu-resend-delivery

{
  "order_id": "ord_1001",
  "delivery_status": "resent",
  "message_to_buyer": "已为您补发新链接...",
  "payload": { "type": "text", "messageToBuyer": "...", "link": "https://..." }
}

xianyu-escalate-ticket

{ "ticket_id": "T-20250115-s_001" }

xianyu-evaluate-session-risk

{
  "level": "high",
  "needHuman": true,
  "matchedKeywords": ["退款"]
}

xianyu-search-faq

[
  {
    "sku": "PS2025-WIN",
    "question": "下载链接打不开怎么办？",
    "answer": "请关闭代理/VPN 后重试...",
    "score": 0.85
  }
]