核心用法
Agent Analytics 是一款专为 AI Agent 设计的端到端分析工具，通过官方 CLI (npx --yes @agent-analytics/cli@0.5.21) 实现完整的增长分析工作流。核心能力涵盖：
项目管理：创建/更新项目、配置允许域名、管理多项目组合
事件追踪：自动捕获页面浏览、来源、UTM、设备/浏览器、会话等数据，支持自定义事件通过 data-aa-event 属性或 window.aa.track() API
查询分析：固定命令（stats、insights、events、breakdown、funnel、retention、paths）覆盖大部分场景，高级场景使用 query 配合 JSON 过滤器
实验管理：完整的 A/B 测试生命周期，支持多变量与目标事件配置
智能扫描：scan 命令分析网站后输出 minimum_viable_instrumentation 建议，指导优先追踪高价值事件而非泛化埋点
显著优点
1. Agent 原生设计：无需仪表盘，全程对话式完成分析-洞察-行动闭环
2. 分析优先策略：强制先执行网站扫描识别数据盲区，再针对性埋点，避免过度追踪
3. 多运行时适配：支持浏览器授权、分离式授权（--detached，适用于 OpenClaw/Paperclip 等问题驱动环境）、MCP 及 API 多种接入方式
4. 上下文记忆：context get/set 实现项目级持久化配置，存储激活定义、业务目标、事件 glossary，支持跨会话智能累积
5. 子代理委派：官方推荐按表面（homepage/scanner/onboarding/docs）拆分并行审计，父代理合成增长赌注与测量缺口
6. 中文支持：完整中文文档与 OpenClaw 专属指南
潜在缺点与局限性
- 功能分级限制：漏斗、留存、会话路径、热图、实时读取等高级功能需 Pro 付费（免费版 10 万事件/月，2 项目）
- 查询分组受限：
group_by仅支持内置字段（event/date/user_id/session_id/country），不支持按任意属性分组 - 时间精度限制：不支持
24h等小时级简写，精确到小时的分析需手动构建时间戳过滤器 - CLI 版本锁定：强制使用固定版本
0.5.21，未来版本更新需手动迁移 - 浏览器回调依赖：非分离式登录需要本地浏览器回调，部分容器环境受限
适合人群
- 增长团队：需要快速诊断多表面转化瓶颈、迭代实验
- AI Agent 开发者：构建闭环自主分析能力，如自动化增长审计、实时监控告警
- 中国团队/OpenClaw 用户：中文文档与 issue 工作流优化
- 多项目管理者：批量跨项目分析，避免逐仪表盘手动操作
常规风险
- 过度追踪风险：虽文档强调"分析优先"，但新手仍可能忽略扫描建议直接泛化埋点
- 敏感数据暴露：
context set有 8KB 限制，需避免存储 PII、密钥；配置目录应加入.gitignore - 授权流转风险：分离式登录需妥善传递 finish code，避免会话混淆
- Pro 升级中断：分析中途遇
PRO_REQUIRED需人工支付确认，无法完全自动化