核心用法
activecampaign-claw 是一个深度集成 ActiveCampaign v3 API 的分析型技能，面向营销人员和销售团队。安装后首先运行 calibrate.py 扫描账户，建立包含列表、标签、管道、自动化及 90 天基准的 state.json 状态文件。此后用户可通过自然语言调用 50+ 分析脚本，涵盖：
- 绩效分析：活动事后分析、主题行优化、发送时间建议、疲劳风险检测、域名级参与对比（Gmail vs Outlook）
- 列表健康：重复联系人检测、角色邮箱识别、字段完整度、订阅者质量评估、预导入 CSV 验证
- 线索与销售：热线索排序、交易下滑预警、MQL→SQL 转化诊断、输赢归因
- 自动化卫生：孤儿自动化审计、漏斗步骤流失、多自动化重叠检测、停滞报名
- 运营合规：标签/字段/列表审计、GDPR 数据主体导出、退订合规检查、Webhook 可达性测试
所有数据修改操作均通过单一审计路径，支持 AC_READ_ONLY=1 纯分析模式，默认每进程最多 10 次写入，需用户显式确认。
显著优点
- 账户校准机制：非冷启动，每次对话基于实际数据结构
- 领域知识嵌入：内置邮件最佳实践、细分理论、可送达性模式
- 工作流配方：参数化的欢迎系列、日常简报、交易卫生等可复用流程
- 结果日志：
history.jsonl和insights.md实现跨会话性能追踪 - 防御性设计：沙箱写入限制、审计日志、删除前双重确认
潜在局限
- 无法发送活动或创建自动化：受限于 AC v3 API，仅能提供设计规范供用户在 UI 中实施
- 部分功能需高阶套餐：交易管道、任务、B2B 账户等功能在较低套餐返回 403
- 活动参与度数据不完整：
/messageActivities不可用时会回退至点击-only 分析 - 阶段停留时间无法计算：API 不暴露交易阶段移动时间戳
适合人群
- 管理 10K+ 订阅者的 ActiveCampaign 营销运营人员
- 需要管道可视化和线索优先级的销售团队
- 寻求自动化健康检查和数据治理的 CRM 管理员
- 希望减少手动报告、建立营销归因的 RevOps 团队
常规风险
- API 令牌泄露：需配置
AC_API_TOKEN环境变量，建议使用最小权限集成用户 - 误删风险：尽管有多层确认，删除操作永久不可逆；建议优先使用标记抑制而非物理删除
- 速率限制：5 req/s 限制，大型账户导出需分页等待
- 数据准确性依赖校准：超过 30 天未更新基准可能导致分析偏差