核心用法
Agent Analytics 是一款专为AI Agent设计的CLI优先分析工具，通过npx @agent-analytics/cli@0.5.16命令即可完整操作。核心能力包括：
1. 智能分析先行：scan命令自动分析网站结构，输出minimum_viable_instrumentation推荐，避免过度追踪
2. 闭环工作流：项目创建→追踪代码部署→事件验证→查询分析→实验迭代，全程命令行完成
3. 多维度分析：内置stats、insights、breakdown、funnel、retention、paths等固定命令，覆盖流量、转化、留存、用户路径全场景
4. A/B实验管理：支持实验创建、变体配置、目标事件绑定和结果追踪
显著优点
- Agent原生设计：English-first工作流，支持OpenClaw等托管运行时的分离式认证（
--detached），无需API Key即可浏览器授权 - 分析优先策略：拒绝猜测式埋点，
scan输出明确告知每个事件解锁的分析能力 - 多项目批量操作：
projects列出所有项目后循环查询，适合代理自动化跨项目报表 - 开源透明：CLI完全开源（MIT），100k事件/月的免费托管层
- 中文支持：文档和安装指南提供中文版本
潜在局限
- 时间粒度限制：API不支持
24h小时级简写，精确到小时的查询需手动构建时间戳JSON filter - 属性分组受限：
group_by仅支持内置字段（event/date/user_id/session_id/country），无法按任意properties.*字段分组，需反馈请求而非手动实现 - 复杂filter风险：
--filter接受原始JSON，存在注入和构造错误风险，文档明确禁止直接传递用户原始文本 - MCP/HTTP非主流路径：官方强制CLI优先，其他传输方式需用户显式请求
适合人群
- 需要闭环自动化分析的Agent开发者和增长团队
- 运营多项目矩阵、厌倦逐个仪表盘切换的工程师
- 追求最小可行埋点、拒绝数据垃圾的精益团队
- 使用OpenClaw、Codex等托管Agent运行环境的用户
常规风险
- 认证安全：需正确配置
AGENT_ANALYTICS_CONFIG_DIR避免凭证泄漏，.openclaw/目录必须gitignore - 版本锁定：强制
@0.5.16精确版本，避免自动升级带来的行为漂移 - filter构造：手动JSON filter易出错，优先使用固定命令
- 会话边界误解：
paths命令仅限单会话内路径，不适用于跨会话归因分析