| name | self-evolving-crm |
| description | 个人 CRM 自动化技能。从 Gmail、日历、会议纪要中自动提取联系人和互动记录， 维护关系摘要和健康评分，推送跟进提醒和会前简报，起草跟进消息。 当用户提到"联系人管理"、"跟进提醒"、"关系维护"、"CRM"、"会前准备"时触发。 |
| version | 0.2.0 |
| user-invocable | true |
| metadata | {"openclaw":{"emoji":"🤝","primaryEnv":"GMAIL_OAUTH_CREDENTIALS","requires":{"env":["GMAIL_OAUTH_CREDENTIALS","GOOGLE_CALENDAR_CREDENTIALS","TELEGRAM_BOT_TOKEN","TELEGRAM_CHAT_ID"],"anyBins":["node","python3"],"os":["darwin","linux"]},"homepage":"https://github.com/maxazure/skills/tree/main/self-evolving-crm"}} |
Self-Evolving CRM — 进化版个人 CRM
不是又一个"录联系人"的工具。解决的核心问题是 关系维护断层。
何时使用
- 用户想管理联系人关系、查询联系人信息
- 需要跟进提醒（"谁该联系了？"）
- 会议前需要准备参会者简报
- 想起草跟进邮件/消息
- 想了解关系健康状况（"哪些关系在冷却？"）
核心能力
- 自动采集 — 从 Gmail/日历/会议纪要提取联系人和互动，零手动输入
- 联系人充实 — 自动从邮件签名、公司网站补全职位/公司/LinkedIn
- 关系健康评分 — 0-100 量化评分，基于互动频率、时效性、双向性、关系年龄
- 会前简报 — 开会前自动准备参会者档案、上次互动、待办事项、建议话题
- AI 起草跟进 — 基于关系上下文和用户写作风格，生成个性化跟进消息草稿
- 待办提取 — 自动识别邮件中的承诺和待办，追踪闭环，提醒逾期事项
- 智能学习 — 从用户的 approve/reject 决策中学习联系人筛选偏好
工作流
每日定时任务（cron: 0 8 * * *）
Step 1: 数据采集
- 读取 Gmail 收发邮件（自 last_scan_time 以来）
- 读取 Google Calendar 会议记录
- 扫描 meeting-notes/ 目录下的新文件
- 过滤已处理内容（检查 processed_email_ids）
- 输出：raw_interaction_records
Step 2: 联系人解析与充实
- 从 raw_interaction_records 提取人名、邮箱、公司
- 查询 MEMORY.md 中的 contacts_db 进行去重
- 合并重复身份（同一人不同邮箱/名称变体）
- 新联系人触发充实流程：
a. 解析邮件签名 → 提取职位、电话、公司
b. 从邮件域名推断公司 → 抓取公司网站获取基本信息
c. （可选）调用 Apollo.io 免费 API 补全 LinkedIn 等
- 低置信度合并 → 记入 pending_merges，等待用户确认
- 输出：resolved_contacts, new_contacts, updated_contacts, pending_merges
Step 3: 关系摘要与健康评分
- 对有新互动的联系人更新关系摘要：
- 最近互动概述
- 当前合作阶段（初识/建立信任/深度合作/维护期/沉寂/重新激活）
- 关键话题、机会、风险
- 计算关系健康评分（0-100）：
Score = Recency(40%) + Frequency(25%) + Responsiveness(20%) + Depth(15%)
衰减规则：关系年龄 > 1年的联系人衰减慢（5%/月），< 3个月的衰减快（15%/月）
- 检测状态变化：warming / cooling / escalation / de-escalation / reactivation
- 输出：relationship_updates, status_changes, health_scores
Step 4: 待办提取
- 从互动记录中提取：
- 显式承诺（"我下周发给你"、"我来安排"）
- 隐式期待（问题未回复、请求未响应）
- 标记"沉默太久"的联系人（> 14 天无互动）
- 检查历史待办是否已完成（闭环检测）
- 输出：action_items, followup_reminders, stale_contacts
Step 5: 推送通知
- 生成 Telegram 每日摘要（≤ 500 字）：
1. 🔴 紧急跟进（逾期待办）
2. 📋 今日跟进（到期提醒）
3. 👤 新联系人（昨日新增）
4. ⚠️ 关系预警（健康评分骤降）
5. ❓ 待确认（合并建议等）
- 推送到 Telegram
会前简报（事件触发：会议开始前 30 分钟）
Step 1: 读取今日日历，筛选外部会议（排除内部/例会/> 10 人）
Step 2: 对每个参会者：
- 查询 contacts_db 获取档案
- 拉取最近 3 次互动记录
- 获取未闭环的待办事项
- （可选）搜索公司近期新闻
Step 3: 生成结构化简报：
- 参会者：姓名 | 职位 | 公司 | 关系健康分
- 上次互动：日期 + 摘要
- 待办事项：你欠他们什么 / 他们欠你什么
- 建议话题：基于历史对话和待办推荐 2-3 个话题
Step 4: 推送到 Telegram
AI 起草跟进消息（用户手动触发）
触发方式：用户说 "帮我给张三写个跟进" 或 "draft followup to Zhang San"
Step 1: 查询联系人档案 + 最近 3 次互动
Step 2: 读取用户写作风格档案（从 MEMORY.md）
Step 3: 确定消息上下文：
- 关系阶段（决定正式/随意程度）
- 未闭环事项（消息的核心内容）
- 距上次联系的时间（决定开头语气）
Step 4: 生成草稿，呈现给用户编辑
Step 5: 用户确认后，保存为已发送互动记录
用户反馈学习（持续运行）
阶段 1（0-20 次决策）：
- 每个新发现的联系人都通过 Telegram 询问用户 approve/reject
- 预过滤：自动跳过 newsletter、noreply、自动化发件人、> 10 人会议
阶段 2（20-50 次决策）：
- 开始显示置信度："我 80% 确定你会跳过这个人，对吗？"
- 学习模式：域名模式、角色模式、互动频率模式
阶段 3（50+ 次决策）：
- 建议切换到自动模式
- 自动添加/跳过，每周推送一次"本周自动决策回顾"让用户修正
- 用户修正会更新模式权重
> 学习模式详情见 [references/agent-data-collector.md](references/agent-data-collector.md) 的"增量扫描流程"部分。
数据结构
联系人档案（存储在 MEMORY.md）
contact:
id: "c_20260320_001"
name: "张三"
email: ["zhangsan@company.com", "zhangsan@gmail.com"]
company: "ABC科技"
title: "技术总监"
linkedin: "linkedin.com/in/zhangsan"
tags: ["客户", "技术决策者"]
relationship_summary: "Q1 重点客户，正在评估 SaaS 方案。技术层面已认可，等待预算审批。"
health_score: 72
health_trend: "cooling"
current_stage: "深度合作"
latest_interaction:
date: "2026-03-18"
type: "email"
summary: "讨论二期开发排期"
next_followup_date: "2026-03-22"
key_topics: ["SaaS 迁移", "二期开发"]
open_loops:
- action: "发送需求文档"
owner: "我"
due: "2026-03-20"
- action: "确认预算"
owner: "张三"
due: "2026-03-25"
first_contact: "2025-11-15"
interaction_count: 23
created_at: "2025-11-15T09:30:00+13:00"
updated_at: "2026-03-18T14:22:00+13:00"
关系健康评分算法
Score = Recency(40%) + Frequency(25%) + Responsiveness(20%) + Depth(15%)
Recency（时效性）:
0-3 天 = 100, 4-7 天 = 85, 8-14 天 = 70, 15-21 天 = 50, 22-30 天 = 30, 31-60 天 = 15, 60+ 天 = 5
使用线性插值，避免边界突变
Frequency（频率）:
过去 90 天的互动次数: ≥12 = 100, 8-11 = 80, 4-7 = 60, 2-3 = 40, 1 = 20, 0 = 0
Responsiveness（双向性，双向比率 60% + 响应速度 40%）:
双向比率: min(outbound,inbound)/max(outbound,inbound) → 0.8-1.0=100, 0.5-0.79=75, 0.2-0.49=40, <0.2=10
平均响应时间: < 2小时 = 100, 2-8小时 = 80, 8-24小时 = 60, 1-3天 = 30, 3+天 = 10
Depth（深度）:
会议 = 30分, 长邮件 = 20分, 短邮件 = 10分, 群发 = 5分（取最近 5 次互动均值，归一化到 100）
衰减修正：
关系年龄 < 3 个月：衰减系数 1.5（快）
关系年龄 3-12 个月：衰减系数 1.0（正常）
关系年龄 > 1 年：衰减系数 0.6（慢，老朋友宽容度高）
评级：
80-100 = 🟢 健康
50-79 = 🟡 需要关注
20-49 = 🟠 正在冷却
0-19 = 🔴 即将断联
输出格式
Telegram 每日摘要（≤ 500 字）
🤝 CRM 日报 | 2026-03-20
🔴 紧急跟进：
• 张三 - 需求文档今天截止 (健康: 72🟡)
• 李总 - 合同确认已逾期 2 天 (健康: 45🟠)
📋 今日跟进：
• 王总 - 轻量问候 _(16天未联系, 健康: 58🟡)_
👤 新联系人：
• 赵明 (产品经理@XYZ科技) — 来自昨日邮件
⚠️ 关系预警：
• 陈总 健康评分 68→52 _(回复变慢，可能有竞品介入)_
❓ 待确认：
• "zhangsan@gmail.com" 和 "张三@company.com" 是否同一人？
/merge_yes /merge_no
会前简报
📋 会前简报 | 14:00 客户需求对齐
👤 李总 | CTO | ABC科技 | 健康: 85🟢
上次互动: 3月15日 讨论技术架构
未闭环: 他答应发技术评审报告（逾期 3 天）
建议话题: ① 跟进技术评审报告 ② 二期排期确认
👤 赵明 | 产品经理 | ABC科技 | 健康: --（新联系人）
首次见面，无历史记录
建议: 了解他在项目中的角色和决策权
配置
必需环境变量
| 变量 | 用途 | 获取方式 |
|---|
GMAIL_OAUTH_CREDENTIALS | Gmail 读取权限 | Google Cloud Console |
GOOGLE_CALENDAR_CREDENTIALS | 日历读取权限 | Google Cloud Console |
TELEGRAM_BOT_TOKEN | 推送通知 | @BotFather |
TELEGRAM_CHAT_ID | 推送目标 | Telegram |
可选环境变量
| 变量 | 用途 | 说明 |
|---|
APOLLO_API_KEY | 联系人充实 | 免费额度可用 |
BRAVE_SEARCH_API_KEY | 公司信息搜索 | 免费 2000次/月 |
NOTION_API_KEY | 同步到 Notion | 可选存储后端 |
Cron 配置
openclaw cron add --name "crm-daily" --cron "0 8 * * *" \
--tz "Pacific/Auckland" --session isolated \
--message "运行 Self-Evolving CRM 每日扫描" --wake now
openclaw cron add --name "crm-meeting-prep" --cron "0 * * * *" \
--tz "Pacific/Auckland" --session isolated \
--message "检查接下来 60 分钟内的会议，生成简报" --wake now
openclaw cron add --name "crm-weekly" --cron "0 9 * * 1" \
--tz "Pacific/Auckland" --session isolated \
--message "生成本周关系健康报告" --wake now
记忆管理
MEMORY.md 存储内容
contacts_db: 所有联系人档案（YAML 格式）skip_patterns: 学习到的跳过规则（域名、发件人模式）writing_style: 用户写作风格档案（问候语、签名、正式度、常用短语）user_preferences: 跟进阈值、关注的标签、通知偏好
memory/ 日志
memory/YYYY-MM-DD.md: 每日互动记录、新增联系人、状态变化日志
状态文件
~/.openclaw/workspace/self-evolving-crm/last_scan.json: 上次扫描时间戳~/.openclaw/workspace/self-evolving-crm/processed_ids.json: 已处理邮件 ID~/.openclaw/workspace/self-evolving-crm/decisions.json: 用户 approve/reject 历史
护栏
- 只读邮件：永远不发送邮件，只读取。起草的跟进消息必须由用户确认后手动发送
- 隐私优先：所有数据存储在本地，不上传到任何外部服务
- 合并确认：低置信度的联系人合并必须用户确认，不自动执行
- 健康评分透明：每个评分都附带计算依据，不是黑箱
- 数据量限制：processed_ids 最多保留 10,000 条（FIFO 淘汰）
故障处理
- Gmail API 失败 → 跳过邮件采集，用已有数据继续后续步骤，通知用户
- 联系人充实 API 失败 → 降级为仅邮件签名解析，标记"待充实"
- Telegram 推送失败 → 保存到本地 Markdown 文件作为备份
- 健康评分计算异常 → 保持上次评分不变，标记"待重新计算"
参考文档
详细的 Agent 角色定义和实现指南见 {baseDir}/references/ 目录：
agent-data-collector.md — 数据采集器详细规范agent-enrichment.md — 联系人充实详细规范agent-relationship.md — 关系摘要与健康评分详细规范agent-action-extractor.md — 待办提取详细规范agent-meeting-prep.md — 会前简报详细规范agent-draft-writer.md — AI 起草跟进详细规范agent-notifier.md — 通知推送详细规范
