ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

order-tracker

Track and manage sales orders with status updates, notifications, and dashboard reporting. Supports order creation, status transitions (pending/confirmed/shipped/delivered), email/Discord notifications, and order history visualization. Use when you need to monitor order fulfillment, send shipping updates to customers, or generate order analytics.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/cjboy007/ssa-order-tracker
Or

Order Tracker Skill

Description

本地订单跟踪系统,提供手动订单状态管理、客户邮件通知和命令行看板功能。适用于 Farreach Electronic 外贸订单生命周期管理(从生产到交付),无需对接工厂 ERP 或物流 API。

When to Use

  • 查询某个订单的当前状态
  • 更新订单状态(生产中 → 待发货 → 已发货 → 已完成)
  • 向客户发送订单状态变更邮件通知
  • 查看所有在途订单的看板汇总
  • 检测逾期或紧急(≤7 天)订单

Prerequisites

  • Node.js v16+
  • 已配置 imap-smtp-email skill 的 SMTP .env 文件(用于发送通知邮件)
  • 依赖安装:npm install(在 skill 目录下执行)

Skills Directory

skills/order-tracker/

How to Invoke

All scripts are run from the scripts/ subdirectory.

1. View Order Dashboard

cd skills/order-tracker/scripts

# 查看所有订单(按状态分组)
node order-dashboard.js

# 按状态过滤
node order-dashboard.js --status in_production
node order-dashboard.js --status shipped

# 查看单个订单详情
node order-dashboard.js --order-id ORD-20260324-001

# 输出格式(table / compact / json)
node order-dashboard.js --format json

2. Update Order Status

cd skills/order-tracker/scripts

# 预览(dry-run,不写入)
node update-order-status.js --order-id ORD-20260324-001 --status ready_to_ship --dry-run

# 更新状态
node update-order-status.js \
  --order-id ORD-20260324-001 \
  --status shipped \
  --notes "DHL Express, 单号: 1234567890, ETA: 4月25日"

# 更新状态 + 标记需要发通知
node update-order-status.js \
  --order-id ORD-20260324-001 \
  --status in_production \
  --notes "工厂已排期" \
  --trigger-notification

3. Send Customer Notification Email

cd skills/order-tracker/scripts

# 预览邮件(不发送)
node send-order-notification.js --order-id ORD-20260324-001 --dry-run

# 发送通知(使用订单当前状态的邮件模板)
node send-order-notification.js --order-id ORD-20260324-001

# 指定状态模板发送
node send-order-notification.js --order-id ORD-20260324-001 --status shipped

Order Status Model

6 状态机:

pending_production → in_production → ready_to_ship → shipped → completed
                                                              ↘ cancelled(任意阶段可取消)
状态中文说明
pending_production待生产订单确认,等待生产
in_production生产中工厂生产中
ready_to_ship待发货生产完成,等待发货
shipped已发货货物已发出
completed已完成客户确认收货
cancelled已取消订单取消

Email Templates

通知脚本支持 5 种双语(EN/ZH)邮件模板:

  • in_production — 生产进度通知
  • ready_to_ship — 准备发货通知
  • shipped — 发货确认(含物流单号)
  • completed — 订单完成确认
  • cancelled — 取消通知

Typical Workflow Example

BASE=skills/order-tracker/scripts
ORDER=ORD-20260324-001

# 开始生产 + 通知客户
node $BASE/update-order-status.js --order-id $ORDER --status in_production --notes "工厂已排期"
node $BASE/send-order-notification.js --order-id $ORDER

# 发货 + 通知客户
node $BASE/update-order-status.js --order-id $ORDER --status shipped --notes "DHL 单号: 1234567890"
node $BASE/send-order-notification.js --order-id $ORDER

# 查看看板
node $BASE/order-dashboard.js

Data Files

文件路径说明
订单数据data/orders.json所有订单(手动维护)
订单 Schemaconfig/order-schema.jsonJSON Schema 验证定义
状态变更日志logs/status-changes.log每次状态更新记录
通知日志logs/notifications.log邮件发送记录

Metadata

Author@cjboy007
Stars3562
Views1
Updated2026-03-29
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-cjboy007-ssa-order-tracker": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

logistics

物流管理技能,提供提单生成、报关单据生成、物流跟踪等功能。支持 OKKI 客户数据同步和自动化文档处理。

cjboy007 3562

okki-email-sync

Synchronize email activities and quotation events with OKKI CRM as follow-up trail records. Automatically matches emails to CRM customers via domain lookup and vector search, creates trail records (email type=102, quotation type=101), and deduplicates entries. Requires OKKI CRM API access and optional vector search setup. Use when you need to automatically log email communications and quotation events in your CRM.

cjboy007 3562

follow-up-engine

Automated customer follow-up scheduling and execution engine for B2B sales. Generates personalized follow-up email drafts based on customer stage, last contact date, and follow-up strategy. Integrates with CRM systems (configurable) to sync follow-up records. Use when you need to automate outbound sales follow-ups, schedule reminders, or generate follow-up email content for dormant leads.

cjboy007 3562

报价单工作流

自动化生成报价单(Excel/Word/HTML/PDF),集成数据验证防止示例数据,支持 OKKI CRM

cjboy007 3562

auto-evolution

Multi-agent auto-evolution system — orchestrate review-execute-audit loops with 4 roles (Coordinator, Reviewer, Executor, Auditor). A single coordinator agent drives the loop by spawning sub-agents for review, execution, and audit. Break goals into subtasks, auto-iterate with dual quality gates, and auto-package results. Use when: user wants autonomous task execution with built-in quality assurance.

cjboy007 3562