Amplitude

核心用法

amplitude-analytics 是一款面向产品数据分析的 OpenClaw 技能，通过 ClawLink 托管连接实现与 Amplitude Analytics API 的安全集成。用户无需手动配置 API 密钥，仅需三步即可完成账号配对与授权：安装插件、设备配对、连接 Amplitude。

该技能提供六大核心功能模块：

• 事件分析：事件列表查询、事件细分（segmentation）、漏斗分析、留存分析、LTV 收入指标
• 用户与活动：用户搜索、用户活动流、活跃用户统计（含实时）、用户属性构成分析
• 分群管理：分群列表、分群详情查看与下载、分群上传更新
• 注解与发布：图表注解的增删查、产品发布记录
• 会话与互动：平均会话时长、会话时长分布、人均会话数
• 用户管理：用户属性更新、GDPR/CCPA 删除请求、用户身份映射

所有工具调用均通过 clawlink_call_tool 执行，支持 describe_tool 预查询参数结构与 preview_tool 变更预览，确保操作可控。

显著优点

1. 零配置接入：ClawLink 托管 API 密钥，用户无需处理密钥存储与注入，降低安全风险与使用门槛。
2. 完整分析能力：覆盖 Amplitude 核心 Analytics API 能力，包括事件细分、漏斗、留存、实时活跃等高级分析场景。
3. 读写分离的安全设计：所有写操作（创建注解、上传分群、删除用户等）强制要求用户确认，避免误操作。
4. 实时与批量兼顾：既支持实时活跃用户数查询，也支持大规模分群异步导出与轮询下载。
5. 合规支持：内置 GDPR/CCPA 用户删除请求接口，满足数据合规需求。

潜在缺点与局限性

• 依赖 ClawLink 服务：API 调用需经 ClawLink 代理中转，若 ClawLink 服务不可用则技能失效，存在单点依赖。
• 数据延迟：事件数据通常有分钟至小时级延迟，不适用于毫秒级实时决策场景。
• 异步操作复杂度：分群下载等操作需轮询状态，增加了调用链路复杂度。
• 权限边界模糊：文档未明确说明是否支持多项目切换或细粒度角色权限控制。
• EU 数据驻留需额外配置：涉及欧盟数据需确保项目已配置对应数据驻留规则，否则可能合规风险。

适合人群

• 产品经理与数据分析师：快速查询产品核心指标、构建漏斗与留存分析
• 增长运营：管理用户分群、追踪发布效果与注解标记
• 工程团队：批量处理用户属性更新、执行合规删除请求
• 需要免运维 API 集成的中小型团队

常规风险

• 误操作风险：写操作需强制确认，但用户若未仔细核对预览内容，仍可能导致分群覆盖或注解误删。
• 数据隐私风险：用户行为数据经 ClawLink 代理传输，需信任 ClawLink 的数据处理与存储安全。
• GDPR 不可逆操作：用户删除请求一旦提交无法撤销，需严格审核。
• 连接失效风险：API 密钥过期或项目权限变更会导致连接中断，需引导用户重新授权。

核心用法

Amplitude Analytics Skill 是一个纯文档型集成技能，通过 ClawLink 托管代理安全连接 Amplitude 产品分析平台。用户无需在对话中配置或暴露任何 API 凭证，即可完成从事件查询到用户分群管理的完整分析工作流。

该技能采用读取优先、写入确认的双层操作模式。对于安全的数据查询操作（如事件统计、活跃用户查看、漏斗分析），可直接调用工具获取结果；对于任何写入操作（创建标注、上传分群、删除用户数据），系统强制要求通过 clawlink_preview_tool 预览变更，经用户显式确认后方可执行。

典型工作流包括：通过 clawlink_list_integrations 验证连接状态，使用 amplitude_list_events 浏览可用事件类型，调用 amplitude_get_event_segmentation 获取细分数据，或利用 amplitude_get_funnel_data 分析转化漏斗。对于用户研究场景，可结合 amplitude_find_user 与 amplitude_get_user_activity 进行个体行为深度洞察。

显著优点

安全架构领先：采用 ClawLink 托管凭证模式，API 密钥由专用服务安全存储和注入，Skill 本身为零凭证接触设计，从根本上杜绝密钥泄露风险。

功能覆盖全面：涵盖事件分析、用户分群、留存计算、LTV 追踪、实时活跃用户、会话分析等 Amplitude 核心能力，支持产品、运营、数据团队的多样化分析需求。

合规性内置：文档明确声明 GDPR/CCPA 数据删除规范，用户删除请求 (amplitude_delete_users) 等敏感操作遵循不可逆确认机制，满足企业合规审计要求。

零配置上手：三步完成集成安装，无需理解 Amplitude API 的认证细节或构造复杂请求，自然语言即可驱动专业级分析查询。

潜在缺点与局限性

依赖外部服务稳定性：实际 API 调用由 ClawLink 插件代理执行，若 ClawLink 服务或网络连接异常，将直接影响技能可用性。

异步操作复杂性：用户分群下载 (amplitude_download_cohort_file) 为异步流程，需轮询状态后再获取结果，增加了多步骤调用的复杂度。

数据延迟客观存在：文档明确提示事件数据可能存在分钟至小时的延迟，不适合实时性要求极高的场景。

权限边界限制：访问范围严格限定于已连接的 Amplitude 项目，无法跨项目分析，且需预先在 Amplitude 控制台完成项目授权。

纯文档型架构限制：作为 T-MD 分类技能，本身不含可执行代码，所有功能依赖 ClawLink 插件的实现质量，若插件更新滞后可能产生功能缺口。

适合的目标群体

• 产品经理：快速获取功能使用数据、追踪发布效果、创建版本标注
• 数据分析师：执行探索性分析、构建用户分群、计算留存与 LTV 指标
• 增长运营：监控实时活跃用户、分析转化漏斗、优化用户旅程
• 技术负责人：在不暴露 API 凭证的前提下，为团队提供安全的自助分析能力

使用风险

性能风险：部分分析查询可能返回大规模数据集，建议配合时间范围过滤和分页参数使用，避免超时或内存压力。

依赖项风险：ClawLink 插件为必要依赖，需确保 openclaw plugins install clawhub:clawlink-plugin 正确安装且版本兼容，网关重启后需发送 /new 刷新工具目录。

操作不可逆风险：GDPR/CCPA 用户删除请求一旦提交不可撤销，务必在预览阶段仔细核对目标用户标识；分群上传和用户身份映射操作会影响下游分析 segmentation，需谨慎执行。

连接状态风险：若 Amplitude 集成显示异常或工具不可见，可能需要重新走完整连接流程（dashboard 授权 + 验证集成列表），中断分析工作流。