Customer Segmentation

Automatically segment customers into five levels using OKKI CRM data, score them, sync tags safely, and provide lifecycle and value-based strategy recommenda...

Customer Segmentation — 客户分层

自动客户标签 + 生命周期管理 + 价值分析。基于 OKKI CRM 数据，5 级客户分层（VIP/活跃/普通/休眠/流失），自动评分+标签同步。

模块

脚本	大小	功能
customer-data-collector.js	—	OKKI API 增量采集客户数据
scoring-engine.js	—	加权评分 + 自动分层（5 级）
tag-sync.js	16KB	OKKI 标签同步（⚠️ 安全机制齐全）
strategy-output.js	13KB	策略建议输出 + 升级机会识别

配置

• config/segmentation-rules.json — 5 级分层规则 + 评分权重 + 阈值

使用

bash

cd /Users/wilson/.openclaw/workspace/skills/customer-segmentation

# 1. 采集客户数据
node scripts/customer-data-collector.js

# 2. 评分 + 分层
node scripts/scoring-engine.js
node scripts/scoring-engine.js --sample  # 使用示例数据

# 3. 查看策略建议
node scripts/strategy-output.js
node scripts/strategy-output.js --format summary

# 4. 同步标签到 OKKI（默认 dry-run！）
node scripts/tag-sync.js                  # dry-run 预览
node scripts/tag-sync.js --confirm        # 实际写入
node scripts/tag-sync.js --confirm --limit 5  # 分批写入前 5 个

分层标准

等级	标签	说明
VIP	SEG:VIP	高价值客户
活跃	SEG:活跃	定期下单
普通	SEG:普通	偶尔互动
休眠	SEG:休眠	长期无互动
流失	SEG:流失	已流失

⚠️ Tag-Sync 安全机制

重要： tag-sync.js 会写入 OKKI CRM 标签，内置多重安全保护：

1. 默认 dry-run — 不加 --confirm 不会写入
2. SEG: 前缀白名单 — 只操作 SEG: 前缀标签，不影响其他标签
3. GET 先合并 — 写入前先获取现有标签，合并后再写入（避免覆盖）
4. 写入前备份 — 自动备份当前标签状态
5. 配额预估 — >80% 配额自动中止
6. 500ms 间隔 — API 调用限速
7. --limit 分批 — 支持分批验证

依赖

• OKKI CRM — 客户数据 + 标签写入

数据存储

• data/customer-scores.json — 评分结果
• data/strategy-recommendations.json — 策略建议
• data/metrics-export.json — 看板指标