Yufluent Clawhub Publish Yufluentcn Inventory Pilot

库存驾驭助手

基于卖家提供的 销量/库存数据 做预测、补货建议、滞销预警与资金占用分析。ClawHub / OpenClaw 云端模式 — Harness inventory_forecast 输出结构化 JSON；本机只需 TOKENAPI_KEY（tk-*）与 requests。

不直连 ERP、不自动下单、不连接平台 API。

快速开始（3 步，60 秒）

1. 注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
2. 设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
3. 运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）

OpenClaw 对话与技能调用共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw。

Agent 硬性规则：

• 禁止用对话模型自行撰写完整补货计划表
• 必须通过 python scripts/run.py ... 获取输出
• 只需 TOKENAPI_KEY，不要另配厂商 Key

Instructions（Agent 工作流）

1. 确认模式（见下表）；用户说"要不要补货" → replenish；"预测销量" → forecast。
2. 收集数据：
   • --message（必填）：本轮问题
   • --mode：forecast | replenish | clearance | capital
   • --sales-data：历史销量 CSV 或文件路径
   • --current-stock：当前库存（如 SKU-A:120, SKU-B:45）
   • --inventory-data：库存明细（含库龄）
   • --lead-time：供应商交期（天）
   • --transit-days：头程时效（天）
3. 调用（必须 — 云端）：

   python scripts/run.py \
     --mode replenish \
     -m "帮我算要不要补货" \
     --sales-data sales.csv \
     --current-stock "SKU-A:120, SKU-B:45" \
     --lead-time 21 \
     --transit-days 14 \
     --lang zh
   

4. 计费：402 余额不足；401 密钥无效。

四模式

与其他技能联动

环境变量

触发词

• "帮我算一下要不要补货"
• "哪些 SKU 快滞销了"
• "预测下个月销量"
• "资金占用分析"
• "库存管理"
• "清仓建议"
• "inventory forecast"

Examples

补货建议

python scripts/run.py \
  --mode replenish \
  -m "SKU-A 日均卖15件，当前库存120，要不要补？" \
  --sales-data sales.csv \
  --current-stock "SKU-A:120, SKU-B:45" \
  --lead-time 21 \
  --transit-days 14 \
  --lang zh

滞销预警

python scripts/run.py \
  --mode clearance \
  -m "哪些 SKU 超过90天没动销？" \
  --inventory-data inventory.csv \
  --age-threshold "90" \
  --lang zh

销量预测

python scripts/run.py \
  --mode forecast \
  -m "预测未来30天销量" \
  --sales-data sales.csv \
  --lang zh

合规声明

• 输出仅供参考，不构成采购或财务决策建议
• 不连接平台 API 自动拉取库存/销量数据
• 不自动生成采购单/下单指令

版本记录