接入分两条独立路径 —— 看你团队用哪种微信：
| 方式 | 适用场景 | 工具 |
|---|---|---|
| 本机微信 (个微) | 个人 SDR、微商、小团队、客户大量在个人微信好友里 | macos_wechat_collector (macOS 客户端) |
| 企业微信 (企微) | 已经在用企微的销售团队、有合规 / 审计要求 | wecom-cli HTTP 桥 |
两条路径互不冲突 —— 一个账号可以同时接入个微 + 企微，控制台会按 source 分流。
路径 A · 接入本机微信
只支持 macOS。Windows 端的本机微信自动化在 P1 评估中。
1. 装 collector
# 在 collector 包目录下
cd collector/macos_wechat_collector
./deploy/install.sh
2. 给权限
打开「系统设置 → 隐私与安全」：
- 辅助功能：勾选运行 collector 的 Python 解释器
- 屏幕录制：勾选同一个 Python
- 自动化（按需）：允许控制 WeChat.app
3. 验证
curl http://127.0.0.1:8765/health
应该看到 wechat.running: true / logged_in: true。
没看到的话查 常见问题。
4. 在控制台识别账号
回到 AI-SCRM 控制台 → 来源管理 → 「识别本机当前微信账号」。 collector 会读取本机微信的昵称 / 微信号 / 头像，做成你的 source。
路径 B · 接入企业微信
1. 装 wecom-cli
按 wecom-cli 自己的 README 装到本机/服务器 —— AI-SCRM 不强绑版本， 任何 stable 版都行。
2. 给企微管理后台开权限
到企微管理后台 → 应用管理 → 智能机器人 → 找到对应机器人， 分别勾选「通讯录」(type=4) 和「消息」(type=6) 两项权限。
3. init wecom-cli
wecom-cli init
按提示扫码登录、授权。完成后 wecom-cli status 应该返回 logged_in: true。
4. 启动 wecom-bridge
控制台需要的不是 wecom-cli 本体，而是封装了它的 HTTP bridge：
scripts/start-all.sh start
# wecom-bridge 默认 0.0.0.0:8766
5. 在控制台连接
来源管理 → 「同步通讯录」 → 拉到通讯录后可以选择”自己 + 哪些群” 作为采集来源。
接入后做什么
- 跑第一次朋友圈采集 → 快速接入
- 接群运营 → 群运营 playbook
- 风控配置 → 风控规则参考