AEON AI Gateway

Co-presented by AEON & SkillBoss — AI Agents pay per-call to invoke 200+ AI tool capabilities via the x402 protocol.

Zero API keys · Zero prepay · x402 pay-per-call · Natural-language driven

@aeon-ai-pay/aigateway is a unified CLI + Agent Skill. Through a session wallet and the x402 protocol, it opens up SkillBoss's 200+ tool capabilities (image / video / audio / search / scraping / email / document / social data / UI generation, etc.) to AI Agents for pay-per-call invocation.

Payment Modes

Two wallet modes are supported, switchable via aigateway wallet-mode:

Mode	Chain	Token	Gas	Switch
`okx` (default)	X Layer	USDG (ERC-20)	OKX internal (0 gas for x402 calls)	—
`session-key`	BSC	USDT (BEP-20)	BNB (one-time approve ~$0.002)	`aigateway wallet-mode session-key`

okx (default): OKX Agentic Wallet — TEE-backed signing, no local private key. Requires onchainos CLI. Brand-new users start here automatically. Surfaced to users as Provider: OKX Agentic Wallet.
session-key: Local private key stored in ~/.aigateway/config.json. Funded via WalletConnect QR scan. Opt in via aigateway wallet-mode session-key. Surfaced to users as Provider: Aeon Agentic Wallet.

About SkillBoss

SkillBoss is a unified AI API + Agent Skills platform — a single entry point gives access to models and tool capabilities from multiple providers.

Dimension	Data
Public API endpoints	359
Service providers	50

Full capability surface: Image · Video · Audio (TTS / STT) · Search · Scraping · Social / Business Data · Email · SMS · Document · UI Generation · Finance / Utility

Architecture

┌────────────────────────────────────────────────────────────┐
│  AI Agent (Claude Code / Cursor / Codex / Windsurf / ...) │
└────────────────────┬───────────────────────────────────────┘
                     │ natural-language instructions
                     ▼
┌────────────────────────────────────────────────────────────┐
│  aigateway CLI (@aeon-ai-pay/aigateway)                    │
│                                                            │
│   wallet-mode ─────→ okx (X Layer/USDG via OKX TEE) ◀ default │
│                  └─→ session-key (BSC/USDT)               │
│                                                            │
│   sb tools  ──→ server catalog (model + tier + schema)     │
│   sb invoke ──→ client-side inputs validation              │
│              ──→ x402 phase 1 (402 response: live price)   │
│              ──→ EIP-712 / EIP-3009 signing (gasless)      │
│              ──→ auto-download image / video / audio       │
└────────────────────┬───────────────────────────────────────┘
                     │ HTTP + x402
                     ▼
┌────────────────────────────────────────────────────────────┐
│  AEON x402 Gateway                                         │
│   dynamic pricing by model.priceUnit × usage               │
│   proxies calls to SkillBoss upstream                      │
└────────────────────┬───────────────────────────────────────┘
                     ▼
┌────────────────────────────────────────────────────────────┐
│  SkillBoss (api.skillboss.co)                              │
│   50 vendors · 359 endpoints                               │
└────────────────────────────────────────────────────────────┘

Capability Categories

Category	Pricing Unit	Description
`image`	`per_image`	Image generation / editing / upscaling / background removal
`video`	`per_second`	Video generation (requires `duration`)
`tts`	`per_1k_chars`	Text-to-speech / sound effect generation
`stt`	`per_minute`	Speech-to-text (requires `duration_minutes`)
`search`	`per_request`	Web search / map search
`scraper`	`per_request`	Web scraping / structured extraction
`social_data`	`per_request`	Social / business data
`sms`	`per_request`	SMS / OTP / email verification
`document`	`per_request`	Document parsing (PDF / DOCX → Markdown)
`ui_generation`	`per_request`	UI / prototype / slide deck generation
`financial`	`per_request`	Stock / forex / crypto / financial news
`news`	`per_request`	News APIs
`utility`	`per_request`	Domain / QR code / geo / dictionary and other utility APIs

Prerequisites

Node.js ≥ 25
okx mode (default): onchainos CLI + OKX account, holding USDG on X Layer
session-key mode: A WalletConnect-compatible wallet holding USDT (BEP-20) + a small amount of BNB (~$0.002 for one-time approve gas)

Installation

Step 1: Install the CLI

npm install -g @aeon-ai-pay/aigateway
aigateway --version

Step 2: Install the Agent Skill (optional, for repair)

The postinstall script auto-installs the skill into detected agents. If something was missed:

npx skills add AEON-Project/aigateway -g -y

Supported: Claude Code, Cursor, Codex, OpenClaw, Gemini CLI, GitHub Copilot, Windsurf, Roo Code, 39+ more.

Step 3: Choose wallet mode

Option A — OKX Agentic Wallet (default, X Layer + USDG)

Brand-new installs default to okx automatically — just authenticate:

# Install onchainos CLI
curl -sSL https://raw.githubusercontent.com/okx/onchainos-skills/main/install.sh | sh

# Authenticate (interactive wizard: installs CLI, guides login, saves config)
aigateway wallet-mode okx

# In Claude Code / agent shell (non-TTY), use flags:
aigateway wallet-mode okx --email your@email.com
aigateway wallet-mode okx --otp <code>

# Top up (send USDG to displayed address from any wallet)
aigateway wallet-topup

Option B — session-key (BSC + USDT)

Opt out of the default to use a local WalletConnect-funded key:

# Switch to session-key mode, then create the local key
aigateway wallet-mode session-key
aigateway wallet-init

# Top up (WalletConnect QR — transfers USDT + BNB for approve gas)
aigateway wallet-topup --amount 10

# Done — sb invoke is now fully gasless

Step 4: Invoke SkillBoss tools

aigateway sb tools --category image
aigateway sb invoke --model replicate/black-forest-labs/flux-schnell --inputs '{"prompt":"a cat"}'

Images / videos / audio are auto-downloaded into ~/aigateway-{images,videos,audio}/.

CLI Command Reference

Every command emits a single JSON envelope to stdout: { ok, command, version, data | error }.

Command	Description	Key flags
`wallet-mode <mode>`	Switch payment mode: `okx` \| `session-key`. Interactive wizard in real terminal; use `--email`/`--otp` in agent shells.	`--email <email>`, `--otp <code>`
`wallet-init`	Check / create wallet; returns `needsTopup`, `tokenSymbol`, `mode`	`--app-id <id>`
`wallet-topup`	Fund wallet: session-key → WalletConnect USDT; okx → shows deposit address	`--amount <n>`
`wallet-balance`	Show balance (`usdt`, `tokenSymbol`, `mode`)	—
`wallet-gas`	Transfer native gas token via WalletConnect (session-key: BNB; okx: OKB)	`--amount <n>`
`wallet-withdraw`	Withdraw token back to main wallet	`--amount <n>`, `--token <USDT\|BNB\|USDG\|OKB>`, `--to <address>`
`sb invoke`	The only x402 paid entry point — invoke any SkillBoss model	`--model <id>` ✱, `--inputs <json>` ✱, `--output <dir>`, `--raw`
`sb tools`	Fetch live model catalog (no cache)	`--model <id>` / `--category <key>` / `--tier <price\|quality\|balanced>`
`clean`	Uninstall skill + global package + clear caches	—

✱ = required. Global flags: --legacy-output, --verbose, --quiet.

Wallet Mode Details

okx (X Layer + USDG) — default

The product default; brand-new users (no prior config) start here automatically
TEE-backed key management via OKX Agentic Wallet (no local private key)
USDG = Global Dollar by Paxos (6 decimals, EIP-3009)
EIP-3009 transferWithAuthorization — no approve step, no gas for payments

session-key (BSC + USDT)

Opt in via aigateway wallet-mode session-key
Private key auto-generated at ~/.aigateway/config.json (mode 0600)
One-time ERC20.approve(facilitator, MaxUint256) requires ~0.0003 BNB
All sb invoke calls are gasless after approve
Switch back to the default anytime: aigateway wallet-mode okx

Name		Name	Last commit message	Last commit date
.claude		.claude
bin		bin
docs		docs
scripts		scripts
skills/aigateway		skills/aigateway
src		src
templates		templates
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json

Navigation Menu

Repository files navigation

AEON AI Gateway

Payment Modes

About SkillBoss

Architecture

Capability Categories

Prerequisites

Installation

Step 1: Install the CLI

Step 2: Install the Agent Skill (optional, for repair)

Step 3: Choose wallet mode

Option A — OKX Agentic Wallet (default, X Layer + USDG)

Option B — session-key (BSC + USDT)

Step 4: Invoke SkillBoss tools

CLI Command Reference

Wallet Mode Details

okx (X Layer + USDG) — default

session-key (BSC + USDT)

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

AEON AI Gateway

Payment Modes

About SkillBoss

Architecture

Capability Categories

Prerequisites

Installation

Step 1: Install the CLI

Step 2: Install the Agent Skill (optional, for repair)

Step 3: Choose wallet mode

Option A — OKX Agentic Wallet (default, X Layer + USDG)

Option B — session-key (BSC + USDT)

Step 4: Invoke SkillBoss tools

CLI Command Reference

Wallet Mode Details

okx (X Layer + USDG) — default

session-key (BSC + USDT)

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages