Quickstart — Opacus Docs

Prerequisites

Requirement	Version	Notes
Node.js	≥18.x	Required by Agent Kernel and Kinetic MCP
npm	≥9.x	Bundled with Node.js
PM2	latest	`npm install -g pm2` — process manager
OpenClaw CLI	latest	See OpenClaw docs for install
Python 3	≥3.8	For the static website server

1. Install dependencies

cd agent-kernel
npm install

2. Configure environment

# Copy the example file
cp agent-kernel/.env.example agent-kernel/.env.local

Minimum variables to set:

PORT=3006
OPACUS_DEV_API_KEY=your-dev-api-key

# 0G Network (mainnet defaults)
OG_RPC_URL=https://evmrpc.0g.ai
OG_STORAGE_INDEXER=https://indexer-storage-turbo.0g.ai
OG_PRIVATE_KEY=0xYOUR_EXECUTOR_PRIVATE_KEY

# Base chain
BASE_RPC_URL=https://mainnet.base.org
AGENT_EXECUTOR_PRIVATE_KEY=0xYOUR_EXECUTOR_PRIVATE_KEY

⚠️

Never commit .env.local to version control. It contains private keys and API credentials.

Full variable reference: Environment Variables.

3. Build Agent Kernel

cd agent-kernel
npm run build

Compiles TypeScript → dist/api-server.js. Re-run after any source change.

4. Start services

Option A — PM2 (recommended)

pm2 start agent-kernel/dist/api-server.js --name opacus-kernel
pm2 start "openclaw start" --name openclaw
pm2 start "python3 -m http.server 8080" --name opacus-web --cwd website/
pm2 save

Option B — Manual (development)

# Terminal 1: Agent Kernel
cd agent-kernel && node dist/api-server.js

# Terminal 2: OpenClaw Gateway
openclaw start

# Terminal 3: Website
cd website && python3 -m http.server 8080

5. Verify services

curl http://localhost:3006/api/kinetic/templates
# Expected: JSON array of template objects

pm2 status

6. Connect Claude or Cursor (MCP)

node packages/kinetic-mcp/bin/install.js \
  --api-key=your-dev-api-key \
  --api-url=http://127.0.0.1:3006

Restart Claude Desktop or Cursor after running this command.

Test: Ask Claude "List my Opacus agents" — it should return results via MCP.

7. Open Agentboard

Navigate to http://localhost:8080/agentboard.html

Sign in with email or connect MetaMask
Balance tab → deposit USDC to execution wallet
Launch Agent tab → pick a template, set budget, launch

✅

You're live! From Claude: "Launch an oracle agent with 0.5 USDC budget via Opacus"

← Introduction

System Overview →