Crossmint Wallet Plugin

Solana wallet integration for OpenClaw agents using the lobster.cash server flow.

Overview

This plugin enables OpenClaw agents to:

• Generate and manage local Solana signing keys (ed25519)
• Pair with a user wallet using consent-based setup (/api/claw/setup/*)
• Use server-issued tokens for authenticated wallet and order operations
• Check wallet balances
• Send tokens
• Buy products from Amazon

The plugin no longer requires manual API key pasting.

Installation

openclaw plugins install @crossmint/lobster.cash

Configuration

Enable the plugin in ~/.openclaw/.openclaw.json5:

{
  plugins: {
    entries: {
      "lobster.cash": {
        enabled: true,
        config: {
          serverBaseUrl: "https://www.lobster.cash",
          requestTimeoutMs: 15000,
        },
      },
    },
  },
}

If you previously installed an older build that used the openclaw-wallet id, remove that entry and extension to avoid duplicate plugin warnings.

Setup Workflow

Step 1: Start setup

Ask the agent: "Set up my Crossmint wallet"

The plugin will:

1. Generate (or reuse) a local signer keypair
2. Call POST /api/claw/setup/start
3. Sign pairingNonce locally
4. Call POST /api/claw/setup/verify
5. Return a consent URL for the user to open

Step 2: User approves consent URL

Open the URL in browser and approve.

Step 3: Finalize setup

Run crossmint_setup again.

The plugin will:

1. Poll GET /api/claw/setup/status
2. Read retrievalNonce when approved
3. Sign retrievalNonce
4. Call POST /api/claw/setup/retrieve
5. Store walletAddress, accessToken, refreshToken, and expiry locally

Authentication Model

• Protected calls use Authorization: Bearer <accessToken>
• On expiry, plugin refreshes automatically via:
  • POST /api/claw/token/refresh/init
  • POST /api/claw/token/refresh
• Refresh is proof-of-possession gated (signed nonce)

Tools

| Tool | Description | | ------------------------ | ------------------------------------------------------------------- | | crossmint_setup | Start/finalize server-based setup flow | | crossmint_configure | Deprecated (kept for compatibility) | | crossmint_balance | Check wallet balances | | crossmint_send | Send tokens to another address | | crossmint_wallet_info | Get wallet/setup session info | | crossmint_tx_status | Check transaction status | | crossmint_buy | Buy products from Amazon with SOL or USDC | | crossmint_order_status | Check order status (uses stored order client secret when available) |

Order Flow

For purchases, plugin uses proxy endpoints:

1. POST /api/proxy/orders
2. POST /api/proxy/wallets/:wallet/transactions (serialized transaction)
3. Local signature + POST /api/proxy/wallets/:wallet/transactions/:txId/approve
4. POST /api/proxy/orders/:orderId/payment with x-order-client-secret

Local Storage

Plugin state is stored at:

• ~/.openclaw/crossmint-wallets/wallets.json
• or CROSSMINT_WALLETS_DIR if set

Per agent it stores:

• local signer keypair
• pairing/setup state
• wallet address
• access/refresh tokens
• order client secrets for follow-up status calls

Migration Note

If you previously configured wallet + API key manually, run crossmint_setup again to migrate.