核心用法
Agent Analytics 是一款面向AI代理的产品分析技能，通过官方CLI实现免API密钥的浏览器授权登录。核心工作流包括：1）项目/表面/组合三层架构分类；2）基于同意授权的追踪器安装；3）使用固定命令（funnel、retention、paths、experiments等）诊断激活流失与实验效果；4）通过context get/set维护产品上下文记忆。
显著优点
代理原生设计：专为Claude Code、Cursor、Codex等AI编码环境设计，支持正常浏览器授权与分离式授权两种登录模式，适配Paperclip、OpenClaw等无头运行时。免密钥架构：标准工作流无需API密钥，降低凭证泄露风险。结构化分析框架：强制遵循「最佳判断→指标定义→证据→细分→ caveat→下一步」的回答契约，避免数据堆砌。上下文自改进：context命令保存激活事件定义、目标、术语表和产品变更标注，使后续分析更智能。实验友好：支持A/B测试读取、样本量检查、因果推断边界说明。
潜在局限
功能受限：免费版存在读取上限，Pro功能需付费升级；无内置report命令，需手动聚合输出。学习曲线：项目/表面/组合的三层架构、分离式授权流程、JSON格式的--steps-json参数对非技术用户有门槛。浏览器依赖：标准登录依赖浏览器回调，无头环境需切换至分离模式。网络要求：依赖npx和npm registry，离线环境不可用。数据边界：跨项目身份打通需额外配置data-link-domains和组合会员关系，否则无法追踪严格用户转化。
适合人群
- 使用AI编码工具（Cursor、Claude Code、Codex）的产品经理和增长工程师
- 需要快速诊断激活漏斗、留存 cohort、实验读数的SaaS团队
- 遵循隐私优先、同意授权模式的合规敏感型产品
- 熟悉命令行、JSON配置的技术用户
常规风险
授权会话泄露：分离式授权模式下若将.openclaw/agent-analytics/config.json误提交至版本控制，可能导致会话劫持。过度追踪：安装指引明确禁止为自动信号（页面浏览、UTM、设备信息）添加重复自定义事件，但执行依赖用户自律。指标误读：文档反复强调「注册≠激活」「相关≠因果」，但AI代理可能因提示工程不足而输出错误结论。Pro功能误期望：免费版遇到PRO_REQUIRED时需升级，代理需正确执行upgrade-link流程而非静默失败。跨项目身份幻觉：未配置组合时声称「用户从营销站转化至应用」属于错误断言。