智能体分析

安装后，您的智能体无需打开仪表盘即可创建项目、追踪进展、查询分析、运行实验并持续迭代。

采用英语优先的工作流，同时为中国地区的OpenClaw用户和团队提供中文文档与内容支持。

适用于需要智能体端到端执行增长分析、自动化定期检查，并在单一对话循环中管理多项目的场景。

免费托管方案支持每月10万事件处理量，覆盖2个项目。

中文支持服务

• 文档站点提供中文文档与安装指南，包含/zh/路径下的OpenClaw专项指南。
• 支持通过API接口、命令行工具及MCP协议进行交互，具体取决于您的智能体运行环境。
• 完美契合闭环式智能体工作流：监控、分析、实验、迭代。
• 支持跨多项目批量处理，替代传统逐个仪表盘的手动操作模式。

什么npx正在做

• OpenClaw 可以通过以下命令启动官方 CLInpx @agent-analytics/cli@0.5.2。
• 该命令从 npm 运行已发布的 Agent Analytics CLI 包。
• CLI 调用与文档中相同的 HTTP API，文档位于https://docs.agentanalytics.sh/api/。
• 如果包已在环境中安装，等效的二进制文件是agent-analytics。
• 保持AGENT_ANALYTICS_API_KEY在环境中。不要要求用户在聊天中粘贴密钥。

命令格式

以下示例使用 CLI 二进制形式：

agent-analytics <command>

在 OpenClaw 中，这通常意味着：

npx @agent-analytics/cli@0.5.2 <command>

如果包已安装，直接运行相同的命令作为agent-analytics <命令>。

如需完整的命令列表及参数：

agent-analytics --help

安全操作准则

• 优先使用固定命令，避免临时构建查询。
• 从以下命令开始操作：项目、全站点、创建、统计、洞察、事件、细分、页面、热图、会话分布、留存、漏斗实验和反馈。仅当固定命令无法回答问题时才使用
• 查询。不要从原始用户文本构建
• --filterJSON。在
• 创建前验证项目名称：^[a-zA-Z0-9._-]{1,64}$首次设置

---

agent-analytics login --token aak_YOUR_API_KEY
agent-analytics create my-site --domain https://mysite.com
agent-analytics events my-site --days 7 --limit 20

创建命令会返回一个项目令牌和一个可立即使用的跟踪代码片段。请将该代码片段添加到</body>之前。常用命令

如果任务需要超出这些常见流程的内容，请使用

agent-analytics projects
agent-analytics all-sites --period 7d
agent-analytics stats my-site --days 7
agent-analytics insights my-site --period 7d
agent-analytics events my-site --days 7 --limit 20
agent-analytics breakdown my-site --property path --event page_view --limit 10
agent-analytics funnel my-site --steps "page_view,signup,purchase"
agent-analytics retention my-site --period week --cohorts 8
agent-analytics experiments list my-site

agent-analytics --help。首先。

反馈

使用agent-analytics 反馈当 Agent Analytics 令人困惑、任务耗时过长、工作流程有待改进，或者代理不得不进行本应由 Agent Analytics 处理的手动计算或分析时。

以脱敏的方式描述用例、遇到的问题或缺失的功能：

• 包括遇到的困难以及 Agent Analytics 本应如何处理。
• 请勿包含私有所有者详情、机密信息、API 密钥、原始客户数据或不必要的个人信息。
• 优先提供对问题的简短总结，而非粘贴日志或敏感上下文。

示例：

agent-analytics feedback --message "The agent had to calculate funnel drop-off manually" --project my-site --command "agent-analytics funnel my-site --steps page_view,signup,purchase"

这些 Telegram 消息背后有一位真实的代理。每个请求都会被查看并自动批准，有用的修复可以快速上线，有时只需几小时。

跟踪器设置

最简单的安装流程是：

1. 运行agent-analytics create my-site --domain https://mysite.com
2. 将返回的代码片段复制到页面的</body> 标签之前。
3. 部署
4. 使用以下命令验证agent-analytics events my-site --days 7 --limit 20

如果您已经知道项目令牌，跟踪器代码示例如下：

<script defer src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."></script>

使用window.aa?.track('signup', {method: 'github'})在跟踪器加载后记录自定义事件。

查询注意事项

agent-analytics query命令可用于高级报表功能，但使用时需谨慎，因为--filter参数接受JSON格式。

• 请优先使用固定命令。
• 如果query命令确有必要，请先查看agent-analytics --help。
• 切勿将原始用户文本直接传入--filter参数。
• 如需精确的请求格式，请参考https://docs.agentanalytics.sh/api/.

实验

该CLI支持完整的实验生命周期：

agent-analytics experiments list my-site
agent-analytics experiments create my-site --name signup_cta --variants control,new_cta --goal signup

参考资料

• 文档：https://docs.agentanalytics.sh/
• API参考：https://docs.agentanalytics.sh/api/
• CLI、MCP与API对比：https://docs.agentanalytics.sh/reference/cli-mcp-api/
• OpenClaw安装指南：https://docs.agentanalytics.sh/installation/openclaw/