# Self Evolving Crm

> 个人 CRM 自动化技能。从 Gmail、日历、会议纪要中自动提取联系人和互动记录， 维护关系摘要和健康评分，推送跟进提醒和会前简报，起草跟进消息。 当用户提到"联系人管理"、"跟进提醒"、"关系维护"、"CRM"、"会前准备"时触发。

- Skill: `maxazure/self-evolving-crm` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add maxazure/self-evolving-crm`
- Raw SKILL.md: https://api.skillmd.com/api/skills/maxazure/self-evolving-crm/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: maxazure (https://skillmd.com/u/maxazure)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/maxazure/self-evolving-crm

---


# Self-Evolving CRM — 进化版个人 CRM

> 不是又一个"录联系人"的工具。解决的核心问题是 **关系维护断层**。

## 何时使用

- 用户想管理联系人关系、查询联系人信息
- 需要跟进提醒（"谁该联系了？"）
- 会议前需要准备参会者简报
- 想起草跟进邮件/消息
- 想了解关系健康状况（"哪些关系在冷却？"）

## 核心能力

1. **自动采集** — 从 Gmail/日历/会议纪要提取联系人和互动，零手动输入
2. **联系人充实** — 自动从邮件签名、公司网站补全职位/公司/LinkedIn
3. **关系健康评分** — 0-100 量化评分，基于互动频率、时效性、双向性、关系年龄
4. **会前简报** — 开会前自动准备参会者档案、上次互动、待办事项、建议话题
5. **AI 起草跟进** — 基于关系上下文和用户写作风格，生成个性化跟进消息草稿
6. **待办提取** — 自动识别邮件中的承诺和待办，追踪闭环，提醒逾期事项
7. **智能学习** — 从用户的 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）

```yaml
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"  # warming / stable / 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 配置

```bash
# 每日 CRM 扫描 + 推送
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` — 通知推送详细规范