Agent Wallet (Lobster)
/install lobster-agent-wallet
🦞 Agent Wallet Skill
USDC wallet for AI agents on Base with x402 payment protocol support.
⚠️ Security
This skill interacts with real blockchain assets. Every precaution is taken.
| Rule | Status |
|---|---|
| Private key from env var only | ✅ WALLET_PRIVATE_KEY / .env |
| Private key never logged | ✅ Zero logging of key material |
| Payments need explicit --confirm | ✅ Double security gate |
| Address separate from key | ✅ WALLET_ADDRESS for read-only mode |
Phase 1 — Read-Only (Zero Dependencies)
export WALLET_ADDRESS=0x...
export WALLET_NETWORK=base-sepolia
node wallet.mjs balance
Phase 2 — x402 Payments (Requires viem)
npm install viem
export WALLET_PRIVATE_KEY=0x... # your wallet key (keep secret!)
export WALLET_ADDRESS=0x... # derived from key, or set manually
export WALLET_NETWORK=base-sepolia # or "base" for mainnet
node wallet.mjs pay \x3Curl> --confirm
CLI Reference
| Command | Requires | Description |
|---|---|---|
balance |
WALLET_ADDRESS | Check USDC + ETH balance |
status |
WALLET_ADDRESS | Show wallet config (safe) |
pay \x3Curl> |
+ PRIVATE_KEY + --confirm | Pay x402 resource |
Architecture
agent-wallet/
├── SKILL.md ← Usage docs
├── package.json ← Zero deps (viem optional for Phase 2)
├── .env.example ← Config template
├── wallet.mjs ← CLI entry point
└── lib/
├── core.mjs ← Core wallet (native fetch RPC, no deps)
├── crypto.mjs ← EIP-3009 signing (viem-powered)
└── x402-client.mjs ← x402 payment protocol client
Networks
| Network | Chain ID | RPC | Explorer |
|---|---|---|---|
| Base | 8453 | mainnet.base.org | basescan.org |
| Base Sepolia | 84532 | sepolia.base.org | sepolia.basescan.org |
Integration (for agents/skills)
import { getWallet, getBalances } from './lib/core.mjs';
// Read-only — safe
const wallet = await getWallet();
const { eth, usdc } = await getBalances(wallet);
// Payments (requires viem)
const { payX402 } = await import('./lib/x402-client.mjs');
const result = await payX402(url, privateKey, { confirm: true });
License MIT-0
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install lobster-agent-wallet - After installation, invoke the skill by name or use
/lobster-agent-wallet - Provide required inputs per the skill's parameter spec and get structured output
What is Agent Wallet (Lobster)?
Manage a USDC wallet for AI agents on Base, supporting balance checks and secure x402 payments with configurable network and key settings. It is an AI Agent Skill for Claude Code / OpenClaw, with 21 downloads so far.
How do I install Agent Wallet (Lobster)?
Run "/install lobster-agent-wallet" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Wallet (Lobster) free?
Yes, Agent Wallet (Lobster) is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agent Wallet (Lobster) support?
Agent Wallet (Lobster) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Wallet (Lobster)?
It is built and maintained by chengtang05-hash (@chengtang05-hash); the current version is v0.1.0.