← Back to Skills Marketplace
ya7ya

Open-broker

by Yahya · GitHub ↗ · v1.0.89 · MIT-0
cross-platform ✓ Security Clean
2933
Downloads
9
Stars
4
Active Installs
37
Versions
Install in OpenClaw
/install openbroker
Description
Hyperliquid trading plugin with background position monitoring and custom automations. Execute market orders, limit orders, manage positions, view funding ra...
Usage Guidance
This skill appears to do what it says, but it needs your HYPERLIQUID_PRIVATE_KEY — which grants the ability to sign trades and control funds. Before installing: 1) Verify the npm package publisher and reviews (ensure the package you run is the legitimate 'openbroker'). 2) Consider running the CLI in an isolated environment or container and inspect the installed package/binary. 3) Use a wallet/private key with limited funds (or testnet) for initial testing. 4) Prefer using --dry and --json flags when possible to verify behavior without executing live trades. 5) Be aware the CLI may write/read local config files created by `openbroker setup` that could store keys or state.
Capability Analysis
Type: OpenClaw Skill Name: openbroker Version: 1.0.89 The openbroker skill bundle provides a comprehensive interface for Hyperliquid DEX trading, including market operations, account management, and event-driven TypeScript automations. While the skill requires high-risk permissions—specifically access to the HYPERLIQUID_PRIVATE_KEY and the ability to execute shell commands via the openbroker binary—the behavior described is entirely consistent with its stated purpose. The SKILL.md instructions for the AI agent are safety-oriented, emphasizing risk management, liquidation monitoring, and transparent communication with the user via webhooks (api.publish). No evidence of malicious intent, credential exfiltration, or deceptive prompt injection was found.
Capability Tags
cryptorequires-walletcan-make-purchasesrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description, required binary (openbroker), and primary env var (HYPERLIQUID_PRIVATE_KEY) all align with a trading CLI that must sign orders for Hyperliquid. The listed plugin tools map directly to CLI commands and the npm install spec matches the claimed binary.
Instruction Scope
SKILL.md instructs the agent to run openbroker CLI commands (and to fall back to Bash invoking the CLI). It also references running `openbroker setup` which generates a wallet/config and may create or read local files holding credentials. This is within the skill's trading purpose but means the agent will execute CLI commands and read/write local config files as part of normal operation.
Install Mechanism
Install uses the public npm package 'openbroker' which is the expected distribution method for a Node CLI. NPM installs carry the usual moderate risk (unreviewed code executed on install), but there is no downloader from arbitrary URLs or archive extraction from unknown hosts.
Credentials
Only HYPERLIQUID_PRIVATE_KEY is required and listed as the primary credential. That is proportionate for a trading agent that must sign orders. No unrelated credentials or file paths are requested.
Persistence & Privilege
The skill is not marked always:true and does not request elevated platform privileges. It can be invoked autonomously (default), which is expected for skills; that combined with access to a signing private key is powerful but coherent for a trading tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openbroker
  3. After installation, invoke the skill by name or use /openbroker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.89
- Version bump from 1.0.88 to 1.0.89 with no file changes detected. - Metadata updated to reflect the new version. - splitting monitoring into a separate package
v1.0.88
openbroker 1.0.88 - Updated version metadata from 1.0.85 to 1.0.88. - fee math fixes
v1.0.85
- Added documentation for unique asset IDs (assetId) for accurate coin disambiguation and referencing in JSON outputs. - Updated the CLI fallback and plugin tool table to cover additional info commands such as spot, trades, fees, order-status, rate-limit, and funding-history. - Clarified that all info commands support `--json` output for structured responses. - Minor improvements and clarifications throughout the readme for easier usage and troubleshooting.
v1.0.82
- Version metadata updated from 1.0.80 to 1.0.82. - Testnet support added - custom config flag -c
v1.0.80
- Version bump to 1.0.80. - Automated audit & reporting
v1.0.79
- Added new plugin tools: ob_spot_buy and ob_spot_sell for spot trading. - Expanded allowed-tools list to include ob_spot_buy and ob_spot_sell. - Updated metadata version from 1.0.75 to 1.0.79.
v1.0.75
Version 1.0.75 Changelog: - WS Integration
v1.0.71
- Added new TWAP management plugin tools: ob_twap_cancel and ob_twap_status. - Expanded allowed-tools list to support TWAP order management. - Updated metadata version to 1.0.71.
v1.0.69
- Version bump to 1.0.69. - detailed automation API client methods
v1.0.68
- Version updated to 1.0.68
v1.0.67
- Updated documentation for wallet funding: fresh wallets should now be funded by sending USDC from your Hyperliquid account using Hyperliquid L1 only. - Bumped internal metadata version to 1.0.67.
v1.0.66
- Version bump: updated version metadata to 1.0.66. - cancel orders fix
v1.0.65
No user-facing changes detected in this release. - Version updated to 1.0.65 - Automations v1
v1.0.64
No user-facing changes in this version. - Internal version update to 1.0.64. - fix for updateLeverage on the plugin execution workflow
v1.0.63
openbroker 1.0.63 - Bump version to 1.0.63 in metadata. - No other changes detected.
v1.0.62
- Version bump from 1.0.61 to 1.0.62 with no code or SKILL.md content changes detected. - All functionality, commands, and compatibility remain unchanged.
v1.0.61
- Added support for custom automations and event-driven automation scripts. - Introduced new tools: ob_auto_run, ob_auto_stop, and ob_auto_list for managing automation scripts. - Updated description to reflect automation capabilities. - Enhanced background position monitoring with custom automation features. - Expanded CLI command reference and plugin tool equivalents to include automation commands.
v1.0.60
- Version bump to 1.0.60 in skill metadata.
v1.0.59
**This release adds troubleshooting guidance for plugin tool errors and recommends CLI command fallbacks.** - Added a "Troubleshooting: CLI Fallback" section describing how to use CLI equivalents if any `ob_*` plugin tool fails or returns unexpected results. - Included a table mapping each plugin tool to its CLI command for easy reference. - Provided notes on when to use CLI commands (e.g., for better error handling, more verbose output, or long-running operations). - No code changes; documentation and user guidance improved for reliability.
v1.0.57
- Version bump from 1.0.56 to 1.0.57. - json mode
Metadata
Slug openbroker
Version 1.0.89
License MIT-0
All-time Installs 4
Active Installs 4
Total Versions 37
Frequently Asked Questions

What is Open-broker?

Hyperliquid trading plugin with background position monitoring and custom automations. Execute market orders, limit orders, manage positions, view funding ra... It is an AI Agent Skill for Claude Code / OpenClaw, with 2933 downloads so far.

How do I install Open-broker?

Run "/install openbroker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Open-broker free?

Yes, Open-broker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Open-broker support?

Open-broker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Open-broker?

It is built and maintained by Yahya (@ya7ya); the current version is v1.0.89.

💬 Comments