什么是 ClawDex？

ClawDex 是一款专为 Solana 区块链上的程序化交易而设计的专业工具。作为 Openclaw Skills 生态系统的重要补充，它利用 Jupiter 聚合器确保用户获得代币兑换的最佳价格。它提供了一个开发者友好的界面，通过强制模拟和可配置的安全防护措施优先保障安全性，使其成为手动操作和自动化代理工作流的理想选择。

通过集成此技能，开发者可以使用标准化的 JSON 输出与 Solana 生态系统进行交互，从而实现无缝的数据解析和状态管理。无论您是构建交易机器人还是简单的钱包监控器，使用像 ClawDex 这样的 Openclaw Skills 都能确保您的链上交互安全、经过模拟且高效。

下载入口:https://github.com/openclaw/skills/tree/main/skills/davidpolotm/mi-trading

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

ClawDex 应用场景

• 基于实时市场数据或用户触发器实现代币自动兑换。
• 对 Solana 钱包余额和代币持有情况进行程序化监控。
• 针对任何 SPL 代币对进行价格发现和报价生成。
• 构建具备安全意识、需要预交易模拟和滑点保护的交易代理。

1. 初始化：该技能执行健康检查以验证 RPC 连接和钱包配置。
2. 资产发现：检索当前钱包余额，确保用户有足够的资金进行操作。
3. 报价生成：代理向 Jupiter 请求价格报价，以确定最佳交易路径和预期输出。
4. 模拟：在资金变动前进行链上预演模拟，以识别潜在故障或高价格冲击。
5. 执行：模拟成功后，将使用严格的安全标志执行兑换，以在 Solana 网络上完成交易。

ClawDex 配置指南

要在 Openclaw Skills 框架中使用此技能，请通过 npm 安装软件包：

npm install -g clawdex@latest

安装完成后，运行入驻命令并配置您的 RPC 和钱包详情：

clawdex onboarding --jupiter-api-key "YOUR_API_KEY" --rpc "https://api.mainnet-beta.solana.com" --wallet ~/.config/solana/id.json --json

ClawDex 数据架构与分类体系

ClawDex 为所有输出使用结构化的 JSON 架构，以确保与其他 Openclaw Skills 的兼容性。

name: clawdex
description: Trade tokens on Solana using the ClawDex CLI. Use when the user asks to swap tokens, check balances, get quotes, or manage a Solana trading wallet.
tools: Bash, Read
metadata:
  tags: solana, trading, defi, jupiter, swap, crypto

ClawDex — Solana DEX Trading Skill

Trade any Solana token through Jupiter aggregator with simulation, safety guardrails, and full JSON output.

Prerequisites

Before using this skill, ensure ClawDex is installed and configured:

which clawdex || npm install -g clawdex@latest

If not configured yet, run onboarding:

clawdex status --json

If status fails, set up with:

clawdex onboarding r
  --jupiter-api-key "$JUPITER_API_KEY" r
  --rpc "${SOLANA_RPC_URL:-https://api.mainnet-beta.solana.com}" r
  --wallet ~/.config/solana/id.json r
  --json

Commands

Check wallet balances

clawdex balances --json

Returns an array of { token, symbol, mint, balance, decimals } objects. Zero-balance accounts are included in JSON output.

Get a quote (no execution)

clawdex quote --in SOL --out USDC --amount 0.01 --json

Lightweight price check — no simulation, no wallet needed.

Simulate a swap (dry run)

clawdex swap --in SOL --out USDC --amount 0.01 --simulate-only --json

Runs full simulation on-chain without broadcasting. Does not require --yes. Use this to preview the output amount and route before committing.

Execute a swap

clawdex swap --in SOL --out USDC --amount 0.01 --yes --json

--yes is required for non-interactive execution. Without it, ClawDex exits with code 1.

Health check

clawdex status --json

Verify RPC connectivity, wallet validity, and config state.

Trading Workflow

Always follow this sequence:

1. Health check — clawdex status --json — abort if rpc.healthy is false
2. Check balances — clawdex balances --json — verify sufficient funds
3. Simulate — clawdex swap --simulate-only --json — preview the trade
4. Execute — clawdex swap --yes --json — only if simulation looks good
5. Verify — clawdex balances --json — confirm balances updated (may need 5s delay on public RPC)

Token Specification

Tokens can be passed by symbol or mint address:

• By symbol: SOL, USDC, USDT
• By mint: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Exit Codes

Safety

Set guardrails to prevent runaway trades:

clawdex safety set max_slippage_bps=300 max_trade_sol=1 max_price_impact_bps=100

When a guardrail triggers, the JSON response includes a violations array describing what failed.

Important Rules

• Always use --json for machine-parseable output
• Always use --yes for real swaps (not needed for --simulate-only)
• Never skip simulation unless you have a good reason — use --simulate-only first
• Parse balance as a string, not a number — it preserves full decimal precision
• Check exit codes — non-zero means the trade did not succeed
• Wait before verifying — RPC balance reads can lag a few seconds after a swap