Customer Segmentation
by @cjboy007
Automatically segment customers into five levels using OKKI CRM data, score them, sync tags safely, and provide lifecycle and value-based strategy recommenda...
clawhub install ssa-customer-segmentation📖 About This Skill
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 级分层规则 + 评分权重 + 阈值使用
cd /Users/wilson/.openclaw/workspace/skills/customer-segmentation1. 采集客户数据
node scripts/customer-data-collector.js2. 评分 + 分层
node scripts/scoring-engine.js
node scripts/scoring-engine.js --sample # 使用示例数据3. 查看策略建议
node scripts/strategy-output.js
node scripts/strategy-output.js --format summary4. 同步标签到 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 — 看板指标