Aeria Developer Guide

Aeria is a pay-per-request coding agent powered by the OpenClaw API. It provides a complete, integrated development environment — editor, terminal, file management, and AI agent — all within a single premium interface.

Unlike subscription-based tools, Aeria operates on a credit system. You fund your account, and every agent request deducts from your balance based on actual token usage. No idle charges. No wasted capacity.

Aeria supports local execution, meaning you can run your code directly within the workspace. You can import existing project files and export completed projects at any time.

Get running in under two minutes:

# 1. Navigate to the Aeria workspace
https://aeria.app/workspace

# 2. Connect your Solana wallet (Phantom recommended)
# Click "Connect Wallet" in the navigation bar

# 3. Purchase credits on the Pricing page
# Minimum $5 USDC or equivalent SOL

# 4. Enter your OpenClaw API key in Settings
# Settings > API Configuration > Enter Key

# 5. Start building
# Open the workspace and describe what you want to build

If you want to try Aeria without purchasing credits, you can use Demo Mode, which provides a limited sandbox experience.

Aeria can be run locally for development and self-hosted deployments.

# Clone the repository
git clone https://github.com/aeria-agent/aeria.git
cd aeria

# Install dependencies
npm install

# Configure environment variables
cp .env.example .env.local

# Edit .env.local with your configuration
nano .env.local

Required environment variables:

# OpenClaw API Configuration
OPENCLAW_API_KEY=your_openclaw_api_key
OPENCLAW_ENDPOINT=https://api.openclaw.ai/v1

# Solana RPC (for payment verification)
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# Payment wallet addresses (configured by operator)
USDC_RECEIVE_ADDRESS=
SOL_RECEIVE_ADDRESS=

# Application
NEXT_PUBLIC_APP_URL=http://localhost:3000
DATABASE_URL=your_database_url

# Run the development server
npm run dev

# Build for production
npm run build
npm start

# Run with Docker
docker build -t aeria .
docker run -p 3000:3000 aeria

Local installations have full access to the workspace, terminal, file import/export, and local code execution. Agent capabilities require a valid OpenClaw API key.

Aeria operates as a bridge between your intent and your codebase. The system architecture consists of three layers:

The Aeria workspace is a full-featured development environment:

• File Tree — Browse, create, rename, and delete project files
• Editor — Syntax-highlighted code editor with tab management
• Terminal — Integrated terminal for running commands locally
• Agent Panel — Natural language interface to the OpenClaw coding agent
• Import/Export — Drag-and-drop file import and full project export
• Request Meter — Real-time credit usage and balance display

Without an API key or credits, the workspace operates in Demo Mode — you can explore the interface, import files, and use the editor, but agent requests are disabled.

Aeria uses a credit-based billing model. There are no subscriptions or monthly fees.

Credit Conversion Rate:
$1.00 USD = ~100,000 tokens

Example Usage:
- Simple function generation:  ~500 tokens   ($0.005)
- Component scaffold:          ~2,000 tokens  ($0.02)
- Full feature implementation: ~15,000 tokens ($0.15)
- Complex refactor:            ~50,000 tokens ($0.50)

Minimum deposit: $5.00 USD
Payment methods: USDC (Solana), SOL

Credits never expire. Your balance persists across sessions and is tied to your connected wallet address.

To enable full agent capabilities, you need an OpenClaw API key:

# 1. Visit https://openclaw.ai and create an account
# 2. Generate an API key from your dashboard
# 3. In Aeria, go to Settings > API Configuration
# 4. Paste your OpenClaw API key
# 5. Click "Verify & Save"

# Alternatively, for local installations:
echo "OPENCLAW_API_KEY=oc_live_xxxxxxxxxxxx" >> .env.local

The API key is stored locally and never transmitted to Aeria servers. All agent requests are made directly between your browser and the OpenClaw API.

Aeria supports running code directly within the workspace environment. The integrated terminal provides a sandboxed execution context.

# In the Aeria terminal panel:
$ node index.js
$ python main.py
$ npm run build
$ cargo run

# File system operations are scoped to your workspace
$ ls -la
$ cat output.txt

Local execution happens in a controlled sandbox. Network access and system-level operations may be restricted depending on your deployment configuration.

Import existing project files into Aeria using drag-and-drop or the import interface.

Supported import methods:
- Drag and drop files/folders into the file tree
- Click "Import Files" in the workspace toolbar
- Click "Import Folder" to import entire directories
- Paste code directly into new files

Supported formats: All text-based files
Maximum project size: 50MB (configurable for self-hosted)

Export your complete project at any time as a ZIP archive.

Export options:
- "Export All" — Downloads entire workspace as .zip
- Individual files can be downloaded via right-click
- Project structure is preserved in exports
- Git history is not included (workspace is file-based)

Aeria is powered by the OpenClaw API, which provides multi-model AI orchestration optimized for code generation and manipulation.

// OpenClaw request structure (internal)
const response = await openclaw.complete({
  model: "precision-v1",
  context: {
    files: workspace.getOpenFiles(),
    activeFile: editor.getCurrentFile(),
    projectStructure: fileTree.getStructure(),
  },
  instruction: userMessage,
  maxTokens: 8192,
  temperature: 0.1,
});

// Response includes file modifications, terminal commands,
// and explanatory annotations

OpenClaw handles model selection, context window management, and output validation. Aeria applies the results to your workspace automatically.

Simple, transparent, usage-based pricing.

Aeria is designed with a security-first architecture:

• API keys are stored locally in your browser — never on Aeria servers
• Wallet connections use standard Solana/EVM signing — no private key access
• All agent requests are encrypted in transit via HTTPS/TLS
• Code execution is sandboxed — no access to your system outside the workspace
• Payment verification uses on-chain transaction confirmation
• Self-hosted deployments give you full infrastructure control