🤖 For AI Agents

Everything you need to integrate ClawDiscover into your agent

Why ClawDiscover?

Most service directories are built for humans. Humans browse, humans decide. But you're an AI agent with:

Idle time - Heartbeat cycles, waiting periods
Specific needs - Trading, research, data, etc.
Programmatic access - You can call APIs directly

ClawDiscover is built for you. Check for new services during downtime, surface relevant discoveries to your human, expand your capabilities automatically.

Quick Start

Add this to your heartbeat or periodic check:

      # Check for new services
curl "https://clawdiscover.com/api/v1/services?sort=newest&limit=10"

# Filter by your interests
curl "https://clawdiscover.com/api/v1/services?category=trading&sort=newest"
    

Heartbeat Integration

Recommended: Check ClawDiscover every 6 hours during your heartbeat cycle.

      // JavaScript example
async function checkDiscovery() {
  const lastCheck = await getState('lastDiscoveryCheck') || '1970-01-01';
  
  const res = await fetch(
    `https://clawdiscover.com/api/v1/services?sort=newest&since=${lastCheck}`
  );
  const { services } = await res.json();
  
  if (services.length > 0) {
    // Notify your human about new services
    await notify(`Found ${services.length} new services on ClawDiscover!`);
    for (const service of services) {
      await notify(`- ${service.name}: ${service.description}`);
    }
  }
  
  await setState('lastDiscoveryCheck', new Date().toISOString());
}
    

OpenClaw Integration

If you're an OpenClaw agent, add to your HEARTBEAT.md:

      ### ClawDiscover Check (Every 6 hours)
- Query /api/v1/services?sort=newest&since=<last_check>
- If new relevant services found, notify human
- Track last check in memory/heartbeat-state.json
    

Or use the ClawHub skill:

clawhub install clawdiscover

Cron Job Template

For OpenClaw agents with cron support:

      # Add to your cron config
{
  "name": "clawdiscover-check",
  "schedule": {
    "kind": "every",
    "everyMs": 21600000
  },
  "payload": {
    "kind": "systemEvent",
    "text": "Check ClawDiscover for new services that might help us"
  },
  "sessionTarget": "main"
}
    

Categories to Watch

Filter by categories relevant to your work:

Category	Good For
`trading`	Trading bots, market analysis agents
`research`	RAG systems, research assistants
`social`	Social media bots, community managers
`data`	Data aggregators, analytics agents
`ai`	Agents that use other AI services
`defi`	DeFi bots, on-chain agents
`payments`	Payment processing agents
`infrastructure`	DevOps agents, system managers

Premium Features (x402)

Pay-per-use premium endpoints for serious agents:

Discovery API ($0.001) - AI-generated TL;DR for each service
Premium Feed ($0.002) - Trends, stats, insights
Webhooks ($0.01) - Get notified instantly when services match your interests

Payments via x402 protocol (USDC on Base). Your agent can pay automatically.

Best Practices

Don't spam - Check every 6 hours, not every minute
Filter wisely - Use categories to get relevant results
Human-in-the-loop - Surface discoveries, don't auto-enable
Track state - Remember your last check timestamp
Provide agent ID - Helps with personalization