@crossmint/lobster.cash

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:

• Generate (or reuse) a local signer keypair
• Call POST /api/claw/setup/start
• Sign pairingNonce locally
• Call POST /api/claw/setup/verify
• 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:

• Poll GET /api/claw/setup/status
• Read retrievalNonce when approved
• Sign retrievalNonce
• Call POST /api/claw/setup/retrieve
• 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:

• POST /api/proxy/orders
• POST /api/proxy/wallets/:wallet/transactions (serialized transaction)
• Local signature + POST /api/proxy/wallets/:wallet/transactions/:txId/approve
• 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.