Feature: Economy / Wallet panel — native USDC payment surfaces for OpenClaw OS

[shawnhvac]

The Gap

OpenClaw OS has first-class surfaces for sessions, apps, artifacts, notifications, and crons. There is no payment surface. Agents can earn and spend — but there is nowhere in the workspace to see it happening.

As agents start doing real work (paid API calls, task bounties, agent-to-agent services), the workspace needs an economy layer.

What We Are Proposing

1. Wallet sidebar panel

A collapsible sidebar section showing:

• Connected Base L2 wallet address
• USDC balance (live, polled or websocket)
• Recent inbound/outbound transactions
• Total earned this session

2. OpenUI Lang payment components

Two new components for the OpenUI renderer that agents can emit natively:

<PaymentRequest amount="1.50" currency="USDC" to="0xAGENT" memo="API call result" />
<PaymentConfirmed txHash="0x..." amount="1.50" from="0xUSER" />

This means an agent can stream a payment request directly into the workspace as a live interactive component — the user clicks Approve, USDC settles on Base L2, the agent continues.

3. before_prompt_build wallet injection

Optional: inject wallet context (balance, address) into the system prompt via the existing before_prompt_build hook, so agents are aware of their economic state before they act.

Why Now

The OpenUI Lang architecture is perfect for this. Components stream in as the model writes them — a <PaymentRequest /> component fits naturally alongside charts and tables. The gateway plugin model means a payment plugin could ship the same way openclaw-os ships: one install, registered on the gateway, no separate hosting.

What We Have Built

We have been running a live x402 USDC facilitator on Base L2 at x402-agent-pay.com since early 2026. We power AgentWorld — a live simulation of 125+ autonomous agents transacting with each other in real time on Base L2.

We published an OpenClaw-native SKILL.md this week:

• GitHub: https://github.com/shawnhvac/agentpay-x402
• Install: openclaw skills install agentpay-x402

We would love to contribute:

• The wallet panel UI (React, fits the existing sidebar pattern)
• The <PaymentRequest /> and <PaymentConfirmed /> OpenUI components
• Backend facilitator endpoints (already live and documented)

Happy to open a PR or discuss the right architecture first — whatever works best for the project.

Facilitator: https://x402-agent-pay.com
AgentWorld live demo: https://agentworld.me
ClawHub skill: https://github.com/shawnhvac/agentpay-x402

— Shawn Lippert, AgentPay

[shawnhvac]

Following up on the proposal above — I have written the actual components and pushed them so you can evaluate the code quality before deciding whether to accept a PR.

Code

https://github.com/shawnhvac/agentpay-x402/tree/main/openui-components

Files

File	Description
PaymentRequest.tsx	Interactive payment card — agent emits, user approves, USDC settles
PaymentConfirmed.tsx	Inbound payment receipt card with Basescan link
WalletPanel.tsx	Collapsible sidebar wallet widget, polls balance every 15s
payment.scss	Component styles — matches claw-client design tokens
wallet.scss	Wallet panel styles

OpenUI Lang usage (what the agent emits)

<PaymentRequest amount="1.50" currency="USDC" to="0xRecipient" memo="API call result" />
<PaymentConfirmed txHash="0xabc..." amount="1.50" from="0xSender" memo="Job complete" />

Happy to open a proper fork + PR whenever you are ready to review — wanted to share the code first so you can see what you are getting. Let me know if you want any changes to the component API or styles.

— Shawn, AgentPay