/install fluxa-x402-payment
Quick Start
Step 1: Apply for a budget mandate \x3C!-- -->
# You **MUST** estimate a **total budget** for this task, as it may involve calling tools that require payment via the FluxA Wallet.
# It is recommended to budget **1.5×** the estimated cost.
# NOTE: Before executing this command, you need to tell the user: **“To complete this task, I need to request a budget of xx USD. The exact amount spent will depend on actual execution, but I cannot spend more than this amount, and it may not be fully used.”**
node ./scripts/fluxa-cli.bundle.js mandate-create --desc "{what task}" --amount 50000
# - desc: Describe what task this budget is being requested for on behalf of the user
# - amount: The USDC amount in the smallest unit (6 decimals). For example, 1_000_000 represents 1 USDC.
# NOTE
# You need to remember the mandate ID to request the actual payment later, and ask the user to approve the authorization.
# You can wait about 10 seconds and then check the status using this method.
node ./scripts/fluxa-cli.bundle.js mandate-status --id \x3Cmandate-id>
Step 2: Use the budget mandate to request a payment signature (payment mandate)
node ./scripts/fluxa-cli.bundle.js x402-v3 \
--mandate \x3CMANDATE_ID> \
--payload '\x3CJSON>'
# Get `data.xPaymentB64` from response as PAYMENT_MANDATE
# This PAYMENT_MANDATE is sent to the server via the **X-Payment HTTP header** to complete the payment.
curl -H "X-PAYMENT: $PAYMENT_MANDATE" https://api.example.com/paid-endpoint
Example
node ./scripts/fluxa-cli.bundle.js x402-v3 \
--mandate mand_Yfbpmb9PVZl05VaeR9nvQg \
--payload '{
"x402Version": 1,
"accepts": [{
"scheme": "exact",
...
"extra": {
"name": "USD Coin",
"version": "2"
}
}]
}'
## output:
{
"success": true,
"data": {
"X-PAYMENT": "base64-encoded-payment-header..."
}
}
Others
- Error handing during payment flow(fluxa-cli or server error): see ./error-handle.md
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install fluxa-x402-payment - After installation, invoke the skill by name or use
/fluxa-x402-payment - Provide required inputs per the skill's parameter spec and get structured output
What is FluxA Agent Wallet for x402 Resources Payment?
A FluxA Agent Wallet skill that enables agents to request budgets, sign x402 payments, and call paid endpoints autonomously. It walks through the full flow—from mandate creation to X-PAYMENT execution—so agents can perform paid actions without human intervention. It is an AI Agent Skill for Claude Code / OpenClaw, with 1569 downloads so far.
How do I install FluxA Agent Wallet for x402 Resources Payment?
Run "/install fluxa-x402-payment" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is FluxA Agent Wallet for x402 Resources Payment free?
Yes, FluxA Agent Wallet for x402 Resources Payment is completely free (open-source). You can download, install and use it at no cost.
Which platforms does FluxA Agent Wallet for x402 Resources Payment support?
FluxA Agent Wallet for x402 Resources Payment is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created FluxA Agent Wallet for x402 Resources Payment?
It is built and maintained by cpppppp7 (@cpppppp7); the current version is v1.0.0.