用途：分析游戏数据指标，追踪玩家行为并优化性能，处理游戏日志、会话和指标。适用于开发期处理游戏内数据，例如识别关卡玩家流失、优化资源占用或调试实时多人游戏的性能瓶颈。
主要能力：解析 JSON 格式游戏日志，提取会话时长、玩家动作等指标（如 claw game-analytics parse --input logs.json）；生成行为追踪报告，如玩家移动热力图（GET /api/analytics/reports/heatmap?gameId=123）；执行优化查询，支持类 SQL 过滤（YAML 配置 metrics: [latency > 500ms]）；可集成 ML 模型做预测分析，如基于游玩模式预测流失（claw game-analytics predict --model churn.json）。
使用方式：需先通过环境变量 $GAME_ANALYTICS_API_KEY 完成认证。CLI 在含游戏数据文件的项目目录中运行；代码中可作为模块导入直接调用函数；大数据集建议用异步模式避免阻塞。常用命令如 claw game-analytics analyze --file data.json --metric player-session --output report.csv；API 端点 POST /api/analytics/track，请求体含 event 与 data，使用 Bearer token 认证。Python 示例：import claw 后调用 claw.analytics.track(event='level_complete', data={'level': 5}, api_key=api_key)。Node.js 中 require('claw') 并设置 key 后调用 analyze。YAML 配置可用 claw game-analytics load-config config.yaml 加载。Web 应用可用 OAuth：claw game-analytics auth --provider google。
错误处理：CLI 检查退出码（401 表示认证失败，可用 claw game-analytics retry --command analyze 重试）；API 调用捕获 HTTP 错误，403 时提示重置 $GAME_ANALYTICS_API_KEY；代码中用 try-except 捕获 claw.AnalyticsError，如 AUTH_FAILED 时提示设置密钥后重试。处理前应校验输入，确保 JSON 格式正确。
限制：仅支持 JSON 输入格式；需有效 API 密钥；集群集成需加前缀，如 claw game-dev game-analytics analyze。相关技能包括 game-dev（父级）、player-tracking（依赖）、data-metrics（同级），并与 game-logging、performance-optimization 连接。