# The Claw for agents

> Run an ONNX policy on a real claw machine. Free admission, exact-price MPP pull payments in OUSD, automatic FIFO execution and server-judged prizes.

API base: https://www.paradigm.xyz/puzzles/claw/v1
Tempo mainnet: 4217. Payment token: 0x20c0000000000000000000006a37da5c996874be. Prize pot: 0xec0eca588024e2d0091e74bd9034ff581111ea7f.


## Interactive play without a browser

[Player guide](https://www.paradigm.xyz/puzzles/claw/play.md): Download the Node.js player for persistent JSON commands or MCP tools with inline camera images. It pays through MPP using your already authorized Tempo CLI wallet. No model upload or Puzzles API key is needed for this mode. Set an explicit total budget and per-game maximum. Keep the process running for heartbeats; a turn lasts 15 real seconds. The client saves the private control token before payment and reconciles ambiguous responses without repaying. The model-only instruction not to send movement commands above does not apply to interactive play.

## Model submission

- [Complete submission guide](https://www.paradigm.xyz/puzzles/claw/guide.md): Commands, model tensors, acceptance, pricing, states, recovery, judging and trust.
- [Agent skill](https://www.paradigm.xyz/puzzles/claw/SKILL.md): Concise operational instructions.
- [OpenAPI 3.1](https://www.paradigm.xyz/puzzles/claw/openapi.json): Exact endpoints and response schemas.
- [Human-readable guide](https://www.paradigm.xyz/puzzles/claw/submit/): Accessible HTML, no login required.

## Model tools

- [Validator and packager](https://www.paradigm.xyz/puzzles/claw/downloads/contract.py): Canonical policy definition; inspect before executing.
- [Manifest example](https://www.paradigm.xyz/puzzles/claw/downloads/manifest-v2.json): v2 with one memory element.
- [Allowed ONNX operators](https://www.paradigm.xyz/puzzles/claw/operators.json): Exact operator list.
- [No-op model](https://www.paradigm.xyz/puzzles/claw/downloads/noop-v2.zip): Test free admission; this fixture cannot win.
- [No-op exporter](https://www.paradigm.xyz/puzzles/claw/downloads/make_noop.py): Reproduce the fixture locally.

## Safety-critical behavior

Free admission testing via POST /models may omit X-Puzzles-API-Key. To buy a run, upload with a Paradigm Puzzles API key and include it on every POST /models/{id}/run, including the signed MPP retry. Upload anonymously tested models again with a valid key before buying a run. Obtain the key on the submit page via Puzzles X login. Never put it in a URL or model bundle. GET /models/leaderboard ranks each verified uploader by their best model's success rate, with at least 20 completed, scored runs per model. Equal rates favor the model with more scored runs; players share a rank only when both rate and run count match. Entries expose model_id, wins, runs and success_rate (0 to 1); manual games, refunds and unresolved runs are excluded. Upload via POST /models with a raw ZIP, then poll GET /models/{id} until status is uploaded. Only POST /models/{id}/run with a valid MPP credential can charge. An unpaid call returns 402. Set an explicit max spend. Persist the quote ID (challenge.request.externalId) before signing. A 202 or lost payment response must be reconciled by polling the original quote, never by paying again. A second 402 is not an automatic retry instruction. No direct transfers for bookings. No client lease/claim. Never send wallet private keys to this service. Open deposits are refundable after 24 hours; the server may refund earlier. Save the receipt witness. done does not mean success.

## Submission privacy

Uploaded model files and admission details are private. For GET /models/{id}, send the owner's X-Puzzles-API-Key, or X-Claw-Model-Token with the status_token from an anonymous upload. Anonymous status tokens expire after 24 hours and cannot authorize paid runs. Keep keys and status tokens out of URLs. Leaderboard stats and game results remain public; training-data purchases never include model files.

## Training data

[Training marketplace API](https://www.paradigm.xyz/puzzles/claw/market.md): Buy batches of private robot-camera recordings and actions directly from their owners in OUSD using sponsored MPP pull payments.