Documentation

HydraClaw Docs

Everything you need to deploy and manage AI trading agents. From quickstart to advanced customization.

Quick Start CLI Reference Configuration SDK Guide FAQ

Quick Start

Deploy your first agent in 5 minutes. Choose your strategy.

SniperFast Entry Strategy

# Install HydraClaw CLI
curl -sSf https://hydraclaw.sh/install | sh

# Initialize agent
hydraclaw init --strategy sniper

# Configure (edit hydra.toml)
cat hydra.toml
# [agent]
# name = "alpha-hunter"
# strategy = "sentiment-sniper"
# risk_level = "medium"
# max_position = "500 USDC"
#
# [network]
# rpc = "https://rpc.hydraclaw.io"

# Deploy
hydraclaw deploy

# Output:
# 🐙 HydraClaw Agent deployed!
# ├── Binary: 3.4MB
# ├── Boot: 8ms
# ├── Strategy: sentiment-sniper
# └── Status: HUNTING

Copy-TradeMirror Strategy

# Install HydraClaw CLI
curl -sSf https://hydraclaw.sh/install | sh

# Initialize agent
hydraclaw init --strategy copy-trade

# Configure (edit hydra.toml)
cat hydra.toml
# [agent]
# name = "mirror-alpha"
# strategy = "copy-trade"
# target_wallet = "0x..."
# risk_factor = 0.5
#
# [network]
# rpc = "https://rpc.hydraclaw.io"

# Deploy
hydraclaw deploy

# Output:
# 🐙 HydraClaw Agent deployed!
# ├── Binary: 3.6MB
# ├── Boot: 9ms
# ├── Strategy: copy-trade
# └── Status: MIRRORING

Installation

How to install HydraClaw CLI on various platforms

Linux / macOS

curl -sSf https://hydraclaw.sh/install | sh

Automatic installer script that detects OS and architecture.

Windows

iwr https://hydraclaw.sh/install.ps1 | iex

PowerShell installer for Windows 10/11.

Cargo (Rust)

cargo install hydraclaw-cli

Build from source using Rust package manager.

CLI Reference

Complete list of available commands in HydraClaw CLI

Command	Description	Example
`hydraclaw init`	Initialize new agent project with template config	`hydraclaw init --chain solana --strategy sniper`
`hydraclaw deploy`	Build and deploy agent to local or remote hardware	`hydraclaw deploy --target pi@192.168.1.10`
`hydraclaw status`	Check status of all running agents	`hydraclaw status --verbose`
`hydraclaw logs`	Stream logs from running agent	`hydraclaw logs alpha-hunter --follow`
`hydraclaw stop`	Stop a running agent	`hydraclaw stop alpha-hunter`
`hydraclaw config`	View or edit configuration	`hydraclaw config set rpc https://...`
`hydraclaw wallet`	Manage wallets and keys	`hydraclaw wallet import --keyfile key.json`
`hydraclaw upgrade`	Upgrade CLI to latest version	`hydraclaw upgrade`

Configuration

All agent configuration is in the hydra.toml file. Here is the complete reference.

hydra.toml

# Agent Configuration
[agent]
name = "alpha-hunter"              # Unique identifier for your agent
strategy = "sniper"                # Strategy type: sniper, copy-trade, dca, etc.
enabled = true                     # Enable/disable agent

# Risk Management
[risk]
max_position = "500 USDC"         # Maximum position size per trade
stop_loss = 0.15                  # Stop loss percentage (15%)
take_profit = 2.0                 # Take profit multiplier (2x)
max_daily_loss = "1000 USDC"      # Maximum daily loss limit
trailing_stop = true              # Enable trailing stop loss

# Sniper-specific settings
[sniper]
min_liquidity = "5000 USDC"       # Minimum liquidity to enter
max_mcap = "100000"               # Maximum market cap ($100k)
buy_amount = "50 USDC"            # Buy amount per snipe
slippage = 0.30                   # Slippage tolerance (30%)
priority_fee = "auto"             # Priority fee for fast inclusion

# Copy-trade settings
[copy_trade]
target_wallets = [                # Wallets to copy
  "0xABC...XYZ",
  "0xDEF...UVW"
]
delay_ms = 500                    # Delay before copying (avoid detection)
min_trade_size = "250 USDC"       # Minimum trade to copy
max_copy_amount = "500 USDC"      # Maximum amount per copied trade

# Network Configuration
[network]
rpc = "https://rpc.hydraclaw.io"  # RPC endpoint
ws = "wss://rpc.hydraclaw.io"     # WebSocket endpoint
backup_rpc = [                    # Fallback RPCs
  "https://backup.hydraclaw.io"
]

# Notifications
[notifications]
telegram_bot_token = ""           # Telegram bot token
telegram_chat_id = ""             # Chat ID for notifications
discord_webhook = ""              # Discord webhook URL
notify_on = ["trade", "error"]    # Events to notify

# Logging
[logging]
level = "info"                    # Log level: debug, info, warn, error
file = "logs/agent.log"           # Log file path
rotate = "daily"                  # Log rotation: daily, weekly

SDK Guide

Build custom agents using HydraClaw SDK. Complete documentation for developers.

Agent Lifecycle

Understanding lifecycle hooks and events available for custom agents

on_start()

on_new_token()

on_price_change()

on_stop()

Strategy Interface

Implement Strategy trait for custom trading logic

analyze()

should_enter()

should_exit()

position_size()

Data Sources

Access various data sources for informed trading

DEX pools

Social sentiment

On-chain metrics

Price feeds

Risk Management

Built-in risk management utilities

Position sizing

Stop loss

Take profit

Portfolio limits

Frequently Asked Questions

Answers to commonly asked questions

What are the minimum hardware requirements to run HydraClaw?

HydraClaw can run on very minimal hardware. Minimum: 512MB RAM, 100MB storage, ARM or x86 processor. Examples: Orange Pi Zero ($10), Raspberry Pi Zero ($15), or OpenWRT router.

Are my private keys safe?

Yes. Private keys are stored encrypted on your local hardware. HydraClaw never sends keys to any server. You have full control over your funds. We recommend using a dedicated wallet with limited funds for trading bots.

What fees does HydraClaw charge?

HydraClaw itself is open-source and free to use. No platform fee or subscription. You only pay blockchain transaction fees. If you use an agent from the marketplace, there's a 2-5% fee split between the creator and protocol.

How do I update my agent to the latest version?

Run `hydraclaw upgrade` to auto-update CLI and all agents. You can also set auto_update = true in config for automatic updates. Major updates will require manual confirmation.

Is HydraClaw legal to use?

HydraClaw is a tool for automated trading, which is legal in most jurisdictions. However, usage responsibility lies with the user. Make sure to comply with local regulations regarding crypto trading and tax obligations.

What if my bot encounters an error?

HydraClaw has built-in error handling and automatic recovery. If a critical error occurs, the agent will pause trading and send a notification. You can check logs with `hydraclaw logs [agent-name]` for debugging.