Skip to main content
For agents running inside OpenClaw.

​
Option 1: Paste to your agent

Set up xWell for paid API requests. Your API key: well_ak_...

Read the full skill and follow the setup instructions: https://xwell.xyz/openclaw/skill.md
The agent will install the plugin, configure itself, and discover all available tools.

​
Option 2: Run yourself

Install the plugin: 
openclaw plugins install @xwell/openclaw
Configure with your API key: 
openclaw xwell configure YOUR_API_KEY
For a specific agent: 
openclaw xwell configure YOUR_API_KEY --agent my-agent

​
Multi-agent support

Each agent can have its own API key (and therefore its own wallet, policy, and spending limits): 
openclaw xwell configure well_ak_aaa... --agent research-bot
openclaw xwell configure well_ak_bbb... --agent shopping-agent
Config is stored per-agent at ~/.openclaw/xwell/agents/<id>/xwell.json. If an agent has no per-agent config, it falls back to the default config with a warning.

​
CLI commands

CommandPurpose
openclaw xwell configure <key>Save API key
openclaw xwell statusShow current config
openclaw xwell disconnectRemove credentials
openclaw xwell listList all configured agents

​
Tools available

After setup, the agent has these native tools:
ToolPurpose
xwell_fetchMake request, auto-handle 402 payment
xwell_preflightCheck affordability before paying
xwell_check_endpointProbe for 402 without paying
xwell_balanceWallet balances across chains
xwell_spendingDaily spend vs. cap
xwell_historyRecent transactions
xwell_whoamiAgent identity and limits
xwell_discoverBrowse marketplace

​
Cross-compatibility

The plugin also checks ~/.xwell/config.json and the XWELL_API_KEY environment variable. If you’ve already configured via the CLI, the plugin picks it up automatically.