agentclear

Original source / Raw SKILL.md

---
name: agentclear
description: "Discover, call, and pay for APIs through AgentClear — the commerce layer for AI agents. Use when you need to: (1) find an API or tool by describing what you need in natural language, (2) call a paid API service through the AgentClear proxy with automatic micro-billing, (3) list available services on the marketplace, (4) check your AgentClear balance or account status. Requires an AgentClear API key (starts with axk_). Get one free at https://agentclear.dev with $5 in credits."
metadata:
  openclaw:
    requires:
      env:
        - AGENTCLEAR_API_KEY
---

# AgentClear — Agent Commerce Layer

Discover and call paid APIs with natural language. One API key, per-call billing, zero friction.

## Setup

Requires `AGENTCLEAR_API_KEY` environment variable (starts with `axk_`).

```bash
export AGENTCLEAR_API_KEY="axk_your_key_here"
```

Get a free key with $5 credits: https://agentclear.dev/login

## Data & Privacy

- **Discovery queries** are used for semantic matching and logged to power the Bounty Board (demand signals for missing services). No PII is collected.
- **Proxy calls** forward your payload to the upstream service provider you selected. AgentClear does not store request/response payloads — only billing metadata (service ID, timestamp, cost).
- **API keys** authenticate and meter usage. Keys are scoped to your account and can be revoked at any time.
- All traffic is over HTTPS. See https://agentclear.dev/security for full details.

## Endpoints

Base URL: `https://agentclear.dev`

### Discover Services
Find APIs by describing what you need:
```bash
curl -X POST https://agentclear.dev/api/discover \
  -H "Authorization: Bearer $AGENTCLEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "parse invoices from PDF", "limit": 5}'
```

Response returns ranked services with `id`, `name`, `description`, `price_per_call`, and `trust_score`.

### Call a Service
Proxy a request through AgentClear (auto-billed per call):
```bash
curl -X POST https://agentclear.dev/api/proxy/{service_id} \
  -H "Authorization: Bearer $AGENTCLEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"your": "payload"}'
```

The payload is forwarded to the upstream service. Response includes the service result plus billing metadata.

### List Services
Browse available services:
```bash
curl https://agentclear.dev/api/services \
  -H "Authorization: Bearer $AGENTCLEAR_API_KEY"
```

## Workflow

1. **Discover** — Describe what you need → get ranked service matches
2. **Evaluate** — Check price, trust score, and description
3. **Call** — Proxy the request → get result + pay per call
4. If no service exists, check the **Bounty Board** at https://agentclear.dev/bounties

## Pricing

- Services range from $0.001 to $1+ per call (provider-set)
- Platform fee: 2.5%
- New accounts get **$5 free credits**
- Balance auto-deducts per call

## Tips

- Use specific, descriptive queries for better discovery results ("parse QuickBooks QBO files to JSON" beats "parse files")
- Chain services: discover → call → use result as input to another service
- If a discover query returns no results, the query is logged as demand on the Bounty Board — providers will build it


---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### README.md

```markdown
# AgentClear Skill for OpenClaw

> Give your AI agent the ability to discover, call, and pay for any API — with natural language.

## What is AgentClear?

[AgentClear](https://agentclear.dev) is the commerce layer for AI agents. Think **Stripe + DNS for autonomous tools**: semantic discovery, per-call micro-payments, and trust-scored APIs.

Your agent describes what it needs → AgentClear finds the right API → your agent calls it → billed per use.

## Install

Copy the `SKILL.md` file into your OpenClaw skills directory:

```bash
# From your OpenClaw workspace
mkdir -p skills/agentclear
curl -o skills/agentclear/SKILL.md https://raw.githubusercontent.com/dwflickinger/agentclear-skill/main/SKILL.md
```

Or clone the repo:

```bash
cd ~/.openclaw/workspace/skills
git clone https://github.com/dwflickinger/agentclear-skill.git agentclear
```

Then restart your OpenClaw gateway.

## Get an API Key

1. Go to [agentclear.dev/login](https://agentclear.dev/login)
2. Sign in with GitHub
3. Get your `axk_` API key — comes with **$5 free credits**

Set it in your environment:
```bash
export AGENTCLEAR_API_KEY="axk_your_key_here"
```

## What Your Agent Can Do

Once installed, your OpenClaw agent can:

- **Discover APIs** — "Find me an API that parses invoices from PDFs"
- **Call services** — Proxy requests through AgentClear with automatic billing
- **Browse the marketplace** — List all available services
- **Chain services** — Use one API's output as another's input

## Example

```
You: "I need to extract data from this QuickBooks file"

Agent: *discovers qb-parser service on AgentClear*
Agent: *calls it via proxy for $0.005*
Agent: "Here's the parsed data: ..."
```

## Pricing

- Services: $0.001 – $1+ per call (provider-set)
- Platform fee: 2.5%
- New accounts: **$5 free credits**

## Links

- 🌐 [agentclear.dev](https://agentclear.dev)
- 📖 [API Docs](https://agentclear.dev/docs)
- 🏗️ [Bounty Board](https://agentclear.dev/bounties) — see what agents are searching for
- 🐙 [GitHub](https://github.com/dwflickinger/agentclear)

```

### _meta.json

```json
{
  "owner": "dwflickinger",
  "slug": "agentclear",
  "displayName": "AgentClear",
  "latest": {
    "version": "1.1.0",
    "publishedAt": 1772768773552,
    "commit": "https://github.com/openclaw/skills/commit/6e41f6fa7844728cf917b16bf4addbd58471b0c5"
  },
  "history": [
    {
      "version": "1.0.0",
      "publishedAt": 1772768320969,
      "commit": "https://github.com/openclaw/skills/commit/2eb33413078d1fc919673a8f84fb13c50fecbee3"
    }
  ]
}

```