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.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/cjboy007/ssa-order-trackerOrder Tracker Skill
Description
本地订单跟踪系统,提供手动订单状态管理、客户邮件通知和命令行看板功能。适用于 Farreach Electronic 外贸订单生命周期管理(从生产到交付),无需对接工厂 ERP 或物流 API。
When to Use
- 查询某个订单的当前状态
- 更新订单状态(生产中 → 待发货 → 已发货 → 已完成)
- 向客户发送订单状态变更邮件通知
- 查看所有在途订单的看板汇总
- 检测逾期或紧急(≤7 天)订单
Prerequisites
- Node.js v16+
- 已配置
imap-smtp-emailskill 的 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 | 所有订单(手动维护) |
| 订单 Schema | config/order-schema.json | JSON Schema 验证定义 |
| 状态变更日志 | logs/status-changes.log | 每次状态更新记录 |
| 通知日志 | logs/notifications.log | 邮件发送记录 |
Metadata
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 skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-cjboy007-ssa-order-tracker": {
"enabled": true,
"auto_update": true
}
}
}Related Skills
logistics
物流管理技能,提供提单生成、报关单据生成、物流跟踪等功能。支持 OKKI 客户数据同步和自动化文档处理。
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.
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.
报价单工作流
自动化生成报价单(Excel/Word/HTML/PDF),集成数据验证防止示例数据,支持 OKKI CRM
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.