# Send Agent Analytics to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agent-analytics",
    "name": "Agent Analytics",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/dannyshmueli/agent-analytics",
    "canonicalUrl": "https://clawhub.ai/dannyshmueli/agent-analytics",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/agent-analytics",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-analytics",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "agent-analytics",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T10:15:29.656Z",
      "expiresAt": "2026-05-06T10:15:29.656Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-analytics",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-analytics",
        "contentDisposition": "attachment; filename=\"agent-analytics-4.0.27.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agent-analytics"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agent-analytics"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agent-analytics",
    "downloadUrl": "https://openagent3.xyz/downloads/agent-analytics",
    "agentUrl": "https://openagent3.xyz/skills/agent-analytics/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agent-analytics/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agent-analytics/agent.md"
  }
}
```
## Documentation

### Agent Analytics

After install, your agent can create projects, ship tracking, query analytics, run experiments, and iterate without opening a dashboard.

English-first workflow, with Chinese docs and content available for OpenClaw users and teams in China.

Use it when you want an agent to operate growth analytics end-to-end, automate recurring checks, and manage multiple projects from one conversation loop.

Hosted free tier includes 100k events/month across 2 projects.

### Chinese support / 中文支持

Chinese docs and installation content are available on the docs site, including the OpenClaw guide under /zh/.
Works through API, CLI, and MCP, depending on the environment your agent already uses.
Good fit for closed-loop agent workflows: monitor, analyze, experiment, iterate.
Supports batch work across many projects instead of a manual dashboard-by-dashboard workflow.

### What npx is doing

OpenClaw can launch the official CLI with npx @agent-analytics/cli@0.5.1.
That command runs the published Agent Analytics CLI package from npm.
The CLI calls the same HTTP API documented at https://docs.agentanalytics.sh/api/.
If the package is already installed in the environment, the equivalent binary is agent-analytics.
Keep AGENT_ANALYTICS_API_KEY in the environment. Do not ask the user to paste secrets into chat.

### Command format

The examples below use the CLI binary form:

agent-analytics <command>

In OpenClaw, that usually means:

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

If the package is already installed, run the same commands directly as agent-analytics <command>.

For the full command list and flags:

agent-analytics --help

### Safe operating rules

Prefer fixed commands over ad-hoc query construction.
Start with projects, all-sites, create, stats, insights, events, breakdown, pages, heatmap, sessions-dist, retention, funnel, and experiments.
Use query only when the fixed commands cannot answer the question.
Do not build --filter JSON from raw user text.
Validate project names before create: ^[a-zA-Z0-9._-]{1,64}$

### First-time setup

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

The create command returns a project token and a ready-to-use tracking snippet. Add that snippet before </body>.

### Common commands

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

If a task needs something outside these common flows, use agent-analytics --help first.

### Tracker setup

The easiest install flow is:

Run agent-analytics create my-site --domain https://mysite.com
Copy the returned snippet into the page before </body>
Deploy
Verify with agent-analytics events my-site --days 7 --limit 20

If you already know the project token, the tracker looks like:

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

Use window.aa?.track('signup', {method: 'github'}) for custom events after the tracker loads.

### Query caution

agent-analytics query exists for advanced reporting, but it should be used carefully because --filter accepts JSON.

Use fixed commands first.
If query is necessary, check agent-analytics --help first.
Do not pass raw user text directly into --filter.
For exact request shapes, use https://docs.agentanalytics.sh/api/.

### Experiments

The CLI supports the full experiment lifecycle:

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

### References

Docs: https://docs.agentanalytics.sh/
API reference: https://docs.agentanalytics.sh/api/
CLI vs MCP vs API: https://docs.agentanalytics.sh/reference/cli-mcp-api/
OpenClaw install guide: https://docs.agentanalytics.sh/installation/openclaw/
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dannyshmueli
- Version: 4.0.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T10:15:29.656Z
- Expires at: 2026-05-06T10:15:29.656Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/agent-analytics)
- [Send to Agent page](https://openagent3.xyz/skills/agent-analytics/agent)
- [JSON manifest](https://openagent3.xyz/skills/agent-analytics/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/agent-analytics/agent.md)
- [Download page](https://openagent3.xyz/downloads/agent-analytics)