fluxa-agent-wallet

FluxA Agent Wallet

Skill version: 0.5.0 | CLI version: @fluxa-pay/[email protected] — MUST install or update to the latest CLI version before use.

FluxA Agent Wallet is a co-wallet that allows AI agents to securely use a user’s wallet, enabling them to perform payment-related actions within the user’s approved scope. Capabilities include x402 payments, USDC transfers, agent-to-agent transfers, payment links for receiving payments, prepaid virtual cards, AI social gifting, discovering and calling x402 resources (one-shot APIs), and using payment-related skills (one-shot skills). Use this tool when the user the user asks to perform any of these payment-related actions.

Hard Rules

• Confirm every topup or spend with the user before initiating it. Present the cost first and get an explicit choice. Each charge must be a known, deliberate spend.
• Never write payment code. No x402 signing or mandate logic in app code. Agents use the wallet CLI; apps use API keys.
• Report costs honestly. Surface X-LLM-Cost-Credits after FluxA Monetize model calls; a negative balance is unsettled debt (usage consumed but not yet paid). Say so plainly.

Setup

Step 1 — Install the CLI

npm install -g @fluxa-pay/[email protected]

Then run commands directly:

fluxa-wallet <command> [options]

Step 2 — Init Wallet

Before any operation, the agent must have an Agent ID.

First, check if the agent is already initialized:

fluxa-wallet status

If configured is true, the agent is already initialized — skip the init step. If init has already been run, running it again will be ignored.

If not initialized, register once:

fluxa-wallet init \
  --name “eg. My AI Agent” \
  --client “eg. OpenClaw v1.0.0”

The CLI will save Agent ID credential in ~/.fluxa-ai-wallet-mcp/config.json.

Link to user’s wallet: After init, check if the agent is already linked:

fluxa-wallet check-wallet