# Send clawdio 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": "clawdio",
    "name": "clawdio",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/benschiller/clawdio",
    "canonicalUrl": "https://clawhub.ai/benschiller/clawdio",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/clawdio",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdio",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "clawdio",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T19:00:54.424Z",
      "expiresAt": "2026-05-11T19:00:54.424Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdio",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawdio",
        "contentDisposition": "attachment; filename=\"clawdio-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "clawdio"
      },
      "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/clawdio"
    },
    "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/clawdio",
    "downloadUrl": "https://openagent3.xyz/downloads/clawdio",
    "agentUrl": "https://openagent3.xyz/skills/clawdio/agent",
    "manifestUrl": "https://openagent3.xyz/skills/clawdio/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/clawdio/agent.md"
  }
}
```
## Documentation

### Clawdio — Auditory Intelligence for AI Agents

Clawdio, powered by VAIL (Voice AI Layer), gives AI agents auditory perception by transforming long-form human audio into structured data, semantic reports, and machine-readable markdown.

Agents interact with an x402 payment-gated API to ingest spoken conversations as first-class inputs — just like text, price feeds, or alternative data sources.

Initial deployment focuses on AI and Crypto Twitter Spaces, where high-signal market intelligence exists primarily in voice.

Base URL: https://clawdio.vail.report
Protocol: x402
Network: Base Mainnet (eip155:8453)
Currency: USDC
Price: $1.49 per report

### Requirements

You need an x402-compatible wallet funded with USDC on Base Mainnet. Compatible wallet providers include:

Coinbase AgentKit with x402ActionProvider()
Coinbase CDP SDK with CdpEvmWalletProvider
Any wallet that supports the x402 protocol

The x402 payment is handled automatically via the PAYMENT-SIGNATURE header — your wallet provider manages the signing and settlement. You do not need to construct payment transactions manually.

### Step 1: Understand the API

Visit the API root to get a self-describing overview:

curl https://clawdio.vail.report/

This returns the full API description, available endpoints, pricing, and purchase flow instructions.

### Step 2: Browse the Catalog (Free)

curl https://clawdio.vail.report/catalog

No payment or authentication required. Returns all available products with metadata:

{
  "products": [
    {
      "id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
      "title": "AI & Crypto Twitter Space",
      "abstract": "Analysis of a discussion covering...",
      "date": "2025-01-15",
      "length": "01:23:45",
      "listeners": 1234,
      "purchase": {
        "url": "https://clawdio.vail.report/catalog/purchase?id=c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
        "method": "GET",
        "protocol": "x402",
        "price": "1.49 USDC"
      }
    }
  ],
  "total": 15,
  "purchase_instructions": {
    "steps": [
      "Select a product from the list above",
      "Make an HTTP GET request to the product's purchase.url",
      "Your x402-compatible wallet handles payment automatically",
      "You receive the full artifact set (metadata + report + transcript)"
    ],
    "important": "The purchase endpoint uses GET, not POST. Save the artifacts — repurchase is required for repeat access."
  }
}

### Step 3: Purchase a Report ($1.49 USDC)

curl https://clawdio.vail.report/catalog/purchase?id={uuid}

Important: This is a GET request, not POST.

On first request without payment, the server returns HTTP 402 Payment Required with a PAYMENT-REQUIRED header. Your x402 wallet automatically:

Reads the payment requirements from the 402 response
Signs a USDC payment on Base Mainnet
Retries the request with the PAYMENT-SIGNATURE header
Receives the full content after payment settles

### What You Get

Each purchase returns a JSON object with three artifact layers (metadata + report + transcript):

{
  "id": "c6d36398-a0c8-4c21-9aa4-1d1d9084a820",
  "transaction": "0x1234...abcd",
  "title": "AI & Crypto Twitter Space",
  "date": "2025-01-15",
  "length": "01:23:45",
  "listeners": 1234,
  "participants": {
    "hosts": [
      {
        "display_name": "Host Name",
        "screen_name": "host_handle",
        "avatar_url": "https://..."
      }
    ],
    "speakers": [
      {
        "display_name": "Speaker Name",
        "screen_name": "speaker_handle",
        "avatar_url": "https://..."
      }
    ]
  },
  "content": {
    "report": {
      "format": "markdown",
      "content": "## Abstract\\n\\nAnalysis of the Twitter Space...\\n\\n## Key Insights\\n\\n- ...\\n\\n## Hot Takes\\n\\n> \\"Quote\\" — **Speaker** (timestamp)\\n\\n## Timeline\\n\\n- ...\\n\\n## Potential Alpha\\n\\n- ...\\n\\n## Market Sentiment\\n\\n**Overall:** Bullish\\n\\n## Project Mentions\\n\\n- **Project**: Context"
    },
    "transcript": {
      "format": "markdown",
      "content": "# Transcript\\n\\n**Speaker 1** [00:01:26 - 00:01:49]\\n> Spoken text here...\\n\\n**Speaker 2** [00:01:50 - 00:02:15]\\n> Response text here..."
    }
  }
}

Artifact 1 — Metadata: Title, date, duration, listener count, full participant list with Twitter handles and avatars.

Artifact 2 — Report (Markdown): Structured analysis including abstract, key insights, hot takes with attribution, timeline of events, potential alpha, market sentiment, and project mentions.

Artifact 3 — Transcript (Markdown): Full speaker-attributed transcript with timestamps. Every utterance has speaker name, timestamp range, and verbatim content.

### Report Schema

The report markdown contains these sections (when available):

SectionDescriptionAbstractSummary paragraphs of the entire SpaceKey InsightsBullet list of the most important takeawaysHot TakesNotable quotes with speaker attribution and timestampsTimelineChronological events with significance notesPotential AlphaActionable intelligence and forward-looking signalsMarket SentimentOverall sentiment assessment with notesProject MentionsNamed projects/tokens discussed with context

### Complete Purchase Flow

Agent                          Clawdio                      Facilitator
  |                               |                              |
  |  GET /catalog                 |                              |
  |------------------------------>|                              |
  |  200 OK (product list)        |                              |
  |<------------------------------|                              |
  |                               |                              |
  |  GET /catalog/purchase?id=... |                              |
  |------------------------------>|                              |
  |  402 Payment Required         |                              |
  |  (PAYMENT-REQUIRED header)    |                              |
  |<------------------------------|                              |
  |                               |                              |
  |  [wallet signs USDC payment]  |                              |
  |                               |                              |
  |  GET /catalog/purchase?id=... |                              |
  |  (PAYMENT-SIGNATURE header)   |                              |
  |------------------------------>|                              |
  |                               |  verify + settle payment     |
  |                               |----------------------------->|
  |                               |  settlement confirmation     |
  |                               |<-----------------------------|
  |  200 OK                       |                              |
  |  (full artifacts + tx hash)   |                              |
  |<------------------------------|                              |

### Endpoints

EndpointMethodAuthDescription/GETNoneSelf-describing API root with full documentation/catalogGETNoneBrowse all available products with metadata/catalog/purchase?id={uuid}GETx402Purchase full artifacts ($1.49 USDC)/healthGETNoneHealth check/.well-known/x402GETNonex402 discovery document

### Using with Coinbase AgentKit

If you use Coinbase AgentKit, the x402 payment flow is fully automatic:

import { AgentKit, CdpEvmWalletProvider, walletActionProvider, x402ActionProvider } from "@coinbase/agentkit";

const walletProvider = await CdpEvmWalletProvider.configureWithWallet({
  apiKeyId: process.env.CDP_API_KEY_ID,
  apiKeySecret: process.env.CDP_API_KEY_SECRET,
  walletSecret: process.env.CDP_WALLET_SECRET,
  address: YOUR_WALLET_ADDRESS,
  networkId: "base-mainnet",
});

const agentKit = await AgentKit.from({
  walletProvider,
  actionProviders: [walletActionProvider(), x402ActionProvider()],
});

// The agent can now browse and purchase from Clawdio automatically.
// Point it at https://clawdio.vail.report/ and it will self-discover the API.

### Using with @x402/fetch

For direct programmatic access without AgentKit:

import { wrapFetch } from "@x402/fetch";

const x402Fetch = wrapFetch(globalThis.fetch, walletClient);

// Browse catalog (free)
const catalog = await fetch("https://clawdio.vail.report/catalog").then(r => r.json());

// Purchase a report (x402 handles payment automatically)
const report = await x402Fetch("https://clawdio.vail.report/catalog/purchase?id={uuid}")
  .then(r => r.json());

### Important Notes

GET not POST: The purchase endpoint uses GET. Do not send POST requests.
Base Mainnet only: Payment is in USDC on Base Mainnet (eip155:8453).
Save your purchase: Artifacts are not stored for you. Repurchase is required for repeat access.
No authentication: There are no API keys or accounts. Payment is the only gate.

### Ideas for Agents

Market intelligence: Analyze hot takes and sentiment for trading signals
Research synthesis: Cross-reference insights across multiple Spaces
Alpha extraction: Mine potential alpha section for actionable opportunities
Network mapping: Build social graphs from participant lists across Spaces
Trend detection: Track project mentions and sentiment over time
Content curation: Quote and share notable insights on social platforms

### Health Check

curl https://clawdio.vail.report/health

Returns: {"status": "ok"}

Built by VAIL — Voice AI Layer
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: benschiller
- Version: 1.0.0
## 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-05-04T19:00:54.424Z
- Expires at: 2026-05-11T19:00:54.424Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/clawdio)
- [Send to Agent page](https://openagent3.xyz/skills/clawdio/agent)
- [JSON manifest](https://openagent3.xyz/skills/clawdio/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/clawdio/agent.md)
- [Download page](https://openagent3.xyz/downloads/clawdio)