AgentWallex logo
Docs

OpenClaw Plugin & Skill

Install the AgentWallex plugin for AI agent platforms — zero-config setup via conversation

Overview

The @agentwallex/openclaw plugin lets AI agents on any compatible platform (OpenClaw, OpenFang, ZeroClaw, AutoGPT, CrewAI) send USDC payments, check balances, and manage transactions — with zero configuration files.

Instead of manually editing config files, your agent guides you through setup via a simple conversation.

Installation

Via OpenClaw

openclaw plugins install @agentwallex/openclaw

Via ClawHub (Skill)

clawhub install agentwallex-payment

Via npm (for developers)

npm install @agentwallex/openclaw

Zero-Config Setup

Once installed, tell your AI agent:

"Set up AgentWallex"

The agent will:

  1. Call the agentwallex_setup tool to check your current status
  2. Provide a link to the AgentWallex Dashboard
  3. Guide you to sign in with Google
  4. Help you create an API key (starts with awx_)
  5. Ask you to copy your Agent ID
  6. Validate your credentials via agentwallex_configure
  7. Save them locally at ~/.openclaw/agentwallex/config.json

That's it. No YAML files, no environment variables, no manual config editing.

Credentials Storage

Credentials are stored locally on your machine:

  • Path: ~/.openclaw/agentwallex/config.json
  • Permissions: 0600 (owner-only read/write)
  • Format: JSON with apiKey, agentId, and optional sandbox flag

Available Tools

The plugin provides 8 tools:

Setup Tools (no credentials needed)

ToolDescription
agentwallex_setupCheck if AgentWallex is configured and get setup instructions
agentwallex_configureValidate API key + Agent ID, then save credentials locally

Payment Tools (require configuration)

ToolDescription
agentwallex_create_agentCreate a new AI agent with its own wallet
agentwallex_list_agentsList all agents with optional status/chain filtering
agentwallex_create_walletGet or create a deposit address for the agent
agentwallex_paySend a USDC payment to a recipient address
agentwallex_check_balanceCheck the agent's available USDC balance
agentwallex_tx_statusQuery the status of a specific transaction

Usage Examples

Once set up, interact naturally:

Check Balance

You: What's my USDC balance?
Agent: Your available USDC balance on base is 150.00 USDC.

Send a Payment

You: Send 25 USDC to 0xAbCdEf1234567890AbCdEf1234567890AbCdEf12
Agent: Transaction created: tx-a1b2c3d4
       Status: pending

Multi-step Workflow

You: Check my balance and send 10 USDC to 0xRecipient for the API service

Agent: Balance: 150.00 USDC — sufficient.
       Sending 10 USDC to 0xRecipient...
       Transaction tx-e5f6g7h8 created, status: pending.

Reconfigure

You: Reconfigure AgentWallex with API key awx_new_key and agent ID agent-456

Agent: Credentials validated! Connected to agent "my-new-agent".
       Configuration updated.

Upgrade

Update to the latest version:

openclaw plugins update agentwallex-payment

Or update all plugins at once:

openclaw plugins update --all

Uninstall

openclaw plugins uninstall agentwallex-payment

To keep plugin files on disk:

openclaw plugins uninstall agentwallex-payment --keep-files

To also remove locally stored credentials:

rm -rf ~/.openclaw/agentwallex

Sandbox Testing

To test with sandbox (testnet) tokens:

"Configure AgentWallex with API key awx_sandbox_xxx and agent ID agent-123, in sandbox mode"

Sandbox transactions use testnet tokens and don't cost real money.

For Developers

Use tool functions directly in your TypeScript code:

import { AgentWallex, checkBalance, pay } from "@agentwallex/openclaw";
 
const client = new AgentWallex({ apiKey: "awx_..." });
const agentId = "your-agent-id";
 
const balance = await checkBalance(client, agentId, { chain: "base" });
console.log(balance.available); // "100.50"
 
const tx = await pay(client, agentId, {
  to: "0xRecipientAddress",
  amount: "10.00",
});
console.log(tx.transaction_id); // "tx-abc123"

Available Exports

// Plugin entry point
import register from "@agentwallex/openclaw";
 
// Tool functions
import { createAgent, listAgents, createWallet, pay, checkBalance, txStatus } from "@agentwallex/openclaw";
 
// Static tool schema
import { openClawToolSchema } from "@agentwallex/openclaw";
 
// Local credential store
import { loadConfig, saveConfig, isConfigured, requireConfig } from "@agentwallex/openclaw";
 
// SDK client (re-exported)
import { AgentWallex } from "@agentwallex/openclaw";

Next Steps