Byreal Agent Skills

Note: This is the RealClaw internal branch (openclaw). Write commands emit unsigned transactions by default (back-compat with the pre-Privy CLI); add --execute to sign and broadcast on-chain via the Byreal Privy proxy. All write commands require --wallet-address <address> (no local keypair setup). Package name: @byreal-io/byreal-cli-realclaw.

Agent skills for Byreal — a concentrated liquidity (CLMM) DEX on Solana. Every command supports structured JSON output, and the built-in skill system lets AI agents discover and use all capabilities automatically.

AI Integration

Install as an Agent Skill so your LLM can discover all capabilities:

npx skills add https://github.com/byreal-git/byreal-agent-skills/tree/openclaw

Or install the CLI only:

# If @byreal-io/byreal-cli (main branch) is already installed, uninstall first
# to avoid bin name conflict (both packages use the `byreal-cli` binary name):
npm uninstall -g @byreal-io/byreal-cli

npm install -g @byreal-io/byreal-cli-realclaw

Features

• Pools — List, search, and inspect CLMM pools. View K-line charts, Est. APR (fee + reward incentive breakdown), TVL, volume, and run comprehensive pool analysis (risk, volatility, range recommendations).
• Tokens — List tokens, search by symbol/name, get real-time prices.
• Swap — Preview and execute token swaps with slippage control and price impact estimation.
• Positions — Open, close, and manage CLMM positions. Claim fees and rewards. Analyze position performance. Copy top farmers' positions with one command.
• Wallet — Query wallet balance.
• Jupiter — Swap tokens via Jupiter aggregator, get token prices.
• Kamino — Deposit and withdraw tokens on Kamino Lend for idle yield.
• Rent Reclaim — Close empty SPL token accounts to recover SOL rent.
• DFlow — Swap tokens via DFlow order-flow aggregator with MEV protection.
• Token Sweep — Consolidate dust tokens into USDC (or any target) via Jupiter swap + rent reclaim.
• Config — Configure RPC URL, slippage tolerance, priority fees.

Quick Start

# View top pools by APR
byreal-cli pools list --sort-field apr24h

# Analyze a pool
byreal-cli pools analyze <pool-address>

# Swap 0.1 SOL → USDC (preview)
byreal-cli swap execute \
  --wallet-address <your-wallet-address> \
  --input-mint So11111111111111111111111111111111111111112 \
  --output-mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --amount 0.1 --dry-run

# Same swap — emit unsigned base64 transaction for an external signer (default, back-compat)
byreal-cli swap execute \
  --wallet-address <your-wallet-address> \
  --input-mint So11111111111111111111111111111111111111112 \
  --output-mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --amount 0.1

# Same swap — sign + broadcast on-chain via Privy
byreal-cli swap execute \
  --wallet-address <your-wallet-address> \
  --input-mint So11111111111111111111111111111111111111112 \
  --output-mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  --amount 0.1 --execute

All commands support -o json for structured output.

Execution Modes (write commands)

Write commands (swap execute, positions open/close/..., plugin write commands) support three modes:

--dry-run and --execute are mutually exclusive.

Privy Setup (required for --execute)

The CLI signs transactions via the Byreal Privy proxy. Configure either:

Option A — multi-wallet config (~/.openclaw/realclaw-config.json):

{
  "baseUrl": "https://api2.byreal.io",
  "apiBasePath": "/byreal/api/privy-proxy/v1",
  "wallets": [
    { "address": "<your-solana-pubkey>", "token": "oc_at_...", "type": "solana" }
  ]
}

Option B — legacy single token:

echo "oc_at_..." > ~/.openclaw/agent_token
byreal-cli config set privy_proxy_url https://api2.byreal.io

Option C — environment variables (CI / debug):

export AGENT_TOKEN="oc_at_..."
export PRIVY_PROXY_URL="https://api2.byreal.io"

If Privy is not configured, --execute fails fast with PRIVY_NOT_CONFIGURED and actionable suggestions; the CLI never silently degrades. Drop --execute to keep the default unsigned-transaction output and sign with an external tool.

Commands

Update

byreal-cli update check
byreal-cli update install

License

MIT