Getting Started

This guide demonstrates how to enable AI agents to execute autonomous x402 transactions using ClawFirst's MCP-native architecture.

Prerequisites

Before integrating ClawFirst, ensure you have:

• AI Agent Framework - OpenClaw, LangChain, AutoGPT, or custom MCP-compatible agent runtime

• Solana Wallet - Agent wallet keypair for transaction signing (generated during setup)

• Node.js 18+ or Python 3.9+ - Required for MCP server runtime

• Basic MCP Knowledge - Familiarity with Model Context Protocol (optional but recommended)

What We're Building

This guide covers three integration approaches:

1. OpenClaw Native Integration - Drop-in Python provider for OpenClaw agents (recommended)

2. Standalone MCP Server - Framework-agnostic server for any MCP-compatible agent

3. Docker Deployment - Containerized deployment for production environments

Installation

Option 1: OpenClaw Native Provider (Recommended)

Install the ClawFirst provider for OpenClaw agents:

pip install clawfirst-openclaw

Option 2: Standalone MCP Server

Install the global MCP server:

# Using npm
npm install -g @clawfirst/mcp-server

# Using pip
pip install clawfirst-mcp

Option 3: Docker Deployment

Run ClawFirst as a containerized service:

docker pull clawfirst/mcp-server:latest
docker run -d -p 3402:3402 \
  -v ~/.config/solana:/wallet \
  -e CLAWFIRST_NETWORK=mainnet-beta \
  clawfirst/mcp-server

Setup: Generate Agent Wallet

Create a dedicated wallet for your agent's transaction signing:

# Using Solana CLI
solana-keygen new --outfile ~/.config/solana/agent.json

# Fund the wallet (testnet for development)
solana airdrop 2 ~/.config/solana/agent.json --url devnet

# Check balance
solana balance ~/.config/solana/agent.json --url devnet

Security Note: Store agent wallet keypairs securely. For production deployments, use hardware security modules (HSM) or key management services like AWS KMS, Google Cloud KMS, or HashiCorp Vault.

Quick Start: OpenClaw Integration

Step 1: Configure Agent with X402Provider

from openclaw import Agent
from clawfirst import X402Provider

# Instantiate agent with x402 payment capabilities
agent = Agent(
    name="payment_assistant",
    providers=[
        X402Provider(
            network="mainnet-beta",
            wallet_path="~/.config/solana/agent.json",
            approval_policy={
                "auto_approve_threshold": "100 USDC",
                "require_human_approval": True,
                "daily_limit": "1000 USDC"
            }
        )
    ]
)

Step 2: Execute Autonomous Payments

# Agent autonomously executes payment based on natural language
response = agent.run(
    "Pay the invoice from Acme Corp for $250 using USDC"
)

print(f"Transaction signature: {response.tx_signature}")
print(f"Settlement status: {response.settlement_status}")
print(f"Block height: {response.block_height}")

Step 3: Verify Settlement

# Query transaction confirmation status
status = agent.run(
    "Check if the Acme Corp payment has been confirmed"
)

print(f"Confirmations: {status.confirmations}")
print(f"Finalized: {status.finalized}")

Quick Start: Standalone MCP Server

Step 1: Create Approval Policy

Create an approval policy configuration file:

approval-policy.json:

{
  "tiers": [
    {
      "threshold": "100 USDC",
      "auto_approve": true
    },
    {
      "threshold": "1000 USDC",
      "require_human_approval": true,
      "approvers": ["[email protected]"]
    },
    {
      "threshold": "10000 USDC",
      "require_multisig": true,
      "approvers": ["[email protected]", "[email protected]"],
      "required_signatures": 2
    }
  ],
  "daily_limit": "5000 USDC",
  "monthly_limit": "50000 USDC",
  "vendor_whitelist": [
    "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin"
  ]
}

Step 2: Launch MCP Server

clawfirst serve \
  --network mainnet-beta \
  --rpc-url https://api.mainnet-beta.solana.com \
  --wallet ~/.config/solana/agent.json \
  --port 3402 \
  --approval-policy-file ./approval-policy.json \
  --log-level info

Server Output:

ClawFirst MCP Server v1.0.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Network: mainnet-beta
Wallet: 9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin
Port: 3402
Approval Policy: ./approval-policy.json
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ MCP server listening on http://localhost:3402
✓ Tools registered: 6
✓ WebSocket stream available at ws://localhost:3402/stream