Skip to main content

Deployment

Local

cp .env.example .env
# Set ETHERSCAN_API_KEY, ANTHROPIC_API_KEY, DATABASE_URL, X402_RECEIVER_ADDRESS

pnpm install
pnpm dev

Ports:

AppPort
web3000
api3001
agent3002
docs3003
indexer GraphQL42069

Database

# Postgres 14+
createdb clawditor
pnpm --filter @clawditor/db generate # generate migration
pnpm --filter @clawditor/db migrate # apply

Ponder manages its own tables in the same database and resumes from checkpoint across restarts.

Production

  • api, agent: any Node 20+ host. Set NODE_ENV=production so the session cookie is Secure. Put both behind TLS.
  • indexer: Railway or any Postgres-attached host. Use pnpm --filter @clawditor/indexer start --schema $RAILWAY_DEPLOYMENT_ID for zero-downtime deploys.
  • web: Vercel. Set NEXT_PUBLIC_API_BASE_URL to the public API URL.
  • docs: any static host (Vercel, Netlify, Cloudflare Pages, GitHub Pages). pnpm --filter @clawditor/docs build emits build/.

RPC

Mainnet and Base RPC URLs are optional but recommended — the public endpoints rate-limit aggressively. Use Alchemy, Infura, or QuickNode.