OpenClaw Extension

OpenClaw Extension is a suite of tools developed by BANK OF AI to empower AI Agents with financial sovereignty. It enables agents to hold wallets, execute transactions, and monetize services using the x402 Protocol (HTTP 402 Payment Required).

🚀 Mission

To build the "Central Bank" for the agent economy, ensuring every AI agent can:

• Earn: Accept payments for tasks and services via standard protocols.
• Spend: Pay for resources (computation, data, storage) autonomously.
• Connect: Facilitate direct Agent-to-Agent (A2A) financial activities and settlements.
• Transact: Interact with DeFi and smart contracts seamlessly.

📦 Core Components

This extension provides two main components:

1. MCP Servers

Multi-chain blockchain access for AI agents via Model Context Protocol (MCP):

• mcp-server-tron - TRON blockchain interaction

  • Balance checks, transfers, smart contract calls
  • Resource estimation (Energy/Bandwidth)
  • Multi-network support (Mainnet, Nile, Shasta)

• bnbchain-mcp - BNB Chain official MCP server

  • Multi-chain support: BSC, opBNB, Ethereum, Greenfield
  • Wallet operations, smart contracts, token transfers
  • Cross-chain capabilities

• BANK OF AI recharge MCP - Remote BANK OF AI recharge MCP

  • Default remote endpoint: https://recharge.bankofai.io/mcp
  • Exposed through mcporter as bankofai-recharge
  • Intended for BANK OF AI recharge flows

2. Skills

Pre-built workflows and tools from the skills repository:

The installer lets you choose which skills to install during setup. By default, it installs from the pinned skills tag v1.5.8, which matches the current published skills release.

Current skills in skills@v1.5.8 include:

• agent-wallet - Create wallets, inspect addresses, and sign blockchain transactions or messages with the AgentWallet CLI.
• bankofai-guide - Post-install onboarding guide for BofAI skills, including wallet setup and basic guardrails.
• multisig-permissions - Manage TRON multi-sig permissions, thresholds, and co-signed proposals.
• recharge-skill - Query BANK OF AI account state and recharge through the BANK OF AI remote MCP endpoint.
• sunperp-skill - Trade USDT-margined perpetual futures on SunPerp and manage positions on TRON.
• sunswap - Swap tokens, manage liquidity, and query DEX market data on SunSwap.
• trc20-toolkit-skill - Run generic TRC20 token operations such as transfer, approve, balance, and metadata queries.
• tronscan-skill - Query TRON blockchain data through the TronScan API.
• trx-staking-skill - Stake TRX, vote for Super Representatives, and claim TRON voting rewards.
• usdd-skill - Use USDD / JUST Protocol flows including PSM swaps, vault queries, and balance checks.
• x402-payment - Pay x402-enabled agent endpoints using supported EVM or TRON stablecoins.

For available skills, documentation, and usage instructions, see the skills repository.

🛠 Installation

Prerequisites

• OpenClaw (Your personal, open-source AI assistant) - Install from here
• Node.js (v18+)
• Git (for cloning skills repository)
• AgentWallet CLI v2.3.1 (installer enforces this version, docs: agent-wallet README)
• Windows only: PowerShell 5.1+ (included with Windows 10/11)

Note: This installer uses OpenClaw's configuration system. Make sure OpenClaw is installed before running this installer.

Quick Start

Linux / macOS

One-command installation:

curl -fsSL https://raw.githubusercontent.com/BofAI/openclaw-extension/refs/heads/main/install.sh | bash

Or from source:

git clone https://github.com/BofAI/openclaw-extension.git
cd openclaw-extension
./install.sh

Windows

One-command installation (PowerShell):

irm https://raw.githubusercontent.com/BofAI/openclaw-extension/refs/heads/main/install.ps1 | iex

Or from source:

git clone https://github.com/BofAI/openclaw-extension.git
cd openclaw-extension
install.bat

Note: Windows requires Windows 10 (build 1511+) or later for ANSI color support. install.bat is a thin launcher that invokes install.ps1 with the correct execution policy — no manual configuration needed.

Installer Flow

The installer now runs in this order:

1. Installation mode selection
   • Normal install (default)
   • Clean install (deletes existing AgentWallet data, clears all MCP entries, and removes all installed skills before reinstalling)
2. AgentWallet setup
   • Normal install runs agent-wallet start --save-runtime-secrets
   • Clean install runs agent-wallet start --override --save-runtime-secrets
   • Initialization prompts are handled by AgentWallet CLI itself
   • For AgentWallet mode details, see agent-wallet README
3. MCP and skills installation
   • MCP/skills installation prompts stay focused on MCP/skill configuration itself

What Gets Installed

• ✅ MCP servers - TRON, BSC, and optional BANK OF AI recharge MCP entries configured in ~/.mcporter/mcporter.json
• ✅ Skills - Pre-built workflows installed to your chosen location
• ✅ Available components: See mcp-server-tron, bnbchain-mcp, bankofai-recharge (https://recharge.bankofai.io/mcp), and skills repository

Note: This installer uses mcporter (OpenClaw's official MCP manager) for configuration. Ensure OpenClaw is installed first. bnbchain-mcp currently does not support AgentWallet and still uses PRIVATE_KEY.

🔐 Security

Wallet Configuration

The installer configures wallet usage through AgentWallet first:

AgentWallet initialization

• Installer launches agent-wallet start --save-runtime-secrets in normal mode
• Installer launches agent-wallet start --override --save-runtime-secrets in clean mode
• Detailed behavior and modes are documented in agent-wallet README

bnbchain-mcp Exception

• bnbchain-mcp currently requires PRIVATE_KEY and is not yet AgentWallet-compatible

Best Practices

• Use dedicated agent wallets with limited funds
• Never use your main personal wallet
• Test on testnets (Nile for TRON, BSC Testnet for BSC) before using mainnet
• Do not allow AI agents to scan files containing wallet secrets

Use at your own risk

Allowing AI agents to handle private keys directly involves substantial security risks. We advise using only small amounts of cryptocurrency and exercising caution. Despite the built-in safeguards, there is no guarantee that your assets are immune to loss. This extension is currently in an experimental stage and has not been subjected to rigorous testing. It is provided without any warranty or assumption of liability. Always validate your setup on testnets (Nile for TRON, BSC Testnet for BSC) before interacting with mainnets.

🤝 Contributing

We welcome contributions! Please see the OpenClaw organization for more details on the underlying technologies.