clawdex

What This Skill Does

ClawDex is a comprehensive command-line interface and AI agent skill designed for seamless Solana decentralized exchange (DEX) trading. By integrating with the Jupiter aggregator, the skill enables users to swap tokens directly through their agent. It provides a robust architecture for checking balances, obtaining real-time price quotes, simulating trades to verify outcomes, and executing transactions securely. The skill is built with safety as a core priority, featuring configurable guardrails like max slippage, trade limits, and price impact thresholds, all while outputting structured JSON for easy machine parsing.

Installation

To integrate ClawDex into your agent environment, execute the following installation command:

clawhub install openclaw/skills/skills/joelccodes/clawdex-trading

After installation, verify your environment with clawdex status --json. If configuration is missing, use the onboarding command:

clawdex onboarding --jupiter-api-key "$JUPITER_API_KEY" --rpc "$SOLANA_RPC_URL" --wallet ~/.config/solana/id.json --json

Use Cases

• Portfolio Management: Regularly query token balances to track asset allocation across your Solana wallet.
• Automated Swapping: Perform token exchanges without manual DEX interaction, useful for rebalancing portfolios or entering new positions.
• Risk-Controlled Trading: Use the simulation tool to preview routes and impact before committing capital, ensuring trades align with predefined safety guardrails.
• Price Monitoring: Quickly fetch quotes for specific token pairs to monitor market volatility or identify arbitrage opportunities.

Example Prompts

1. "Check my current wallet balances and tell me if I have enough SOL to buy 50 USDC."
2. "Get a quote for swapping 1 SOL to JUP and simulate the trade to see the final output amount."
3. "Swap 0.5 SOL for USDT now, ensuring you stay within my safety settings for price impact and slippage."

Tips & Limitations

• Always Simulate: Never execute a swap without first running it with --simulate-only. This prevents unexpected errors, high slippage, or failed transactions on-chain.
• Guardrails: Utilize clawdex safety set to define your risk tolerance. Setting low slippage and price impact limits is the best defense against MEV bots and market volatility.
• RPC Stability: Ensure your Solana RPC URL is reliable, as public nodes may experience latency which can cause transaction timeouts.
• Delay: When confirming balances after a trade, allow for a 5-second buffer to ensure the Solana network has indexed the transaction state.