Open Broker

Installation

Open Broker is available as a Codex skill, a standalone CLI, and optional agent integrations:

• openbroker — the trading CLI itself. Standalone, works without OpenClaw.
• Codex skill — teaches Codex safe OpenBroker installation, API-wallet onboarding, trading, and automation workflows.
• openbroker-plugin — OpenClaw plugin packaging (manifest + agent tools + position watcher). Depends on openbroker.
• openbroker-monitoring (optional) — dashboard / metrics forwarder. Auto-loaded at runtime when present. See Monitoring.
• openbroker-extended (optional) — Extended Exchange trading CLI, installed and operated separately from Hyperliquid commands.

Pick the path that matches how you'll use it.

Codex skill + CLI

For Codex, one command installs the skill and CLI and starts restricted API-wallet onboarding:

npx openbroker@latest install --codex

See the Codex installation guide for the browser approval and verification steps.

OpenClaw plugin (recommended for agents)

openclaw plugins install openbroker-plugin
openclaw gateway restart
openbroker setup

This installs the plugin manifest + agent tools and pulls the openbroker CLI in as a transitive dependency.

CLI only

npm install -g openbroker
openbroker setup --api-wallet

Use this if you want the trading CLI without the OpenClaw plugin packaging — for servers running automations standalone, or for local CLI use.

Optional companion packages

openbroker install --list
openbroker install monitoring
openbroker install extended

The installer only accepts packages registered by OpenBroker. Re-run a package command to upgrade it to the latest release.

OpenClaw Skill (ClawHub)

Open Broker is also available as an OpenClaw skill on ClawHub. Reference the skill from any OpenClaw agent without an explicit install.

Quick Start

openbroker setup --api-wallet

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 defaults to a restricted API wallet. Use the explicit flag for deterministic agent onboarding:

openbroker setup --api-wallet

The setup wizard offers three modes:

• Generate fresh wallet — creates a separately funded trading wallet with the builder fee auto-approved.
• Import existing key — use a private key you already have (master wallet). Builder fee is approved automatically.
• Generate API wallet (default and recommended for agents) — 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).

API Wallet Setup (Recommended for Agents)

API wallets trade on behalf of the funded master account but cannot withdraw funds.

1. Run openbroker setup --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 --api-wallet.

Fresh Wallet Setup (Alternative)

Run interactive openbroker setup and explicitly choose Generate fresh wallet when you want a separately funded wallet instead of delegated API access.