核心用法
activecampaign-claw 是面向营销人员和销售团队的 ActiveCampaign 深度集成代理，通过 v3 API 提供 60+ 个专业分析脚本和可执行工作流。核心能力分为四大维度：
营销分析：活动复盘（campaign postmortem）、主题行效果分析、发送时间优化、疲劳度监测、域名级参与度对比（Gmail vs Outlook）、互动衰减队列、基线漂移检测等 20+ 个报告。
列表与联系人健康：列表审计、重复联系人查找、角色邮箱检测（info@/support@）、字段完整度、僵尸联系人识别、新订阅者质量评估、预导入 CSV 校验、列表增长预测。
销售与 CRM：线索评分排名、 slipping deals（逾期商机）、MQL→SQL 转化诊断、输赢来源分析、管道健康审计、按代表绩效记分板、B2B 账户审计。
运营与合规：标签/字段/列表/分段/自动化审计、GDPR 第 15 条数据主体导出、取消订阅合规审计、Webhook 可达性检测、账户快照与对比。
显著优点
- 账户校准机制：首次运行时扫描账户结构，建立本地
state.json，后续对话基于真实数据而非冷启动 - 分层工作流设计：食谱层（recipes）→ 框架层（domain knowledge）→ 参考层（API 端点），匹配资深营销人员的思维方式
- 严格的写操作防护：默认只读，写操作需显式确认；支持
AC_READ_ONLY=1纯分析模式；单进程写上限（默认 10 条）；完整审计日志（writes.jsonl） - 本地数据驻留：所有报告、快照、历史记录仅写入
~/.activecampaign-skill/，零第三方传输，0600 文件权限 - 计划层级优雅降级：Deals/Tasks/Accounts 等 Plus+ 功能在 403 时返回友好提示而非崩溃
潜在局限
- API 能力边界：无法创建自动化流程（仅支持将联系人加入现有自动化）、无法直接发送活动（仅提供设计蓝图）、无法读取站点追踪页面访问数据
- 部分功能计划受限：Deals 相关报告、任务审计、保存回复审计、B2B 账户审计需要 ActiveCampaign Plus 或更高版本
- 参与度数据不完整：
messageActivities端点在某些计划中不可用，相关报告自动回退到点击数据（无打开事件） - Python 环境依赖：需要本地 Python 3 运行时
- 初始校准耗时：首次使用需执行
calibrate.py扫描账户，建立基准数据
适合人群
- 日活跃用户数 1K-500K 的中小型企业营销运营团队
- 需要数据驱动决策、厌倦手动导表分析的增长负责人
- 同时负责营销自动化和销售管道管理的「营销-销售混合」角色
- 对数据驻留有严格要求、偏好本地优先（local-first）工具的安全敏感型组织
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| API 令牌泄露 | `AC_API_TOKEN` 具备账户访问权限 | 使用专用集成用户（非管理员），限制最小权限；定期轮换 |
| 误删数据 | 标签合并、字段删除等操作不可逆 | 所有删除需二次确认；优先使用「标记抑制」替代物理删除 |
| 速率限制触发 | 默认 5 req/s，超限会 429 | 内置 `_ac_client.py` 带指数退避 |
| 本地文件权限 | `state.json` 含账户结构元数据 | 强制 0600 权限，建议启用全盘加密 |
| 计划功能误判 | 某些脚本因计划层级返回空结果 | 运行前检查 `state.json` 中的账户能力标记 |