Agent Analytics

Agent Analytics 是一款面向 AI Agent 的产品分析技能，通过官方 CLI 提供埋点管理、漏斗分析、路径追踪、留存计算与实验评估能力。核心优势在于将复杂的产品分析工作流封装为结构化命令，支持从项目创建、授权登录到诊断建议的完整闭环；强调"最小可行追踪"原则，避免过度埋点，并内置 context 机制实现跨会话记忆。

显著优点：1) CLI 优先的执行策略确保可复现与版本锁定；2) 项目-表面-组合三层架构适配多域名、多客户端场景；3) 强制浏览器授权（Browser Approval）降低 API 密钥泄露风险，同时提供 Detached 模式支持 Paperclip、OpenClaw 等托管运行时；4) 内置实验因果推断与样本量评估，避免常见相关性谬误。

潜在局限：1) 依赖 npx 与 Node.js 环境，轻量容器或无网络环境受限；2) 免费版存在读取上限，关键诊断可能触发 PRO_REQUIRED 阻断；3) 跨项目身份打通需额外配置 portfolio 与 data-link-domains，默认不自动关联；4) 对非技术用户而言，CLI 交互门槛高于可视化 BI 工具。

适合人群：产品经理、增长工程师、数据分析师及具备终端操作能力的创业团队，尤其适合已采用代码优先（code-first）工作流、追求可审计分析路径的组织。

常规风险：需妥善管理 .openclaw/agent-analytics/config.json 等持久化凭证，避免提交至版本控制；Detached 登录模式的 finish-code 存在短暂窗口期的社交工程风险；CLI 版本锁定（0.5.31）与技能版本（4.0.32）分离，需关注兼容性更新。

核心用法

Agent Analytics 是一款面向AI Agent设计的产品分析技能，通过官方CLI工具实现全链路数据洞察。核心工作流包括：

1. 项目与追踪设置

• 使用 npx --yes @agent-analytics/cli@0.5.31 执行固定版本CLI命令
• 浏览器OAuth认证（默认）或detached模式（headless环境）
• 创建项目时绑定域名，安装追踪代码片段
• 基于用户同意的最小化事件追踪，避免重复采集自动信号

2. 分析能力矩阵

• 漏斗分析：funnel 命令诊断激活路径泄漏，支持严格幸存者分析
• 路径洞察：paths 与 journey 还原会话内用户轨迹
• 留存计算：retention 按队列分析，避免混合活跃用户误导
• 实验评估：experiments 结合业务目标事件判断keep/change/stop
• 上下文记忆：context get/set 存储产品目标、激活定义、事件词典

3. 增长决策框架
采用"诊断-度量-证据-细分- caveat-行动"六步回答契约，优先推荐单一窄域实验，避免因果混淆与过度解读相关性。

显著优点

• Agent原生设计：专为Claude Code、Codex、Cursor等AI编程工具优化，支持上下文持久化
• 固定版本安全：CLI锁定0.5.31版本，降低供应链攻击风险
• 隐私优先架构：显式用户同意机制、最小权限追踪、PII不入上下文
• 项目-表面-组合三层模型：清晰界定单产品分析、多表面整合、跨项目身份关联的边界
• 结构化输出：query命令补充固定命令的聚合盲区，避免随意构造过滤条件

潜在局限

• 付费墙限制：Pro功能需升级，免费层存在读取上限
• 外部依赖重：核心功能依赖npx下载与agentanalytics.sh云服务，离线不可用
• 网络暴露面：所有分析数据外传至第三方SaaS，敏感行业需合规评估
• CLI版本耦合：技能逻辑与CLI 0.5.31深度绑定，升级需同步更新
• 实验设计门槛：正确的因果推断仍需用户具备样本量、混淆因素等统计学知识

适合人群

• 增长产品经理：需快速诊断激活/留存瓶颈，制定数据实验
• 全栈开发者：在AI编程环境中直接获取产品洞察，无需切换Dashboard
• 数据分析师：偏好CLI工作流，需将分析结论写入代码注释或PR描述
• 初创团队：寻求轻量级、 consent-based 的追踪方案，避免过度工程

常规风险

• 数据主权风险：产品行为数据存储于Agent Analytics云服务，跨境业务需确认数据中心位置
• OAuth令牌管理：.openclaw/agent-analytics/config.json 含敏感凭证，需防git误提交
• 过度追踪陷阱：技能明确警告勿为自动信号（页面浏览、设备信息）创建重复事件
• 因果误读：技能内置 skepticism 指南，但用户仍需警惕"实验组转化率上升=实验成功"的简化思维
• 供应链风险：npx执行路径虽版本固定，仍依赖npm registry可用性与包完整性