Open Broker

Installation

Open Broker can be installed as a standalone CLI, as a native OpenClaw plugin, or used as an OpenClaw skill from ClawHub.

OpenClaw Skill (ClawHub)

Open Broker is also available as an OpenClaw skill on ClawHub. Add it to any agent conversation without installing anything — just reference the skill from your OpenClaw agent.

Standalone CLI

Install globally via npm to use Open Broker directly from your terminal.

npm install -g openbroker

OpenClaw Plugin

Install Open Broker as a native plugin on your OpenClaw machine. This gives your OpenClaw agents direct access to all trading tools.

openclaw plugins install openbroker

After installing, restart the gateway for the plugin to take effect:

openclaw gateway restart

Quick Start

openbroker setup

openbroker account                          # View account info
openbroker buy --coin HYPE --size 0.1        # Market buy
openbroker search --query GOLD              # Find markets

Setup

Interactive one-command setup that handles wallet creation, config, and builder fee approval.

openbroker setup

The setup wizard offers three modes:

• Generate fresh wallet (recommended for agents) — creates a dedicated trading wallet with the builder fee auto-approved. No browser steps needed — just fund with USDC and start trading.
• Import existing key — use a private key you already have (master wallet). Builder fee is approved automatically.
• Generate API wallet — creates a restricted wallet that can trade but cannot withdraw. Requires browser approval from your master wallet.

Config is saved to ~/.openbroker/.env (permissions 0600).

Fresh Wallet Setup (Recommended for Agents)

The simplest setup for agents. A fresh wallet is generated, the builder fee is auto-approved, and the agent is ready to trade immediately after funding.

1. Run openbroker setup and choose "Generate a fresh wallet"
2. The CLI generates a wallet, saves the config, and approves the builder fee automatically
3. Fund the wallet by sending USDC from your Hyperliquid account to the agent's wallet address using the Send feature on app.hyperliquid.xyz. Note: funding should be done on Hyperliquid L1 only.

4. Start trading

API Wallet Setup (Alternative)

API wallets can place trades on behalf of a master account but cannot withdraw funds. Use this if you prefer to keep funds in your existing wallet and only delegate trading access.

1. Run openbroker setup and choose "Generate API wallet"
2. The CLI generates a keypair and prints an approval URL (e.g. https://openbroker.dev/approve?agent=0xABC...)
3. Open the URL in a browser and connect the master wallet (MetaMask, etc.)
4. The master wallet signs two transactions: ApproveAgent (authorizes the API wallet) and ApproveBuilderFee (approves the 1 bps fee)
5. The CLI detects the approval automatically and saves the config

After setup, the config will contain:

HYPERLIQUID_PRIVATE_KEY=0x...        # API wallet private key
HYPERLIQUID_ACCOUNT_ADDRESS=0x...    # Master account address
HYPERLIQUID_NETWORK=mainnet

For agents: pass the approval URL to the agent owner (the human who controls the master wallet). The owner must approve in a browser before the agent can trade. The CLI waits up to 10 minutes for the approval — if it times out, re-run openbroker setup.