⚠️Never commit .env.local to version control. Use .env.example as a template with placeholder values only.
Core server
| Variable | Default | Description |
|---|
PORT | 3006 | HTTP port for Agent Kernel API server |
NODE_ENV | development | Set to production in prod. Affects logging and error verbosity. |
OPACUS_DEV_API_KEY | — | Required in dev. Master API key accepted by all authenticated routes. Use long random strings. |
OPACUS_REQUIRE_EXECUTOR_REGISTRY | true | Set to false to use single private key fallback (dev only) |
Execution wallet (Base chain)
| Variable | Description |
|---|
AGENT_EXECUTOR_PRIVATE_KEY | Required. Private key of the execution wallet. Signs all on-chain USDC transactions on Base. |
BASE_RPC_URL | Base mainnet RPC. Default: https://mainnet.base.org |
BASE_USDC_ADDRESS | USDC contract on Base. Default: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
0G Network
| Variable | Description |
|---|
OG_RPC_URL | 0G EVM RPC. Mainnet: https://evmrpc.0g.ai | Testnet: https://evmrpc-testnet.0g.ai |
OG_STORAGE_INDEXER | Storage indexer. Mainnet: https://indexer-storage-turbo.0g.ai |
OG_PRIVATE_KEY | Private key for signing 0G storage transactions (can be same as executor key) |
OG_PROVIDER_ADDRESS | 0G compute provider wallet address for GPU inference routing |
OG_INFERENCE_TOKEN | 0G Labs inference API token (alternative auth for compute network) |
OG_FLOW_CONTRACT | 0G Flow contract address (auto-detected from indexer if omitted) |
Amazon / Shopping
| Variable | Description |
|---|
OPACUS_AMAZON_ORDER_API_URL | URL for direct Amazon order connector. Without it, shopping runs in checkout mode only. |
OPACUS_SHOPPING_MAX_USDC | Maximum per-task budget cap for shopping agent. Default: 100 |
OpenClaw integration
| Variable | Description |
|---|
OPENCLAW_API_URL | OpenClaw gateway URL. Default: auto-detected from local process |
OPENCLAW_API_KEY | OpenClaw authentication key if gateway requires it |
AI provider keys (optional)
| Variable | Description |
|---|
ANTHROPIC_API_KEY | Anthropic Claude API key for direct inference fallback |
OPENAI_API_KEY | OpenAI API key for direct inference fallback |
Logging & monitoring
| Variable | Description |
|---|
LOG_LEVEL | info | debug | warn | error. Default: info |
OPACUS_DISABLE_SIMULATE | Set to true to disable simulation mode and use real on-chain execution |
Example .env.local
# Core
PORT=3006
NODE_ENV=production
OPACUS_DEV_API_KEY=sk-opacus-local-dev-change-this-in-production
OPACUS_REQUIRE_EXECUTOR_REGISTRY=false
# Base chain
AGENT_EXECUTOR_PRIVATE_KEY=0xabc123...
BASE_RPC_URL=https://mainnet.base.org
# 0G Network (mainnet)
OG_RPC_URL=https://evmrpc.0g.ai
OG_STORAGE_INDEXER=https://indexer-storage-turbo.0g.ai
OG_PRIVATE_KEY=0xabc123...
OG_PROVIDER_ADDRESS=0xProviderAddress...
# Optional AI keys
ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-...