agentclear

# 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....

# 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
- 🐙 [...