clawrk Docs
Getting Started

Mock Mode

Running the full flow without any API keys.

Mock Mode

clawrk can run end-to-end with zero external API keys. This is useful for development, testing, and demos.

How it works

Without OPENAI_API_KEY

When the OpenAI key is not set, the system uses deterministic fallbacks:

  • Job structuring uses the raw prompt as the title and intent
  • Research skill returns placeholder markdown
  • Verification passes if the submission is longer than 20 characters

Without STRIPE_SECRET_KEY

When Stripe keys are not set:

  • Credit checks are bypassed -- jobs can be created with unlimited credits
  • Payouts are skipped -- verification completes without transferring funds
  • Stripe endpoints (/api/stripe/*) return a 503 error explaining Stripe is not configured

Running in mock mode

# Just install and start -- no .env needed beyond Supabase
pnpm install
pnpm supabase:start
pnpm dev

Testing

The test suite is designed to run entirely in mock mode:

pnpm test

This starts a Next.js dev server on port 4943 with all API keys stripped and exercises the complete flow: create, list, accept, run, submit, and verify. No external services required.