clawdex

What This Skill Does

ClawDex is a comprehensive Solana DEX trading agent designed for OpenClaw. It leverages the Jupiter aggregator to provide high-performance token swaps, real-time balance tracking, and deep market insights directly from your terminal. It is built for power users who demand transparency through full JSON outputs for every operation. Whether you are checking the current market price via quotes or executing complex trades, ClawDex integrates seamlessly into your agentic workflow. It prioritizes safety through mandatory simulations, which allow you to preview outcomes, routes, and price impacts before any real-world assets are committed to the blockchain.

Installation

To get started, ensure you have the ClawDex binary installed. You can install it globally via npm using npm install -g clawdex@latest. Once installed, initialize your environment by running clawdex onboarding. This will prompt you to input your Jupiter API key, your preferred Solana RPC URL, and the path to your wallet configuration file (typically located at ~/.config/solana/id.json). Once onboarded, run clawdex status --json to verify that your agent is connected to the network and your wallet is correctly loaded. If you ever need to update your configurations, the onboarding tool handles updates to your ~/.config/solana/id.json and RPC settings automatically.

Use Cases

ClawDex is ideal for:

1. Automated Trading: Integrating swap logic into your agent's daily routines.
2. Portfolio Management: Regularly auditing your token balances and monitoring asset distribution.
3. Market Analysis: Gathering lightweight, non-intrusive quotes across different token pairs to identify arbitrage or entry points.
4. Safety-First Execution: Implementing strict guardrails (slippage and maximum trade limits) to ensure automated trades stay within pre-defined financial boundaries.

Example Prompts

1. "Check my current wallet balances and tell me how much USDC I have versus SOL."
2. "Get me a quote for swapping 5 SOL to JUP and simulate the trade to show me the price impact."
3. "Execute a swap of 0.5 SOL for USDC with a slippage tolerance of 1%."

Tips & Limitations

Always follow the standard workflow: status check, balance verification, simulation, and finally, execution. The --yes flag is mandatory for execution to prevent accidental trades; the agent will exit with code 1 if this is omitted. Always review the violations array in the JSON response if a trade fails—it will provide specific details on why your trade was rejected based on your set safety guardrails. Keep in mind that public RPC nodes may have latency; if you perform a trade, wait a few seconds before re-checking your balance to ensure the transaction has finalized on-chain.