Getting Started in 5 Minutes

Set your API key, send events, and read both trust and behavior scores. Then use preflight before risky actions.

Base URL: https://clawtrustscores.com

Where to put your API key

Put it in your server/backend environment variables (for example CLAWTRUST_API_KEY).
If you run a Telegram or Discord bot, add it to the bot server config where API secrets are stored.
If you use browser automation/workflows, store it in platform secrets (Zapier/Make/n8n), not in page JavaScript.

Your app/bot sends the key in request header x-api-key. End users never need to see the key.

# .env (copy/paste)
CLAWTRUST_API_KEY=claw_paste_your_real_key_here

3 quick steps

1. Get an API key
Use the homepage form or create one with POST /v1/users, then store it in your backend env vars.

2. Send events
Log success/failure signals with POST /v1/events (or use signed ingest connectors).

3. Read scores + gate actions
Call GET /v1/score for trust + behavior and POST /v1/integrations/clawcredit/preflight for allow/review/block.

OpenClaw install (10 lines)

npx clawhub@latest install claw-trust-scores

# .env
CLAWTRUST_API_KEY=claw_paste_your_real_key_here
CLAWTRUST_BASE_URL=https://clawtrustscores.com

# call in your flow:
get_score(agentId)
preflight_payment(agentId, amountUsd, newPayee)
log_event(agentId, kind, eventType)

Download: skill bundle (.zip) · Verify source: official GitHub folder.

Set policy in one call (recommended)

Apply the balanced preset before production traffic. It enforces verified-sensitive guardrails and a quality floor.

curl -X POST "https://clawtrustscores.com/v1/policy/presets/balanced" \
  -H "x-api-key: YOUR_KEY"

For money movement, use wallet_guarded or money_movement_strict. Then confirm settings with GET /v1/policy.

Choose your source

Stripe

Payments and disputes.

Open Stripe quickstart

Auth Provider

Impersonation, abuse, and login risk.

Open Auth quickstart

Marketplace

Task completion quality and abuse signals.

Open Marketplace quickstart

Wallet

On-chain tx and wallet security signals.

Open Wallet quickstart

Prediction Market

Settlement and manipulation/security signals.

Open Prediction quickstart

Runtime

Execution reliability and sandbox risk events.

Open Runtime quickstart

Stripe quickstart

No-code setup first

Create ingest secret: POST /v1/integrations/ingest/secret
Preview mapping: POST /v1/integrations/map-event with {"source":"stripe","providerEventType":"payment_intent.payment_failed"}
Send signed events to POST /v1/integrations/ingest/events

curl -X POST "https://clawtrustscores.com/v1/integrations/ingest/events" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -H "x-ingest-timestamp: 1739980000" \
  -H "x-ingest-signature: sha256=YOUR_HEX_SIGNATURE" \
  -d '{"source":"stripe","eventId":"evt_123","agentId":"agent:vendor:acme","providerEventType":"payment_intent.payment_failed","amountUsd":49.99,"currency":"usd"}'

Auth provider quickstart

No-code setup first

Create ingest secret: POST /v1/integrations/ingest/secret
Preview mapping: POST /v1/integrations/map-event with {"source":"auth","providerEventType":"impersonation.detected"}
Send signed events to POST /v1/integrations/ingest/events

curl -X POST "https://clawtrustscores.com/v1/integrations/ingest/events" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -H "x-ingest-timestamp: 1739980000" \
  -H "x-ingest-signature: sha256=YOUR_HEX_SIGNATURE" \
  -d '{"source":"auth","eventId":"auth_evt_9001","agentId":"agent:vendor:acme","providerEventType":"impersonation.detected","ip":"203.0.113.8"}'

Marketplace quickstart

No-code setup first

Create ingest secret: POST /v1/integrations/ingest/secret
Preview mapping: POST /v1/integrations/map-event with {"source":"marketplace","providerEventType":"task.abandoned"}
Send signed events to POST /v1/integrations/ingest/events

curl -X POST "https://clawtrustscores.com/v1/integrations/ingest/events" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -H "x-ingest-timestamp: 1739980000" \
  -H "x-ingest-signature: sha256=YOUR_HEX_SIGNATURE" \
  -d '{"source":"marketplace","eventId":"mk_evt_1002","agentId":"agent:vendor:acme","providerEventType":"task.abandoned","taskId":"task_1002"}'

Wallet quickstart

No-code setup first

Run readiness: GET /v1/integrations/readiness?source=wallet
Preview mapping: POST /v1/integrations/map-event with {"source":"wallet","providerEventType":"wallet.secret.exposed"}

curl -X POST "https://clawtrustscores.com/v1/integrations/map-event" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"source":"wallet","providerEventType":"wallet.tx.failed"}'

Prediction market quickstart

No-code setup first

Run readiness: GET /v1/integrations/readiness?source=prediction_market
Preview mapping: POST /v1/integrations/map-event with {"source":"prediction_market","providerEventType":"market.manipulation_flag"}

curl -X POST "https://clawtrustscores.com/v1/integrations/map-event" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"source":"prediction_market","providerEventType":"bet.settled_profit"}'

Runtime quickstart

No-code setup first

Run readiness: GET /v1/integrations/readiness?source=runtime
Preview mapping: POST /v1/integrations/map-event with {"source":"runtime","providerEventType":"sandbox.escape_detected"}

curl -X POST "https://clawtrustscores.com/v1/integrations/map-event" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"source":"runtime","providerEventType":"credential.exposure_detected"}'