Extension

README

# 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](https://github.com/bankofai/mcp-server-tron)** - TRON blockchain interaction
  - Balance checks, transfers, smart contract calls
  - Resource estimation (Energy/Bandwidth)
  - Multi-network support (Mainnet, Nile, Shasta)

- **[bnbchain-mcp](https://github.com/bnb-chain/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](https://github.com/BofAI/skills)**:

The installer lets you choose which skills to install during setup. This release pins the skills repository to `v1.5.15`, which includes the CLI-based x402 payment workflow.

The pinned skills snapshot includes:
- `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.
- `sunpump-agent-skill` - Create and trade meme tokens on SunPump, and query token info, rankings, holders, and trade history.
- `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.
- `twitter-digest` - Generate X/Twitter daily digests, analyzing mentions, home timeline, and reply opportunities.
- `twitter-mcp` - Install or authorize xurl for X/Twitter and generate digests from the local xurl CLI, with an optional hosted MCP bridge.
- `x402-payment` - Pay x402-enabled agent endpoints using `@bankofai/x402-cli@1.0.1`, including TRON Permit2 and GasFree flows.

For available skills, documentation, and usage instructions, see the [skills repository](https://github.com/BofAI/skills).

## 🛠 Installation

### Prerequisites
- **OpenClaw** (Your personal, open-source AI assistant) - [Install from here](https://github.com/openclaw)
- **Node.js** `^22.23.4 || ^24.22.1 || >=26.12.1`
- **Git** (for cloning skills repository)
- **AgentWallet CLI v2.3.1** (installer enforces this version, docs: [agent-wallet README](https://github.com/BofAI/agent-wallet/blob/main/README.md))
- **Windows only**: PowerShell 5.1+ (included with Windows 10/11)

The same Node.js requirement applies to all skills, including `x402-payment`. Both installers reject unpatched and prerelease runtimes before installation. The installer installs and verifies its pinned x402 CLI dependency when that skill is present.

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

### Quick Start

#### Linux / macOS

**One-command installation:**

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

Or from source:

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

#### Windows

**One-command installation (PowerShell):**

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

Or from source:

```cmd
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](https://github.com/BofAI/agent-wallet/blob/main/README.md)
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](https://github.com/bankofai/mcp-server-tron), [bnbchain-mcp](https://github.com/bnb-chain/bnbchain-mcp), `bankofai-recharge` (`https://recharge.bankofai.io/mcp`), and [skills repository](https://github.com/BofAI/skills)

**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](https://github.com/BofAI/agent-wallet/blob/main/README.md)

**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](https://github.com/openclaw) organization for more details on the underlying technologies.